xml_parse_into_struct
Interpreta datos XML en una estructura de array
&reftitle.description;
intxml_parse_into_struct
resourceparser
stringdata
arrayvalues
arrayindex
Esta función interpreta una cadena XML en dos estructuras paralelas de array, una
(index) que contiene punteros a la ubicación de los
valores adecuados en el array values. Estos dos últimos
parámetros deben ser pasados por referencia.
&reftitle.parameters;
parser
Una referencia para el interprete de XML.
data
Una cadena que contiene los datos XML.
values
Un array que contiene los valores de los datos XML.
index
Un array que contiene apuntadores hacia la ubicación de los valores apropiados en $values.
&reftitle.returnvalues;
xml_parse_into_struct retorna 0 cuando falla y 1 si es
exitoso. Esto no es lo mismo que &false; y &true;, tener cuidado con
operadores tales como ===.
&reftitle.examples;
A continuación se muestra un ejemplo que ilustra la estructura interna de
los arrays que se generan por la función. Se usa una etiqueta simple
note incrustada dentro de una etiqueta
para y entonces esto se interpreta y se muestran
las estructuras generadas:
Ejemplo de <function>xml_parse_into_struct</function>
Nota Simple";
$p = xml_parser_create();
xml_parse_into_struct($p, $simple, $vals, $index);
xml_parser_free($p);
echo "Index array\n";
print_r($index);
echo "\nVals array\n";
print_r($vals);
?>
]]>
Cuando se ejecuta este código, la salida será:
Array
(
[0] => 0
[1] => 2
)
[NOTE] => Array
(
[0] => 1
)
)
Vals array
Array
(
[0] => Array
(
[tag] => PARA
[type] => open
[level] => 1
)
[1] => Array
(
[tag] => NOTE
[type] => complete
[level] => 2
[value] => simple note
)
[2] => Array
(
[tag] => PARA
[type] => close
[level] => 1
)
)
]]>
El análisis por eventos (basado en la biblioteca expat) puede ser más
complicado cuando se tiene un documento XML que es complejo.
Esta función no produce un objeto de estilo DOM, pero
genera estructuras susceptibles de ser transversionadas en forma
de árbol. Por lo tanto, se pueden crear objetos que representan los datos
en el archivo XML con facilidad. Considere el siguiente archivo XML
que representa una pequeña base de datos con información de aminoácidos:
moldb.xml - pequeña base de datos de información molecular
Alanine
ala
A
hydrophobic
Lysine
lys
K
charged
]]>
Y algo de código para interpretar el documento y generar los objetos
adecuados:
parsemoldb.php - interpreta moldb.xml dentro de un array de
objetos moleculares
$v)
$this->$k = $aa[$k];
}
}
function readDatabase($filename)
{
// read the XML database of aminoacids
$data = implode("", file($filename));
$parser = xml_parser_create();
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1);
xml_parse_into_struct($parser, $data, $values, $tags);
xml_parser_free($parser);
// repetir a través de las extructuras
foreach ($tags as $key=>$val) {
if ($key == "molecule") {
$molranges = $val;
// cada par contiguo de netradas de array son los
// rangos altos y bajos para cada definición de molécula
for ($i=0; $i < count($molranges); $i+=2) {
$offset = $molranges[$i] + 1;
$len = $molranges[$i + 1] - $offset;
$tdb[] = parseMol(array_slice($values, $offset, $len));
}
} else {
continue;
}
}
return $tdb;
}
function parseMol($mvalues)
{
for ($i=0; $i < count($mvalues); $i++) {
$mol[$mvalues[$i]["tag"]] = $mvalues[$i]["value"];
}
return new AminoAcid($mol);
}
$db = readDatabase("moldb.xml");
echo "** Database of AminoAcid objects:\n";
print_r($db);
?>
]]>
Después de ejecutar parsemoldb.php, la variable
$db contiene un array de
objetos de AminoAcid y la salida del
script confirma que:
Objeto aminoácido
(
[name] => Alanine
[symbol] => ala
[code] => A
[type] => hydrophobic
)
[1] => Objeto aminoácido
(
[name] => Lysine
[symbol] => lys
[code] => K
[type] => charged
)
)
]]>