Name
xte_nodebld_acc — Adds to the first arguments all remaining arguments
Synopsis
xte_nodebld_acc
(
|
in acc any , |
| in arg1 any , | |
| ... , | |
in
argN
any
); |
Description
The xte_nodebld_acc() function successively adds the remaining arguments to the first one. If the last items of the first argument and some following arguments are strings, they are concatenated. All successive strings are concatenated. The value of the first item is the number of the non-empty items in the returned vector. The length of the returned vector is the sum of the length of the first argument and number of the remaining arguments.
Parameters
acc
A vector initiated by xte_nodebld_init() function and filled by xte_nodebld_acc() functions
argI
A string or a vector returned by xte_node_from_nodebld or xte_node functions
Errors
Table 24.123. Errors signalled by
xte_nodebld_acc
| SQLState | Error Code | Error Text | Description |
|---|---|---|---|
| 22003 | SR345 | Too few arguments for xte_nodebld_acc | |
| 22003 | SR346 | The first argument of xte_nodebld_acc is not made by xte_nodebld_init() function |
Examples
Example 24.490. Simple Use
create procedure test_nodebld()
{
declare acc any;
xte_nodebld_init (acc);
xte_nodebld_acc (acc,'string1', string2');
xte_nodebld_acc(acc, 'string3',xte_node(xte_head ('supplier', 'CompanyName','Seller')));
. . .
}
The length of the vector acc as the result of the two xte_nodebld_acc() calls below is equal to 4, but only three items are not empty:
'3' (number of not empty elements of the vector including this item)
'string1string2string3' (the result of concatenation)
vector corresponding the following XML element: <supplier CompanyName="Seller"> </supplier>