Test path name
Test path name ( nomeRota ) : Integer
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| nomeRota | Text | → | Rota ao diretório, pasta ou documento |
| resultado | Integer | ← | 1 - rota de acesso do documento existente, 0 - rota do diretório ou pasta existente, <0 - rota inválida, código de erro do gestor de arquivo OS |
Descrição
A função Test path name verifica se um documento ou pasta cujo nome ou via de acesso se passa em viaAcesso está presente no disco. Pode passar uma via de acesso relativa ou absoluta, expressada na sintaxes do sistema atual.
Se encontrado um documento, Test path name devolve 1. Se encontrada uma pasta, Test path name devolve 0.
4D oferece as seguintes constantes predefinidas:
| Constante | Tipo | Valor |
|---|---|---|
| Is a document | Inteiro longo | 1 |
| Is a folder | Inteiro longo | 0 |
Se não se encontra nenhum documento ou pasta, Test path name devolve um valor negativo (por exemplo -43 para "Arquivo não encontrado").
Exemplo
O seguinte exemplo prova a presença do documento “Diário” na pasta da base, e o cria se não for encontrado:
If(Test path name("Diario")&NBSP;#&NBSP;Is a document)
$vhDocRef:=Create document("Diario")
If(OK=1)
CLOSE DOCUMENT($vhDocRef)
End if
End if
Ver também
Convert path system to POSIX
Create document
CREATE FOLDER
Object to path
Path to object
Propriedades
| Número do comando | 476 |
| Thread-seguro | ✓ |