TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-155
#EMSTEXT Built-In Function
Considerations
•
You cannot access the lengths result from the EMSTEXT procedure with
#EMSTEXT; you must use #EMSTEXTV instead.
•
The INT(32) result of EMSTEXT is not included in the result of #EMSTEXT; you
must use #EMSTEXTV to access it.
•
Because #EMSTEXT can produce more than one line, you should always use
square brackets around the construct containing the invocation of #EMSTEXT:
[#OUTPUT [#EMSTEXT var]] and [#SET var2 [#EMSTEXT var1]]
are correct, whereas
#OUTPUT [#EMSTEXT var] and #SET var2 [#EMSTEXT var1]
would produce TACL errors if #EMSTEXT returned more than a single line.
•
#EMSTEXT does not suppress leading and trailing blank lines in the result, but
remember that TACL ignores leading and trailing white space on arguments in
most cases.
•
#EMSTEXT does not suppress leading and trailing spaces on nonblank lines in the
result, but remember that TACL ignores leading and trailing white space on
arguments in most cases.
•
If a STRUCT is longer than the data it is to contain, the unused bytes are ignored
on input and unchanged on output.
•
If a STRUCT is too short, an error results.
•
To obtain information from an event buffer and place the printable text into a
STRUCT, use the #EMSTEXTV built-in function.