FileCopy

Bem-vindo ao mundo do PowerBuilder, onde a simplicidade encontra a funcionalidade! Hoje, vamos mergulhar na utilidade e nos detalhes da função FileCopy, uma ferramenta essencial para quem precisa copiar arquivos de forma eficiente. Acompanhe exemplos práticos, saiba como tratar possíveis erros e tire o máximo proveito desta funcionalidade, seja em ambientes Appeon ou PowerBuilder tradicional. Preparado para facilitar seu trabalho com arquivos? Vamos lá!

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.

 1string ls_arquivo, ls_destino
 2long ll_resultado
 3
 4ls_arquivo = "c:\temp\log.txt"
 5ls_destino = "p:\backup\log.txt"
 6
 7ll_resultado = FileCopy(ls_arquivo, ls_destino)
 8
 9choose case ll_resultado
10    case 1
11        //Sucesso
12    case -1
13        //Não foi possível abrir o arquivo
14    case -2
15        //Não foi possível escrever o arquivo
16end choose

Exemplo 02: Copiando o arquivo sem sobrescrever, caso já exista uma versão dele no destino. (Definindo explicitamente na chamada da função)

 1string ls_arquivo, ls_destino
 2long ll_resultado
 3
 4ls_arquivo = "c:\temp\log.txt"
 5ls_destino = "p:\backup\log.txt"
 6
 7ll_resultado = FileCopy(ls_arquivo, ls_destino, false)
 8
 9choose case ll_resultado
10    case 1
11        //Sucesso
12    case -1
13        //Não foi possível abrir o arquivo
14    case -2
15        //Não foi possível escrever o arquivo
16end choose

Exemplo 03: Copiando um arquivo sobrescrevendo, caso já exista uma copia no destino.

 1string ls_arquivo, ls_destino
 2long ll_resultado
 3
 4ls_arquivo = "c:\temp\log.txt"
 5ls_destino = "p:\backup\log.txt"
 6
 7ll_resultado = FileCopy(ls_arquivo, ls_destino, true)
 8
 9choose case ll_resultado
10    case 1
11        //Sucesso
12    case -1
13        //Não foi possível abrir o arquivo
14    case -2
15        //Não foi possível escrever o arquivo
16end choose

Argumentos:

Referência:

• http://infocenter-archive.sybase.com/help/topic/com.sybase.dc00132_0250/html/pkpsref/BCGDDHFF.htm

Dúvidas sobre o artigo? Sugestões? Precisa de ajuda com outra funcionalidade do PowerBuilder? Deixe um comentário.