Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / php / ext / simplexml

php

    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.