Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Bloco de código
collapsefalse
ExistDir( < cPath >, [ uParam1uParam2 ], [ lChangeCase ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cPath

caractere

Indica o nome do diretório que será verificado.

X

 

uParam1uParam2

numérico

Parâmetro de compatibilidade. Passar Nil.

 

 

lChangeCase

lógicoIndica

se colocará o nome do diretório em letra minúsculaSe .T., nome de arquivos e pastas serão convertidos para letras minúsculas, e se for .F. não altera o nome informado. Caso não especificado, o valor padrão é .T., exceto se houver a configuração das chaves de ini CASESENSITIVE ou SERVERTYPE.

 

 

Retorno

Nome

Tipo

Descrição

lRet

lógico

Retorna verdadeiro (.T.), se o diretório existir; caso contrário, falso (.F.).

...

  • Caso seja especificado um path sem a unidade de disco, o mesmo será considerado no ambiente do servidor, a partir do RootPath do ambiente (caso o path comece com \ ou /), ou a partir do StartPath do ambiente (caso o path não seja iniciado com \ ou /).
  • Quando um path absoluto é especificado (com unidade de disco preenchida), a função será executada na estação em que o SmartClient está em execução.
  • O valor retornado pela função serve apenas para indicar falha na operação, mas não têm relação com a causa da falha. Para identificar o motivo do erro, devemos chamar a função FError.
  • Ao executar essa função em JOB (processo isolado do servidor, sem interface), não é possível especificar um Path absoluto de disco. Caso isso seja realizado, o retorno da função será .F. e a função FError retornará -1 (Syntax Error).
  • O caminho de cPath será convertido para letra minúscula. A partir da parâmetro opcional lChangeCase foi introduzido a partir do build 7.00.121227A, o caminho não será convertido para letra minúscula para Logix.
  • A partir da build 7.00.131227A foi criado o parâmetro lChangeCase, que se for definido com o valor .T., altera o nome dos arquivos e pastas para letra minúscula, e se for .F. não altera o nome informado. O valor padrão do parâmetro é .T..
  • Em ambiente Windows, os nomes de arquivos e pastas não possuem diferenciação entre maiúsculo e minúsculo, logo, a função conseguirá tratar a pasta apontada por cPath independente do valor definido no parâmetro lChangeCase. Em ambiente Linux ou Mac, os nomes dos arquivos e pastas respeitam a diferenciação131227A pois em sistemas LINUX/UNIX, existe a diferenciação entre maiúsculo e minúsculo em nomes de arquivos ou pastas. Quando este parâmetro for informado, terá prioridade sobre o comportamento de CASE SENSITIVE definido pelas chaves de ini CASESENSITIVE ou SERVERTYPE.

Exemplos

Bloco de código
languagecpp
themeEclipsetitleExemplo 1
linenumberstrue
collapsefalse
user function teste()
  // 1º Exemplo:
  // No Application Server a partir do rootpath
  conout( ExistDir( "\apo" ) ) // Resultado: .T.
  
  // 2º Exemplo
  // No SmartClient, passando o FullPath
  conout( ExistDir( "c:\apo" ) ) // Resultado: .F.
return

...

Veja também