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

Napíšte komentár