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