allowHeteroChildren append checkInvariant childCount destImageFile dump elementName get get isAttached isDefined isRoot operator Node parent pathName VectorNode VectorNode

void append ( Node  n ) Append a child element to end of VectorNode. Parameters: [in] n The node to be added as a child at end of the VectorNode. If the VectorNode is homogeneous and already has at least one child, then n must be identical to the existing children in every visible characteristic except the stored values. These visible characteristics include number of children (for StructureNode and VectorNode descendents), number of records/prototypes/codecs (for CompressedVectorNode), minimum/maximum attributes (for IntegerNode, ScaledIntegerNode, FloatNode), byteCount (for BlobNode), scale/offset (for ScaledIntegerNode), and all elementNames. The VectorNode must not be a descendent of a homogeneous VectorNode with more than one child. Precondition: The new child node n must be a root node (not already having a parent). The destination ImageFile must be open (i.e. destImageFile().isOpen()). The associated destImageFile must have been opened in write mode (i.e. destImageFile().isWritable()). Postcondition: the childCount is incremented. Exceptions: E57_ERROR_IMAGEFILE_NOT_OPEN E57_ERROR_HOMOGENEOUS_VIOLATION E57_ERROR_FILE_IS_READ_ONLY E57_ERROR_ALREADY_HAS_PARENT E57_ERROR_DIFFERENT_DEST_IMAGEFILE E57_ERROR_INTERNAL All objects in undocumented state See also: VectorFunctions.cpp example, VectorNode::childCount, VectorNode::get(int64_t), StructureNode::set