| sFile | (String) Nazwa pliku ze ścieżką.
Jeżeli plik nie istnieje, wtedy zostanie wytworzony. Jeżeli nie jest wprowadzona pełna ścieżka, wtedy zostanie uzupełniona względem do foldera aplikacji. Jest zalecane stosowanie ścieżki w składni PROMOTIC - patrz PROMOTIC ścieżka do plików lub folderów. |
|---|---|
| vValue | (Variant) Zapisywana zmienna.
Może być prostego typu możliwego do skonwertowania do wartości typu String lub 1-wymiarową tablicą (Array) takich zmiennych. Dla typu String zawartość tekstu zostanie zapisana i za niego zostanie dodany znak 'nowy wiersz' (patrz stała vbCrLf).
Dla typu Array (tablica) każda pozycja tablicy zostanie zapisany na nowy wiersz lecz za ostatnią pozycją nie jest dodany znak 'nowy wiersz'. |
| sOptions | [opcjonalne] (String) Określa jak zapisać. Na przykład "mode:add;charset:utf-8;sep:no;".
mode:sss; (opcjonalne) - Opcja określa zachowanie w przypadku zapisu do istniejącego pliku.
mode:new; (domyślnie) -
Jeżeli plik nie istnieje, wtedy jest wytworzony nowy plik.
Jeżeli plik istnieje, wtedy jego dotychczasowa zawartość jest skasowana i zastąpiona nową. mode:add; -
Jeżeli plik nie istnieje, wtedy jest wytworzony nowy plik.
Jeżeli plik istnieje, wtedy zawartość zmiennej jest dodana na koniec pliku. sep:sss; (opcjonalne) - Opcja określa, czy pojedyńcze pozycje tablicy oraz następne wpisy zostaną oddzielone.
sep:newline; (domyślnie) - Separatorem pozycji tablicy oraz pojedyńczych następnych wpisów jest nowy wiersz.
sep:no; - Pozycje tablicy oraz pojedyńcze wpisy nie są niczym oddzielone. Zapisywana jest tylko zawartość tekstów, nie dodawano żadnych dodatkowych znaków. Znaki nowego wiersza muszą być zawarte już w zapisywanych tekstach. charset:sss; (opcjonalne) - Opcja określa system kodowania znaków. Patrz: Opis kodowania znaków Unicode.
charset:ansi; (domyślnie) - Zawartość pliku zostanie zapisana w ANSI zestawie znaków, który jest na bieżąco aktywny w SO Windows (np. windows-1250).
charset:utf-8; - Zawartość pliku zostanie zapisana w zestawie znaków Unicode UTF-8 (niezależne od bieżącego zestawu znaków w SO Windows).
charset:utf-16; - Zawartość pliku zostanie zapisana w zestawie znakąw Unicode UTF-16 (niezależne od bieżącego zestawu znaków w SO Windows). bom:nnn; (opcjonalne) - Opcja określa, czy na początek nowego pliku tekstowego należy zamiecić znak BOM (3 bajty) w celu identyfikacji zestawu znaków Unicode.
bom:1; (domyślnie) - Na początek nowego pliku zostanie zamieszczony znak BOM w celu identyfikacji zestawu znaków Unicode.
bom:0; - Na początek nowego pliku nie zostanie zamieszczony żadny znak BOM w celu identyfikacji zestawu znaków Unicode. Ta opcja jest odpowiednia dla plików HTML lub XML, do których BOM nie należy wstawiać. |
var arr = Pm.Array1("Hallo", 1.23, "bye-bye");
Pm.FileTextWrite("#app:File.txt", arr);
var aData, sRow;
// Wytworzy plik o jednym wierszu:
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);
// Doda 2. wiersz:
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;");