Annotation of embedaddon/php/ext/simplexml/README, revision 1.1
1.1 ! misho 1: SimpleXML is meant to be an easy way to access XML data.
! 2:
! 3: SimpleXML objects follow four basic rules:
! 4:
! 5: 1) properties denote element iterators
! 6: 2) numeric indices denote elements
! 7: 3) non numeric indices denote attributes
! 8: 4) string conversion allows to access TEXT data
! 9:
! 10: When iterating properties then the extension always iterates over
! 11: all nodes with that element name. Thus method children() must be
! 12: called to iterate over subnodes. But also doing the following:
! 13: foreach ($obj->node_name as $elem) {
! 14: // do something with $elem
! 15: }
! 16: always results in iteration of 'node_name' elements. So no further
! 17: check is needed to distinguish the number of nodes of that type.
! 18:
! 19: When an elements TEXT data is being accessed through a property
! 20: then the result does not include the TEXT data of subelements.
! 21:
! 22: Known issues
! 23: ============
! 24:
! 25: Due to engine problems it is currently not possible to access
! 26: a subelement by index 0: $object->property[0].
! 27:
! 28: TODO
! 29: ====
! 30:
! 31: At the moment property access to multiple elements of the same
! 32: name returns an array of SimpleXML objects. This should be an
! 33: object of a new type instead so that all kinds of linkage,
! 34: assignment and deleting would work.
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>