Return to README CVS log

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

Annotation of embedaddon/php/ext/simplexml/README, revision 1.1.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.