FIO_OpenRead
Funkcia %FIO_OpenRead
Funkcia
Funkcia otvorí súbor na čítanie.
Deklarácia
INT %FIO_OpenRead(
TEXT in fileName
[,BOOL in utf8 = @FALSE | ,TEXT in encoding = "@APP_DEFAULT@"]
)Parametre
fileName | Meno súboru, ktorý bude otvorený. |
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 otvoriť, rôzna od 0 - súbor bol úspešne 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.
Súvisiace stránky: