xml_set_element_handler
(PHP 4, PHP 5)
xml_set_element_handler — Ustawia początkową i końcową procedurę obsługi elementu
Opis
bool xml_set_element_handler
(
resource $parser
,
callback $początkowa_procedura_obsługi_elementu
,
callback $końcowa_procedura_obsługi_elementu
)
Parametry
-
parser
-
-
początkowa_procedura_obsługi_elementu
-
Funkcja nazwana przez początkowa_procedura_obsługi_elementu
musi przyjmować trzy parametry:
początkowa_procedura_obsługi_elementu
( resource $parser
, string $nazwa
, array $atrybuty
)
-
parser
-
Pierwszy parametr, parser,
jest referencją do parsera XML wywołującego procedurę obsługi.
-
nazwa
-
Drugi parametr, nazwa
, zawiera nazwę elementu
dla którego procedura obsługi została wywołana. Jeśli dla tego parsera
włączony jest case-folding,
wówczas nazwa elementu będzie zamieniona na duże litery.
-
atrybuty
-
Trzeci parametr, atrybuty
, zawiera tablicę
asocjacyjną z atrybutami elementów (jeśli jakiekolwiek są).
Kluczami tych tablic są nazwy atrybutów a wartościami wartości artybutów.
Nazwy atrybutów są zamieniane na duże litery za pomocą opcji case-folding na tej samej zasadzie jak
nazwy elementów. Wartości atrybutów opcja case-folded nie
dotyczy.
Oryginalna kolejność atrybutów może być odzyskana za pomocą normalnego
przejścia przez atrybuty
używając each().
Pierwszy klucz w tablicy był pierwszym atrybutem itd.
Informacja: Zamiast nazwy funkcji może zostać
przekazana tablica zawierająca referencję do obiektu i nazwę metody
-
końcowa_procedura_obsługi_elementu
-
Funkcja nazwana przez końcowa_procedura_obsługi_elementu
musi przyjmować dwa parametry:
końcowa_procedura_obsługi_elementu
( resource $parser
, string $nazwa
)
-
parser
-
Pierwszy parametr, parser,
jest referencją do parsera XML wywołującego procedurę obsługi.
-
nazwa
-
Drugi parametr, nazwa
, zawiera nazwę elementu
dla którego procedura obsługi została wywołana. Jeśli dla tego parsera
włączony jest case-folding,
wówczas nazwa elementu będzie zamieniona na duże litery.
Jeśli funkcja procedury obsługi jest podana jako pusty ciąg znaków lub FALSE,
wówczas procedura obsługi w zapytaniu jest wyłączona.
Zwracane wartości
Zwraca TRUE w przypadku powodzenia, FALSE w
przypadku błędu.