String-Commands * TXT-Command

<< Click to Display Table of Contents >>

Navigation:  3. Script Language > TXT. Text-File Engine > To LOF / To Var >

String-Commands * TXT-Command

TXT.To_LOF

Previous Top Next


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.

 

NTFS-Direct

 

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:

 

  LOF-Load Textfile

  LFT-Line from Text

  TXT.Load Textfile

  TXT.Clear

  TXT.From_Var

  OPT. - Optional Settings

  FIL.Generate numbered Name

  FIL.Move numbered File

  ATF - Append-to-File

  CFF. - Copy-From-File

  CTF - Copy-To-File

  COP. - Copy File

  TXT.Get_Filename

  TXT.Get_Lenght

  TXT.To_Var_and_Clear

    GLC. - Get-Line-Count

    IEF. / NEF. - If - exist - File

    LFF - Line-From-File

    WFF. - Wait-For-File

    REN. - Rename File/Dir