9.144 MESSAGE_BOX_APPEND
Note: Built-In Function Rules Usage Options
Appends one or more items to the message box assembly area. A new message line is not started. These items would normally be displayed by the MESSAGE_BOX_SHOW, Built-In Function at some later time.
Arguments
|
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
X
|
Req
|
First item to be appended to the message box assembly area
|
1
|
256
|
0
|
9
|
|
2 - 10
|
X
|
Opt
|
Subsequent items to be appended to the message box assembly area
|
1
|
256
|
0
|
9
|
|
Return Values
There are no Return Values
Technical Notes
- This Built-In Function does not cause a new message line to be started. It is designed to append information to existing message lines.
- All items (including the first one) are separated, by a single blank from the preceding item.
- Items are converted to left aligned strings and trailing blanks are truncated. A completely blank/null item is converted to a single blank.
- The message box message assembly area can contain at most 4096 characters (including any automatically inserted blanks or control characters). Once the assembly area reaches its maximum size all in progress or subsequent add or append operations are ignored. No notification or error is given when this situation arises.
Examples
Refer to 9.146 MESSAGE_BOX_SHOW
