TOTVSTEC

Árvore de páginas

Descompacta um arquivo no formato Zip.

Sintaxe

FUnZip( < cZipFile >, < cFolder >, [ cPassword ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cZipFile

character

Indica o nome do arquivo que será descompactado.

X


cFolder

character

Pasta onde o arquivo será descompactado.

X


cPassword

character

Se o arquivo foi compactado com senha, informar essa senha



Retorno

Nome

Tipo

Descrição

nRet

numeric

Retorna 0 zero se consegui descompactar ou diferente de 0 zero em caso de erro.

Observações

  • O arquivo de origem e a pasta destino precisam sempre estar no mesmo lugar: Servidor (relativo ao RootPath), ou Cliente (caminho completo).
  • Caso haja diferença de lugar entre o arquivo de origem e a pasta de destino, será apresentada no console do Application Server a mensagem "tFunzip: Error, both paths must be on the same side (server/client)" e o retorno da função será -1.
  • Caso o arquivo apontado em cZipFile esteja no Cliente e o programa seja executado via Job, o programa será encerrado com a ocorrência de erro fatal "Function FUnZip() cannot access client directory/file in Job.".
  • Os caminhos apontados em cZipFile e cFolder não são convertidos para minúsculo, sendo tratados da forma como são escritos. Dessa forma, em Windows não existe impacto no acesso aos arquivos e pastas, mas em Linux, devido ao sistema operacional diferenciar caminhos em maiúsculo e minúsculo, pode não conseguir acessar o caminho, devendo ser escrito com o Case Sensitive correto.
  • Função disponível apenas para versões iguais ou superiores a 13.2.3.17.

Exemplos

user function exemplo()
  nret := FUnZip( "\imagens.zip", "\", )
  
  if nret != 0
    conout( "Não foi possível descompactar" )
  else
    conout( "Arquivo descompactado com sucesso" )
  endif
return

Veja também

  • Sem rótulos