File

File ( < cArquivo>, [ nWhere], [ lChangeCase] ) --> lRet

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

Esta função é utilizada para determinar se é encontrado algum arquivo que corresponde a um padrão de especificação de arquivo. Essa função procura no diretório especificado e em um path explicitamente especificado. Caso não seja especificado o path, a função pesquisa no diretório padrão corrente e depois no path AdvPL. Em nenhuma circunstância o path DOS é pesquisado. Além disso, a função não reconhece arquivos de sistemas ou escondidos em sua pesquisa.

//Exemplo 1
File ("C:\garbage\test.txt", 1 ,.T.) // Resultado: .T.
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
//Exemplo 2
//Nos exemplos abaixo, testamos a existência de um determinado arquivo na estação local e no diretório definido como RootPath do ambiente (Environment) no Servidor.
FILE("teste.dbf") // Verifica no diretório corrente do servidor se existe o arquivo teste.dbf
FILE("\SIGAADV\TESTE.dbf") // Verifica no diretório Sigaadv do servidor se existe o arquivo teste.dbf
FILE("C:\TEMP\TESTE.dbf") // Verifica no diretório Temp do cliente (Remote) se existe o arquivo teste.dbf
//Observação : Caso a função File() seja executada em Job (programa sem interface remota) , sendo passado um caminho absoluto de arquivo ( exemplo c:\teste.txt) , a função retornará .F. e FERROR() retornará -1 )