xml_set_processing_instruction_handler
(PHP 4, PHP 5)
xml_set_processing_instruction_handler —
Ορίζει τον processing instruction (PI) handler
Περιγραφή
bool xml_set_processing_instruction_handler
( resource $parser
, callback $handler
)
Ορίζει τη συνάρτηση για τον processing instruction (PI) handler για τον XML parser
parser
. Ο handler
είναι ένα
string που περιέχει το όνομα της συνάρτησης που πρέπει να υπάρχει όταν ο
xml_parse() καλείται για
parser
.
Μια processing instruction έχει την ακόλουθη μορφή:
Μπορείτε να βάλετε PHP κώδικα μέσα σε ένα τέτοιο tag, αλλά προσέξτε έναν περιορισμό: σε
ένα XML PI, το tag τέλους του PI (
?>) δεν μπορεί να είναι σε εισαγωγικά,
συνεπώς αυτή η ακολουθία χαρακτήρων δεν πρέπει να εμφανιστεί στον PHP κώδικα τον οποίο εισάγετε
με PIs στα XML αρχεία. Αν κάτι τέτοιο συμβεί, το υπόλοιπο του PHP κώδικα, καθώς επίσης και το
"πραγματικό" tag τέλους του PI , θα χρησιμοποιείται ως δεδομένο χαρακτήρων.
Αυτή η συνάρτηση που ονομάζεται από τον handler
πρέπει να
δέχεται τρεις παραμέτρους:
handler
( resource $parser
, string $target
, string $data
)
-
parser
-
Η πρώτη παράμετρος, ο parser, είναι μια
αναφορά στον XML parser που καλεί τον handler.
-
target
-
Η δεύτερη παράμετρος, target
, περιέχει τον PI
target.
-
data
-
Η τρίτη παράμετρος, data
, περιέχει τα PI
δεδομένα.
Αν μια συνάρτηση handler οριστεί ίση με ένα κενό string, ή FALSE, ο handler
υπό αμφισβήτηση απενεργοποιείται.
TRUE επιστρέφεται αν ο handler οριστεί, FALSE αν ο
parser
δεν είναι parser.
Note: Αντί για ένα όνομα συνάρτησης, ένα array που περιέχει μια αναφορά σε ένα αντικείμενο και ένα όνομα μεθόδου μπορεί να δοθεί.