(PHP 3 >= 3.0.6, PHP 4, PHP 5)
xml_set_element_handler -- ορίζει τα στοιχεία αρχής και τέλους των handlers
Ορίζει τις συναρτήσεις handler στοιχείων για τον XML parser
parser
.Η
start_element_handler
και η
end_element_handler
είναι strings που περιέχουν
τα ονόματα των συναρτήσεων που πρέπει να υπάρχουν όταν η
xml_parse() καλείται για
parser
.
Η συνάρτηση που ονομάζεται από την start_element_handler
πρέπει να δέχεται τρεις παραμέτρους:
start_element_handler ( resource parser, string name, array attribs )
parser
Η πρώτη παράμετρος, parser, είναι μια αναφορά στον XML parser που καλεί τον handler.
name
Η δεύτερη παράμετρος, name
, περιέχει το όνομα
του στοιχείου για το οποίο αυτός ο handler καλείται. Αν το case-folding έχει ενεργοποιηθεί γι'αυτόν τον
parser, το όνομα του στοιχείου θα είναι στα κεφαλαία.
attribs
Η τρίτη παράμετρος, attribs
, περιέχει έναν
associative array με τα γνωρίσματα (attributes) των στοιχείων (αν υπάρχουν). Τα κλειδιά (keys)
αυτού του πίνακα (array) είναι τα ονόματα των attribute, και οι τιμές είναι οι τιμές των
attributes. Τα ονόματα των attribute names είναι case-folded με τα ίδια κριτήρια όπως και τα
ονόματα των στοιχείων. Οι τιμές των attribute values δεν είναι
case-folded.
Η αρχική σειρά των attributes μπορείτε να την πάρετε αν προσπελάσετε
τα attribs
με τον κανονικό τρόπο, χρησιμοποιώντας την
each(). Το πρώτο key στον array θα είναι το πρώτο
attribute, κ.ο.κ.
Η συνάρτηση που ονομάζεται από την end_element_handler
πρέπει να δέχεται δυο παραμέτρους:
end_element_handler ( resource parser, string name )
parser
Η πρώτη παράμετρος, parser, είναι μια αναφορά στον XML parser όταν καλεί τον handler.
name
Η δεύτερη παράμετρος, name
, περιέχει το όνομα
του στοιχείου για το οποίο ο handler καλείται. Αν το case-folding έχει ενεργοποιηθεί γι'αυτόν τον
parser, το όνομα του στοιχείου θα είναι σε κεφαλαία γράμματα.
Αν μια συνάρτηση handler οριστεί σε κενό string, ή FALSE, ο handler υπό αμφισβήτηση απενεργοποιείται.
TRUE επιστρέφεται αν ο handler οριστεί, και FALSE αν ο
parser
δεν είναι parser.
Óçìåßùóç: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.