MiniRobotLanguage (MRL)
TXT.gfn
TXT.Get_Filename
Return Path and Filename of the currently loaded File inside the TXT.-internal Buffer
Intention
This command is used to return Path and Filename of the Textfile, that was loaded into the internal Buffer of the TXT.-Commands.
' Load Textfile into intrnal Buffer for further TXT.-Command Operations
' ($$RES is 0/1 success)
TXT.Load_Textfile|$$FIL|$$RES
TXT.gfn|$$RES
MBX.File loaded:$crlf$ $$RES
Syntax
TXT.gfn|P1
TXT.Get_Filename|P1
Parameter Explanation
P1 - (Output) Variable with the result of the operation.
On error a "" is returned also the Timeout-Flag is set.
On success, the Filename (incl. Path) of the currently loaded file is been returned.
If omitted the result is placed on TOS.
Example
'*****************************************************
' EXAMPLE 1: TXT.ltf and TXT.gfn etc.
'*****************************************************
VAR.$$LAA=?path\..\Pics\Test.txt
TXT.ltf|$$LAA|$$RES
TXT.gtl|$$LAB
JIV.$$LAB!0|Lab_failed
TXT.gfl|$$IND
TXT.gtl|$$LAB
JIV.$$LAB!1040|Lab_failed
TXT.gfn|$$LAB
NVC.$$LAB=Test.txt
GTO.Lab_failed
EIF.
ENR.
Remarks
Can acess very large pathes up to 32767 characters due to the use of NTFS-direct.
Limitations:
-
See also:
• IEF. / NEF. - If - exist - File