E57 Foundation API v1.1.312  Aug. 10, 2011
Node get ( const ustring pathName) const

Get a child element by string path name.

Parameters:
[in]pathNameThe pathname, either absolute or relative, of the object to get.

The pathName may be relative to this node, or absolute (starting with a "/"). The origin of the absolute path name is the root of the tree that contains this VectorNode. If this VectorNode is not attached to an ImageFile, the pathName origin root will not the root node of an ImageFile.

The element names of child elements of VectorNodes are numbers, encoded as strings, starting at "0".

Precondition:
The destination ImageFile must be open (i.e. destImageFile().isOpen()).
The pathName must be defined (i.e. isDefined(pathName)).
Postcondition:
No visible state is modified.
Returns:
A smart Node handle referencing the child node.
Exceptions:
E57_ERROR_BAD_PATH_NAME
E57_ERROR_PATH_UNDEFINED
E57_ERROR_IMAGEFILE_NOT_OPEN
E57_ERROR_INTERNALAll objects in undocumented state
See also:
VectorFunctions.cpp example, VectorNode::childCount, VectorNode::append, StructureNode::get(int64_t) const
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines