| sFile | (String) Název souboru s cestou.
Pokud soubor neexistuje, pak bude vytvořen. Pokud není zadána celá cesta, pak se doplní relativně k složce aplikace. Je doporučeno použít cestu v syntaxi PROMOTIC - viz PROMOTIC cesta k souborům nebo složkám. |
|---|---|
| vValue | (Variant) Zapisovaná proměnná.
Může být jednoduchého typu převoditelného do hodnoty typu String nebo 1-rozměrné pole (Array) těchto proměnných. Pro typ String se obsah textu zapíše a za něj se přidá znak 'nový řádek' (viz konstanta vbCrLf).
Pro typ Array (pole) se každá položka pole zapíše na nový řádek ale za poslední položku není přidán znak 'nový řádek'. |
| sOptions | [nepovinné] (String) Určuje jak uložit. Například "mode:add;charset:utf-8;sep:no;".
mode:sss; (nepovinné) - Volba určuje chování při zápisu do existujícího souboru.
mode:new; (přednastaveno) -
Pokud soubor neexistuje, pak se vytvoří nový soubor.
Pokud soubor existuje, pak jeho stávající obsah je smazán a přepsán novým. mode:add; -
Pokud soubor neexistuje, pak se vytvoří nový soubor.
Pokud soubor existuje, pak obsah zapisované proměnné je přidán na jeho konec. sep:sss; (nepovinné) - Volba určuje, zda jednotlivé položky pole a následující zápisy budou odděleny.
sep:newline; (přednastaveno) - Oddělovačem položek pole a jednotlivých následných zápisů je nový řádek.
sep:no; - Položky pole a jednotlivé následné zápisy nejsou ničím odděleny. Zapisuje se pouze obsah textů, žádné znaky navíc nejsou přidány. Znaky nového řádku musí být obsaženy již v zapisovaných textech. charset:sss; (nepovinné) - Volba určuje znakovou sadu. Viz: Popis Unicode kódování znaků.
charset:ansi; (přednastaveno) - Textový obsah bude uložen v ANSI kódové stránce, která je právě aktivní v OS Windows (např. windows-1250).
charset:utf-8; - Textový obsah bude uložen v Unicode UTF-8 kódování (nezávislý na aktivní kódové stránce v OS Windows).
charset:utf-16; - Textový obsah bude uložen v Unicode UTF-16 kódování (nezávislý na aktivní kódové stránce v OS Windows). bom:nnn; (nepovinné) - Volba určuje, zda na začátek nového textového souboru umístit BOM značku (3 bajty) pro identifikaci Unicode znakové sady.
bom:1; (přednastaveno) - Na začátek nového souboru bude umístěna BOM značka pro identifikaci Unicode znakové sady.
bom:0; - Na začátek nového souboru se žádná BOM značka pro identifikaci Unicode znakové sady neumísťuje. Tato volba je vhodná pro HTML nebo XML soubory, kde se BOM nemá dávat. |
var arr = Pm.Array1("Hallo", 1.23, "bye-bye");
Pm.FileTextWrite("#app:File.txt", arr);
var aData, sRow;
// Vytvoří soubor s 1 řádkem:
aData = Pm.Array1(12.2, 14, "row1", 1, 0);
sRow = Pm.StringFormat("%3.2f;%d;%s;%d;%d;", aData);
Pm.FileTextWrite("#app:File.txt", sRow);
// Přidá 2. řádek:
aData = Pm.Array1(12.2, 14, "row2", 1, 0);
sRow = Pm.StringFormat("%3.2f;%d;%s;%d;%d;", aData);
Pm.FileTextWrite("#app:File.txt", sRow, "mode:add;");
Pm.FileTextWrite("lpt1:", "Text row1 \n Text row2", "mode:add;");