FileCopy

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.
Posted in Dev, PowerBuilder and tagged , , , .

One Comment

  1. Pingback: FileMove – Raccoon Ninja

Comments are closed.