xml_set_element_handler

Περιγραφή

Ορίζει τις συναρτήσεις handler στοιχείων για τον XML parser parser .Η start_element_handler και η end_element_handler είναι strings που περιέχουν τα ονόματα των συναρτήσεων που πρέπει να υπάρχουν όταν η xml_parse() καλείται για parser .

Η συνάρτηση που ονομάζεται από την start_element_handler πρέπει να δέχεται τρεις παραμέτρους:

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 πρέπει να δέχεται δυο παραμέτρους:

parser

Η πρώτη παράμετρος, parser, είναι μια αναφορά στον XML parser όταν καλεί τον handler.

name

Η δεύτερη παράμετρος, name , περιέχει το όνομα του στοιχείου για το οποίο ο handler καλείται. Αν το case-folding έχει ενεργοποιηθεί γι'αυτόν τον parser, το όνομα του στοιχείου θα είναι σε κεφαλαία γράμματα.

Αν μια συνάρτηση handler οριστεί σε κενό string, ή FALSE, ο handler υπό αμφισβήτηση απενεργοποιείται.

TRUE επιστρέφεται αν ο handler οριστεί, και FALSE αν ο parser δεν είναι parser.

Note: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.