String-Commands * TXT-Command

<< Click to Display Table of Contents >>

Navigation:  3. Script Language > TXT. Text-File Engine > Load / Save Commands >

String-Commands * TXT-Command

TXT.Save_as_Unicode

Previous Top Next


MiniRobotLanguage (MRL)

 

TXT.sau

TXT.Save_as_Unicode

Load a Unicode-Textfile into the internal Buffer and convert to ANSI for further Operations using other TXT.-Commands

 

NTFS-Direct

 

Intention

 

This command is used to save the TXT%.-internal Buffer as a Unicode-Textfile - for example a ".msg"-file.

It will not do any changes to the internal FIle, just save it as Unicode.

If you convert files from Unicode to ANSI and back, please note that due the nature of this process, some international characters may get lost.

 

' Load Unicode-Textfile into internal Buffer for further TXT.-Command Operations

TXT.Save_as_Unicode|$$FIL

MBX.Operation was succesfull, Result: $tos$

 

 

 

Syntax

 

 

TXT.sau|P1[|P2]

TXT.Save_as_Unicode|P1[|P2]

 

 

Parameter Explanation

 

P1 - (Input, optional) Filename and Path of the Textfile to Save it to. If omitted the original filename where it was loaded is been used.        

   

  P2 - (Output) Variable with the result of the operation. On error a "0" is returned also the Timeout-Flag is set.
 On succes, the number of loaded lines is returned. If omitted the result is placed on TOS.

 

TOS: Calling TXT.SAV will leave a 0 or a 1 on the TOS that will show if the Operation was successful (1) or failure (0).

 

 

Example

 

'*****************************************************

' EXAMPLE 1: TXT.luf  and TXT.sau

'*****************************************************

VAR.$$LAA=?path\..\Pics\Outlook.msg

TXT.sau|$$LAA

TXT.gpt|$$TXT

PRT.$$TXT

MBX.Ready

ENR.

 

 

Remarks

 

Can acess very large pathes up to 32767 characters due to the use of NTFS-direct.

 

Limitations:

 

-

 

 

See also:

 

 

!TXT. - Text File Engine

TXT.Load Textfile

TXT.Clear

TXT.From_Var

OPT. - Optional Settings

TXT.Save_as_Unicode

  Push_Intern

  Pop_Intern  

  Push_Keep

  Pop_Keep

  Clear_Intern

  TXT.Load Textfile

  TXT.Clear  

  TXT.To_Var

  TXT.From_Var

  TXT.To_Var_and_Clear

  TXT.Get_Filename

  TXT.Get_Lenght