Akcia generuje súbor formátu
.CSV. Meno súboru je dané hodnotou parametra
fName. Oddeľovač položiek v CSV súbore
je daný parametrom
delimiter.
Úspešnosť operácie je indikovaná výstupným parametrom
retCodeIdent_Int. Hodnota 0
znamená úspešný export, hodnota rôzna od 0 chybu.
V závislosti od parametra
toExportStruct akcia exportuje:
- celú lokálnu premennú
- riadok lokálnej premennej
- stĺpec lokálnej premennej
Formát CSV súboru
Lokálna premenná sa do CSV súboru zapisuje po riadkoch (riadok premennej predstavuje riadok v CSV súbore).
Vzhľadom na to, že formát CSV súboru nie je jednoznačne definovaný, akcia ako druhý parameter očakáva oddeľovač (
delimiter).
Je to 1-znakový reťazec (1 znak) ktorý bude použitý pri oddeľovaní položiek v CSV súbore.
Reálne čísla používajú ako oddeľovač desatinných miest desatinnú bodku '
.'.
Ak je použité kľúčové slovo
TIME, do CSV súboru bude zapisovaný aj čas vzniku hodnoty pre každú položku lokálnej premennej.
Čas je vždy uvedený pred vlastnou hodnotou položky. CSV súbor má preto dvojnásobný počet stĺpcov.
Ak je použité kľúčové slovo
UTF8, akcia generuje textový súbor
kódovaný vo formáte
UTF-8.
Pri použití kľúčového slova
APPEND, akcia doplní dáta do existujúceho CSV súboru. Ak zadaný súbor nenájde, tak ho vytvorí.
Čas je formátovaný maskou definovanou v
transformačnej palete pod indexom daným hodnotou parametra
transPalIdx_Int.
Ak tento parameter nie je uvedený, alebo jeho hodnota je 0, použije sa maska
dd.mm.rrrr hh:mi:ss. Ak je jeho hodnota -1,
potom konverzia hodnôt typu
Absolútny čas a
Real prebieha podľa nastavenia v
Regional and Language Options aktuálneho
užívateľa na systémoch Windows. Pre iné systémy je hodnota -1 automaticky nahradená hodnotou 0.
Parameter
bMonoTimes upravuje prácu s časom vzhľadom na posun letný/zimný čas. Ak je jeho hodnota @TRUE, všetky časové hodnoty
budú na výstupe prepočítané na normálny monotónny (zimný) čas.
Oddeľovač v CSV súbore (parameter
delimiter) je možné získať volaním funkcie
%GetCSVDelimiter.