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

Table24.124.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

Example24.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>