php-src/ext/simplexml
Peter Kokot 43e6fd1e2b Merge branch 'PHP-7.2' into PHP-7.3
* PHP-7.2:
  Convert CRLF to LF
2019-05-13 03:53:31 +02:00
..
tests Merge branch 'PHP-7.2' into PHP-7.3 2019-05-13 03:53:31 +02:00
config.m4 Trim trailing whitespace in source code files 2018-10-13 14:14:50 +02:00
config.w32 Remove unused Git attributes ident 2018-07-25 00:53:25 +02:00
CREDITS
php_simplexml_exports.h Remove unused Git attributes ident 2018-07-25 00:53:25 +02:00
php_simplexml.h Remove unused Git attributes ident 2018-07-25 00:53:25 +02:00
README Trim trailing whitespace in source code files 2018-10-13 14:16:33 +02:00
simplexml.c Fix #76712: Assignment of empty string creates extraneous text node 2018-08-25 14:24:09 +02:00
sxe.c Remove unused Git attributes ident 2018-07-25 00:53:25 +02:00
sxe.h Remove unused Git attributes ident 2018-07-25 00:53:25 +02:00

SimpleXML is meant to be an easy way to access XML data.

SimpleXML objects follow four basic rules:

1) properties denote element iterators
2) numeric indices denote elements
3) non numeric indices denote attributes
4) string conversion allows to access TEXT data

When iterating properties then the extension always iterates over
all nodes with that element name. Thus method children() must be
called to iterate over subnodes. But also doing the following:
foreach ($obj->node_name as $elem) {
  // do something with $elem
}
always results in iteration of 'node_name' elements. So no further
check is needed to distinguish the number of nodes of that type.

When an elements TEXT data is being accessed through a property
then the result does not include the TEXT data of subelements.

Known issues
============

Due to engine problems it is currently not possible to access
a subelement by index 0: $object->property[0].

TODO
====

At the moment property access to multiple elements of the same
name returns an array of SimpleXML objects. This should be an
object of a new type instead so that all kinds of linkage,
assignment and deleting would work.