MiniRobotLanguage (MRL)
TXT.luf
TXT.Load_Unicode_File
Load a Unicode-Textfile into the internal Buffer and convert to ANSI for further Operations using other TXT.-Commands
Intention
This command is used to load a Unicode-Textfile - for example a ".msg"-file - into the internal Buffer of the TXT.-Commands.
It will also convert the file to ANSI-Characterset, so it can be used like a normal ANSI-File.
From there you can do all sorts of operations on the file.
You can later use the "TXT.sau" Command to save it as Unicode back to the original Filename
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
' $$RES is 0 in case of error
' returns number of loaded lines in case of success
TXT.Load_Unicode_File|$$FIL|$$RES
MBX.Operation was succesfull, Lines loaded: $$RES
Syntax
TXT.luf|P1[|P2]
TXT.Load_Unicode_File|P1[|P2]
Parameter Explanation
P1 - Filename and Path of the Textfile to load.
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.
Example
'*****************************************************
' EXAMPLE 1: TXT.ltf and TXT.gpt and TXT.gtl
'*****************************************************
VAR.$$LAA=?path\..\Pics\Outlook.msg
TXT.luf|$$LAA|$$RES
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:
• Pop_Keep