TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-20
#APPENDV Built-In Function
#APPENDV Built-In Function
Use #APPENDV to append a string to the contents of a variable level, to append a
copy of the contents of one variable level to the end of another variable level, or to
send data to a file or process opened by #REQUESTER.
to-variable-level
is the name of an existing variable level whose definition is to be modified.
from-variable-level
is the name of an existing variable level whose definition is to be copied. This
variable level is not modified.
string
is an argument of type STRING.
Result
#APPENDV returns nothing.
Considerations
•
If from-variable-level is a variable level of type STRUCT, the #APPENDV
function appends a line containing the binary data of the STRUCT to to-
variable-level, which can be of another type. This function is primarily used to
supply structured data to variables associated with servers and requesters.
•
If from-variable-level is empty, #APPENDV does nothing.
•
The form #APPENDV var struct is not equivalent to #APPEND var [struct], which
appends the STRUCT external representation, rather than its binary data.
•
If you are using #APPENDV to access data in a file, check the error variable
(defined with #REQUESTER) to see if a file system error occurred.
Example
Assuming the home terminal name is $MINE, the following:
#PUSH sayterm termname
#SETV sayterm "My terminal is"
#SET termname [#MYTERM]
#APPENDV sayterm termname '+' " at this time."
causes SAYTERM to contain “My terminal is $MINE at this time.”
#APPENDV to-variable-level { from-variable-level | string }