xml_parse
Rozpoczyna parsowanie dokumentu XML
&reftitle.description;
intxml_parse
XMLParserparser
stringdata
boolis_final&false;
xml_parse parsuje dokument XML. Uchwyty dla
skonfigurowanych zdarzeń są wywoływane odpowiednią ilość razy.
&reftitle.parameters;
parser
Referencja do parsera XML, który ma zostać użyty.
data
Fragment danych do parsowania. Dokument może być prawidłowo parsowany po
kawałku za pomocą wielokrotnego wywoływania xml_parse
z nowymi danymi, dopóki podany jest parametr is_final
i posiada on wartość logiczną &true; podczas parsowania ostatniej porcji danych.
is_final
Jeśli jest podany i posiada wartość logiczną &true;, data
są ostatnim kawałkiem wysłanych danych podczas tego parsowania.
&reftitle.returnvalues;
Zwraca 1 w przypadku powodzenia lub 0 w przypadku błędu.
Dla parsowań zakończonych niepomyślnie można uzyskać informację o błędach
za pomocą xml_get_error_code,
xml_error_string,
xml_get_current_line_number,
xml_get_current_column_number i
xml_get_current_byte_index.
Niektóre błędy (takie jak błędy encji) są zgłaszane na końcu danych, a więc tylko wtedy,
gdy ustawiony jest parametr is_final i posiada on wartość &true;.
&reftitle.changelog;
&Version;
&Description;
&xml.changelog.parser-param;
&reftitle.examples;
Parsowanie fragmentów dużych dokumentów XML
Ten przykład pokazuje, jak duże dokumenty XML mogą być odczytywane
i parsowane we fragmentach, dzięki czemu nie jest konieczne przechowywanie całego
dokumentu w pamięci. Obsługa błędów została pominięta dla zwięzłości.