CMarkup OutOfElem Method

bool CMarkup::OutOfElem();

Whereas IntoElem is used to go deeper into the document, OutOfElem is used to get back out. When you call OutOfElem, the main position goes to the parent element and the child position goes to what was the main position. The return value is false if the current position is already at the top of the document.

See Navigating Levels in CMarkup.

<config>
  <diagnostics d="3">
    <file>C:\temp\a.txt</file>
  </diagnostics>
</config>

If the main position is the file element, calling OutOfElem makes the diagnostics element the main position (leaving the file element as the child position). Another call to OutOfElem makes the config element the main position (leaving the diagnostics element as the child position). Another call to OutOfElem returns false and leaves the config element as the main position and the diagnostics element as the child position.

Update March 24, 2009: OutOfElem can be used with CMarkup release 11.0 developer version file read mode (see C++ XML reader) and file write mode (see C++ XML writer). In the file modes, the meaning of OutOfElem is the same as otherwise but its usage is limited to the forward-only purposes of file reading and writing. In file read mode OutOfElem goes "out of" the current element to find elements and nodes after its end tag. In file write mode, OutOfElem goes "out of" the current element to add elements and nodes after its end tag, and unlike regular CMarkup usage it sets the current position after end tag.