NUMBER %OPENDIR%
Scopo: cerca all'interno di un
direttorio i file e i direttori che soddisfano il percorso specificato.
Sintassi: | |||
%NUMBER% | OPENDIR | (%STRING% | percorso, |
%STRING%* | nomefile[, | ||
%NUMBER% | attributi]) |
Descrizione: Utilizzata per leggere il
direttorio indicato con percorso, che assume il
valore del nome (di file o direttorio) che si intende ritrovare completo di
path DOS (es. c:\winnt\system32\).
E' consentito l'uso di caratteri jolly ('*' o '?') con le stesse
valenze dell'ambiente DOS.
Se il valore in percorso, oppure se la
valorizzazione della variabile stessa, avviene in chiaro, le barre
separatrici ('\') devono essere convertite in caratteri di
escape ('\\').
nomefile viene valorizzato con il nome del
primo file/direttorio, se presente, che soddisfa i criteri impostati.
Il ritorno in nomefile rappresenta un percorso
relativo a quanto indicato in percorso.
attributi non è attualmente implementato su
tutte le piattaforme, e quindi se ne rimanda l'utilizzo ad una futura release.
Il presente comando non funziona su Sistema Operativo UNIX.
Valore restituito: valore numerico
Torna un identificativo da usarsi nelle successive richieste con
%READDIR%() e infine con %CLOSEDIR%().
Torna 0 se non è stato trovato nessun file o direttorio idoneo.
Vedere anche: %READDIR%, %CLOSEDIR%, Accesso ai file
Esempio:
<!-- loop che legge i file presenti nel direttorio c:\temp -->
%STRING%(path, "c:\\temp\\*")
%STRING%(file, "")
%NUMBER%(ret, 0)
%NUMBER%(rett, 0)
%NUMCPY%(ret, %OPENDIR%(path, file))
%IF%(ret == 0)
<!-- direttorio/file non individuato -->
%ELSE%
%LOOP%
%STRCPY%(file, "")
%NUMCPY%(rett, %READDIR%(ret, file))
%IF%(rett)
<!-- elaborazione -->
%ELSE%
%BREAK%
%ENDIF%
%ENDLOOP%
%ENDIF%
Program output:
.
..
highway.log
d6h3a.temp
d6h4f.temp
d6h61.temp
d6h6a.temp
...