xml_set_start_namespace_decl_handler

(PHP 4 >= 4.0.5, PHP 5)

xml_set_start_namespace_decl_handler — Configura el manejador de declaración de inicio del namespace

Descripción

bool xml_set_start_namespace_decl_handler ( resource $parser , callable $handler )

Configura un manejador para ser llamado cuando un namespace es declarado. La declaración de namespace ocurre dentro de las etiquetas de inicio. Sin embargo, el manejador inicial de declaración del namespace es llamado antes del manejador de etiqueta inicial para cada namespace declarado en esa etiqueta de inicio.

Parámetros

parser

Identificador del recurso del intérprete XML.

handler

handler es una cadena 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 tres parámetros, y deberia devolver un número entero. Si el valor devuelto desde el manejador es FALSE (lo cual ocurrirá si no se devulve un valor), el intérprete XML detendrá el analizado y xml_get_error_code() devolverá XML_ERROR_EXTERNAL_ENTITY_HANDLING.

handler ( resource $parser , string $prefix , string $uri )

parser: El primer parámetro, parser, es una referencia al intérprete XML que llama al manejador.
prefix: El prefijo es una cadena que se utiliza para hacer referencia al namespace dentro de un objeto XML.
uri: Identificador de Recurso Uniforme (URI, por sus siglas en inglés) del namespace.

Si una función del manejador se configura como una cadena vacía, o FALSE, el manejador en cuestión es deshabilitado.

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.

Valores devueltos

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

Ver también

xml_set_end_namespace_decl_handler() - Configura el manejador de declaración de final del namespace