=====Function getNamespace=====

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

====Name====
**getNamespace** returns the namespace uri of a START_ELEMENT event as string.


====Synopsis====
getNamepace( $event  )



====Description====


getNamepacereturns the name of an element.
The $event argument must be a START_ELEMENT 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 xmlns:a="www.test.com">
 <a:element attr="attr1"/>
 <a:element attr="attr2">String</a:element>
</file>

%%

%%
import commands stax=stax
reader=stax:newEventReader( file.xml )
while [ stax:hasNext( $reader START_ELEMENT ) ] ; do
	event=stax:nextEvent( $reader ) ;
	name=stax:getName( $event )
	ns=stax:getNamespace( $event )
	xtype $ns $name
	echo $ns $name
done

stax:closeReader $reader 

%%

Result
%%
net.sf.saxon.s9api.QName
file
xs:string
net.sf.saxon.s9api.QName
www.test.com a:element
xs:string
net.sf.saxon.s9api.QName
www.test.com a:element
%%



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