Copia o arquivo para o local especificado.
Sintaxe:
FileCopy ( sourcefile, targetfile {, replace })
Retorno:
- 1 – Sucesso;
- -1 – Erro ao abrir o arquivo (sourcefile);
- -2 Erro ao escrever o arquivo no destino (targetfile);
Destalhes sobre a função!
Appeon: Função suportada. No PowerBuilder, o caminho relativo aponta para o diretório da aplicação, mas no Appeon o caminho relativo aponta para o diretório do Desktop do Usuário.
- Se for informado apenas o nome do arquivo, a função assumirá o caminho relativo;
- Se o argumento replace não for especificado, a função não irá substituir o arquivo;
Como utilizar:
Exemplo 01: Copiando o arquivo sem sobrescrever, caso já exista uma versão dele no destino.
string ls_arquivo, ls_destino long ll_resultado ls_arquivo = "c:\temp\log.txt" ls_destino = "p:\backup\log.txt" ll_resultado = FileCopy(ls_arquivo, ls_destino) choose case ll_resultado case 1 //Sucesso case -1 //Não foi possível abrir o arquivo case -2 //Não foi possível escrever o arquivo end choose
Exemplo 02: Copiando o arquivo sem sobrescrever, caso já exista uma versão dele no destino. (Definindo explicitamente na chamada da função)
string ls_arquivo, ls_destino long ll_resultado ls_arquivo = "c:\temp\log.txt" ls_destino = "p:\backup\log.txt" ll_resultado = FileCopy(ls_arquivo, ls_destino, false) choose case ll_resultado case 1 //Sucesso case -1 //Não foi possível abrir o arquivo case -2 //Não foi possível escrever o arquivo end choose
Exemplo 03: Copiando um arquivo sobrescrevendo, caso já exista uma copia no destino.
string ls_arquivo, ls_destino long ll_resultado ls_arquivo = "c:\temp\log.txt" ls_destino = "p:\backup\log.txt" ll_resultado = FileCopy(ls_arquivo, ls_destino, true) choose case ll_resultado case 1 //Sucesso case -1 //Não foi possível abrir o arquivo case -2 //Não foi possível escrever o arquivo end choose
Argumentos:
Argumento | Obrigatório | Descrição |
---|---|---|
sourcefile | Sim | String com o arquivo que será copiado. |
targetfile | Sim | Caminho completo para onde o arquivo será copiado. Deve contar o nome do novo arquivo. |
replace | Não | Booleano que indica se o arquivo deve ou não ser sobrescrito. Padrão: false |
Referência:
Dúvidas sobre o artigo? Sugestões? Precisa de ajuda com outra funcionalidade do PowerBuilder? Deixe um comentário.
The following two tabs change content below.
Arquiteto de Software e Desenvolvedor Backend (quase Fullstack), geralmente trabalho com C#, PowerShell, Python, Golang, bash e Unity (esse é mais por hobby). Estou sempre buscando algo novo para aprender, adicionando novas ferramentas ao meu cinto de utilidades.
Latest posts by Breno RdV (see all)
- O que é Metaclass e como ela funciona. (#python #dev #metaclass) - janeiro 11, 2023
- Entenda a mágica dos Generators. (#python, #dev, #generator, #iterator) - dezembro 28, 2022
- Ordenando um DataFrame por múltiplas colunas. (#python #pandas #jupyter #dev #data) - agosto 3, 2022
Pingback: FileMove – Raccoon Ninja