xml_set_notation_decl_handler

(PHP 4, PHP 5)

xml_set_notation_decl_handler — Configura el manejador de declaraciones de notación

bool xml_set_notation_decl_handler ( resource $parser , callable $handler )

Configura la función del manejador de declaraciones de notación (NOTATION) para el intérprete XML parser.

Una declaración de notación es parte del DTD del documento y tiene el siguiente formato:

<!NOTATION <parameter>name</parameter>
      { <parameter>systemId</parameter> | <parameter>publicId</parameter>?>

Para la definición de declaraciones de notación ver » sección 4.7 de las especificaciones XML 1.0 .

parser

Identificador del recurso del intérprete XML para el que se va a configurar la función del manejador de declaración de notación.

handler

handler es un string que contiene el nombre de una función que debe existir cuando xml_parse() es llamado por parser.

La función llamada mediante handler debe aceptar cinco parámetros:

handler ( resource $parser , string $notation_name , string $base , string $system_id , string $public_id )

parser: El primer parámetro, parser, hace referencia al intérprete XML que llama al manejador.
notation_name: Esto es el name de la notación, como se describió arriba en el formato de notación.
base: Esta es la base para resolver el identificador de sistema (system_id) de la declaración de notación. Actualmente este parámetro siempre se establecerá como una cadena vacia.
system_id: Identificador de sistema de la declaración de notación externa.
public_id: Identificador público de la declaración de notación externa.

Si la función del manejador se configura como una cadena vacia, o FALSE, el manejador en cuestión se deshabilita.

Nota: En lugar del nombre de una función, se puede asignar un array que contenga la referencia a un objeto o el nombre de un método.

Devuelve TRUE en caso de éxito o FALSE en caso de error.