[#BloombergLP-balxml-Reader-advanceToNextNode]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/balxml.adoc[balxml]::xref:BloombergLP/balxml/Reader.adoc[Reader]::advanceToNextNode
:relfileprefix: ../../../
:mrdocs:

Move to the next node in the data stream created by `open`.

== Synopsis

Declared in `<balxml_reader.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
virtual
int
advanceToNextNode() = 0;
----

== Description

Allow the node's properties to be queried via the `Reader` accessors. Return 0 on successful read, 1 if there are no more nodes to read, and a negative number otherwise. Note that each call to `advanceToNextNode` invalidates strings and data structures returned when `Reader` accessors were called for the "prior node". E.g., the pointer returned from `nodeName` for this node will not be valid once `advanceToNextNode` is called. Note that the reader will not be on a valid node until the first call to `advanceToNextNode` after the reader is opened.

== Return Value

0 on successful read, 1 if there are no more nodes, and a negative number otherwise


[.small]#Created with https://www.mrdocs.com[MrDocs]#