Funkcia %FIO_Create


Funkcia
Funkcia vytvorí/otvorí súbor pre zápis.
Deklarácia
INT %FIO_Create(
   TEXT in fileName
  [,BOOL in utf8 = @FALSE | ,TEXT in encoding = "@APP_DEFAULT@"]
 )

Parametre
fileName Meno súboru, ktorý bude vytvorený. Ak takýto súbor existuje, bude otvorený a obsah vymazaný.
utf8 Nepovinný parameter typu Boolean. Ak nie je zadaný, jeho náhradná hodnota je @FALSE.

Ak má parameter hodnotu @TRUE, je predpoklad, že súbor je textový a jeho obsah je kódovaný vo formáte UTF-8. Pri čítaní súboru kódovaného UTF-8 je prípadný BOM vynechaný (znaky 0xEF, 0xBB, 0xBF).

encoding Nepovinný parameter typu Text. Ak nie je zadaný, jeho náhradná hodnota je "@APP_DEFAULT@". Zoznam podporovaných kódovaní v ESL.

Návratová hodnota
0 - súbor sa nepodarilo vytvoriť/otvoriť, rôzna od 0 - súbor bol úspešne vytvorený/otvorený.

Návratová hodnota sa následne používa pri volaní ďalších %FIO_* funkcií, ktoré to vyžadujú. Hodnota parametra je platná len v rámci inštancie ESL skriptu, v ktorej bola funkcia volaná.
Poznámka
Po ukončení práce so súborom, je potrebné ho zatvoriť volaním funkcie %FIO_Close. Ak je vykonávanie ESL skriptu predčasne ukončené, proces D2000 EventHandler automaticky zatvorí všetky otvorené súbory.
Napíšte komentár