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.Get_from_LOF

Previous Top Next


MiniRobotLanguage (MRL)

 

TXT.gfl

TXT.Get_from_LOF

Restore the TXT.-internal Buffer from the File that was loaded with the LOF.-Command
that includes additional Informations, like the Filenname.

 

NTFS-Direct

 

Intention

 

This command is used to restore the Internal TXT-Buffer "as if the file would have been loaded" it takes the file and additional Informations from the LOF.-Command.

As the LOF-Command can hold up to 128 Textfiles "in Memory", you will need to specify the "Index number" which the LOF.-Command has assigned to that file at Loading-Time.

The Text-File and Data will be transfered into the TXT.-internal Buffer. The LOF.-Buffer will be cleared!

 

$$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.gfl|P1

TXT.Get_from_LOF|P1

 

 

Parameter Explanation

 

P1 - (Input) Variable with the LOF-INDEX-Number of the Textfile that shall be transfered.

 

 

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