<< Click to Display Table of Contents >> Navigation: 3. Script Language > TXT. Text-File Engine > To LOF / To Var > String-Commands * TXT-Command |
MiniRobotLanguage (MRL)
TXT.tol
TXT.To_LOF
Move the TXT.-internal Buffer to the Buffer of the LOF.-Command
that includes additional Informations, like the Filenname. Clear TXT.-Buffer.
Intention
This command is used to transfer (move) the TXT-Buffer "as if the file would have been loaded" into the specified Buffer of the LOF.-Command.
As the LOF-Command can hold up to 128 Textfiles "in Memory", you will need to specify the "Index number" which shall be used.
The Text-File and Data will be transfered into the LOF-Buffer. The TXT.-internal -Buffer will be cleared!
If you use a LOF.-Buffer-Inde4x that is already "in use", the file that was loaded with LOF. will be lost and replaced with the File that is transfered from the TXT.-Buffer.
The Index-Numbers for the LOF.-internal FIle-Cache are in the range from 1 to 128, so i recommend that you just pick a free number out of these if you need to use a new Index--Number.
Possibly in many cases you may just use the same number that was used to transfer the file from LOF. into the TXT.-Buffer.
$$MSG=Teste "to_lof"
' Clear LOF:-Buffer
LOF.!$$IND
LFT.$$IND|-1|$$LAB
JNZ.$$LAB|Lab_failed
' Transfer Text to LOF.-Buffer, clear TXT.-Buffer
TXT.tol|$$IND
LFT.$$IND|-1|$$RES
JIV.$$RES!20|Lab_failed
' Restore TXT.-Buffer from LOF.-Buffer, clear LOF.-Buffer
TXT.gfl|$$IND
TXT.gtl|$$LAB
JIV.$$LAB!1040|Lab_failed
Syntax
TXT.tol|P1
TXT.To_LOF|P1
Parameter Explanation
P1 - (Input) Variable with the LOF-INDEX-Number where the Textfile that shall be transfered to.
Example
'*****************************************************
' EXAMPLE 1: TXT.tol and TXT.gfl etc.
'*****************************************************
$$MSG=Teste "to_lof"
' Clear LOF:-Buffer
LOF.!$$IND
LFT.$$IND|-1|$$LAB
' Transfer Text to LOF.-Buffer, clear TXT.-Buffer
TXT.tol|$$IND
LFT.$$IND|-1|$$RES
' Restore TXT.-Buffer from LOF.-Buffer, clear LOF.-Buffer
TXT.gfl|$$IND
TXT.gtl|$$LAB
ENR.
Remarks
Can acess very large pathes up to 32767 characters due to the use of NTFS-direct.
The way the lines are delimited should be $crlf$, in some cases the loader will convert $cr or $lf-files to $crlf$ files.
To properly work with these commands, make sure that you work with this type of files that are $crlf$ delimited.
Limitations:
-
See also:
• IEF. / NEF. - If - exist - File