=====Function nextEvent===== This function is part of the [[FunctionsStAX StAX]] support. ====Name==== **nextEvent** returns the next event from an ""XMLEventReader"" ====Synopsis==== nextEvent( $reader ) ====Description==== nextEvent returns the next event from an ""XMLEventReader"" created with the [[FunctionStAXnewEventReader newEventReader]]. The object returned is a native Java object (see: [[JavaObjects Java Objects]]) of type [[http://download.oracle.com/javase/6/docs/api/javax/xml/stream/events/XMLEvent.html XMLEvent]]. The only supported use of this object is by using the [[FunctionsStAX StAX Functions]] ||[[FunctionStAXgetAttribute getAttribute]]||Gets an attribute value from a ""StAX"" START_ELEMENT Event|| ||[[FunctionStAXgetData getData]]||Gets the Data of a ""StAX"" Event|| ||[[FunctionStAXgetEventType getEventType]]||Gets event type of a ""StAX"" Event|| ||[[FunctionStAXgetName getName]]||Gets name of a ""StAX"" Event as a QName|| ||[[FunctionStAXgetNamespace getNamespace]]||Gets namespace URI of a ""StAX"" Event as a String|| To use the ""StAX"" functions you need to [[CommandImport import]] them into either the global namespace or a local namespace. Its recommended that you use a local namespace so that there is less chance of name collisions. Example: process every START_EVENT for element named "element" %% import commands stax=stax reader=stax:newEventReader( file.xml ) while [ stax:hasNext( $reader START_ELEMENT element ) ] ; do event=stax:nextEvent( $reader ) ; done stax:closeReader $reader %% ---- [[Commands]] [[FunctionsStAX StAX Functions]] [[FunctionStAXnewEventReader newEventReader]] [[FunctionStAXhasNext hasNext]] [[JavaObjects Java Objects]]