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.

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:

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.