| Warning | 
This function is EXPERIMENTAL. That means, that the behaviour of this function, this function name, in concreto ANYTHING documented here can change in a future release of PHP WITHOUT NOTICE. Be warned, and use this function at your own risk.  | 
The function parses the XML document in str and returns an object of class "Dom document", having the properties as listed above.
See also xmldocfile()