=====Function getData=====

This function is part of the [[FunctionsStAX StAX]] support.

====Name====
**getData** returns the data (text) portion of a CHARACTERS event.


====Synopsis====
getData( $event )



====Description====


getData return the data of a CHARACTERS event as a string.
The $event argument must be a CHARACTERS event returned from [[FunctionStAXnextEvent nextEvent]].



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" and print the attribute value for "attr"

Given an xml file "file.xml"
%%(xml)
<file>
<element attr="attr1"/>
<element attr="attr2">String</element>
</file>

%%

%%
import commands stax=stax
reader=stax:newEventReader( file.xml )
while [ stax:hasNext( $reader CHARACTERS ) ] ; do
event=stax:nextEvent( $reader ) ;
data=stax:getData( $event attr )
echo $data
done

stax:closeReader $reader

%%

Result
%%


String

%%



----
[[Commands]]
[[FunctionsStAX StAX Functions]]
[[FunctionStAXnewEventReader newEventReader]]
[[FunctionStAXnextEvent nextEvent]]
[[JavaObjects Java Objects]]