pcolcatenateitem

Catenates two collections.

Synopsis

pcolcatenateitem [col_in1|-] [col_in2|-] [col_out|-]

Description

pcolcatenateitem creates the collection col_out from items of the two input collections col_in1 and col_in2.

If an item has the same name in the two collections and the type is compatible then an array is created with the concatenation of the values of the two collections otherwise the item values of the first collection col_in1 are preferred.

Inputs

col_in: a collection.

Outputs

col_out: a collection.

Result

Returns SUCCESS or FAILURE.

Examples

Catenates the 2 collections c1.pan and c2.pan in the collection col.pan and then extracts the two images in file foo.pan and bar.pan:

   pobject2col foo tangram.pan c1.pan
   pobject2col bar parrot.pan c2.pan
   pcolcatenateitem c1.pan c2.pan col.pan
   pcolgetimages col.pan

C++ prototype

Errc PColCatenateItem( const Collection &col_in_out, const Collection &c2 );

Version française

Concaténation des éléments de deux collections.

Author: Alexandre Duret-Lutz