Prev Up Next
xte_nodebld_acc Home xte_nodebld_init

Name

xte_nodebld_final — Corrects input vector

Synopsis

xte_nodebld_final ( inout arg any ,
in head any );

Description

By default this function reduces all last empty items from the first argument and returns it, but supplied a second argument it also replaces the first item of the first argument by the second argument, but does not commit the return.

Parameters

arg

The vector created by the xte_nodebld_init() and filled by xte_nodebld_acc() function

head

A vector returned by xte_head() function

Errors

Table24.125.Errors signalled by xte_nodebld_final

SQLState Error Code Error Text Description
22003 SR347 Too few arguments for xte_nodebld_final
22003 SR348 The first argument of xte_node_nodebld_final is not made by xte_nodebld_init() function

Examples

Example24.491.xte_nodebld_final() with a single argument

Before the xte_nodebld_final() call the length of the vector acc is equal to 16, after the call the length is 3. The vector acc does not correspond to a xml document - there is no a root tag. The result of the xte_nodebld_final() may be used as argument for xte_node_from_nodebld() to get a vector corresponding to complete xml document.

create procedure test1_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')));
                acc:=xte_nodebld_final(acc);
                            . . .
              }

Example24.492.xte_nodebld_final() with two arguments.

The vector acc below is corresponding to the following XML element:

<product>string1string2string3

<supplier CompanyName="Seller"></supplier>

</product>

create procedure test2_nodebld()
              {
                declare acc any;
                declare "Res" any;
                declare "ResLen" integer;
                result_names ("ResLen", "Res");
                xte_nodebld_init (acc);
                xte_nodebld_acc (acc,'string1', 'string2');
                xte_nodebld_acc(acc, 'string3',xte_node(xte_head ('supplier', 'CompanyName','Seller')));
                xte_nodebld_final(acc, xte_head('product'));
                result (length(acc), xml_tree_doc (acc));
              }
test_nodebld()
ResLen      Res
INTEGER     VARCHAR
_______________________________________________________________________________

3           <product>string1string2string3<supplier CompanyName="Seller" /></product>

Prev Up Next
xte_nodebld_acc Home xte_nodebld_init