Akcia FIND_FILES

Funkcia

Akcia vyhľadá súbor alebo adresár v danom adresári.

Deklarácia

FIND_FILES directory, mask, bRecursive, filesDesc, retCode

Parametre

directory

in

Parameter typu TEXT - existujúci adresár, v ktorom sa bude hľadať.

mask

in

Parameter typu Text - meno hľadaného súboru alebo adresára. Môže obsahovať znaky * a ?.

bRecursive

in

Parameter typu BOOLEAN. Možné hodnoty:

@TRUE - hľadať rekurzívne v podadresároch
@FALSE - hľadať len v zadanom adresári

filesDesc

in

Lokálna štruktúra typu SD._System_FileInfo alebo inej definície štruktúry s rovnakým počtom a typmi stĺpcov.

Meno	Typ	Popis
IsFile	Boolean	@TRUE, ak ide o súbor (ináč adresár).
CreateTime	Abs. čas	Čas, kedy bol súbor alebo adresár vytvorený.
AccessTime	Abs. čas	Čas, kedy bolo k súboru naposledy pristupované (čítanie alebo zápis). Pre adresár čas vytvorenia.
ModifyTime	Abs. čas	Čas, kedy bolo do súboru naposledy zapisované. Pre adresár čas vytvorenia.
Size	Reálny	Veľkosť súboru v bajtoch.
Name	Text	Meno súboru.
Attribs	Integer	Atribúty súboru (adresára).

retCode

out

Návratový kód.

Návratový kód

Hodnota parametra retCodeIdent_Int - pozri tabuľku chybových stavov.

Popis

Akcia umožňuje vyhľadanie daného súboru (adresára) v špecifikovanom adresári. Akcie prehľadá a výsledkom naplní štruktúru filesDes. Štrukrúra filesDesc obsahuje zoznam súborov aj adresárov vyhovujúcich podmienke hľadania. V prípade potreby ju redimenzuje.
Ak žiadny súbor nevyhovuje podmienke (maske), výsledná štruktúra bude mať 0 riadkov.
Štruktúra filesDesc sa aktualizuje len vtedy, ak retCode nadobudne hodnotu "0" (ERR_NO_ERROR).

Príklad

 RECORD (SD.ESL_FIND_FILES) _dir
 INT _retCode
 
 BEGIN
 FIND_FILES "c:\adresar", "*", @TRUE, _dir, _retCode
 END

Súvisiace stránky:

Akcie v skriptoch