# xml_set_character_data_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_character_data_handler — Configura el manejador de los datos de caracteres

### Descripción

xml_set_character_data_handler(XMLParser `$parser`, callable `$handler`): bool

Configura la función del manejador de los datos de caracteres para el intérprete XML `parser`.

### Parámetros

`parser`

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

`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 dos parámetros:

  handler(XMLParser `$parser`, string `$data`)
  `parser`
    El primer parámetro, parser, hace referencia al intérprete XML que llama al manejador.
  `data`
    El segundo parámetro, `data`, contiene los datos de caracteres como un string.

  El manejador de datos de caracteres es llamado para cada pieza de un texto en el documento XML. Puede ser llamado multiples veces dentro de cada fragmento (por ejemplo, para strings que no son ASCII).

  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.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `parser` expects an XMLParser instance now; previously, a valid `xml` resource was expected.