xml_set_character_data_handler

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

xml_set_character_data_handler — Configura manipulador de dados de caracteres

Descrição

xml_set_character_data_handler(XMLParser $parser, callable $handler): true

Define a função do manipulador de dados de caracteres para o analisador XML parser.

Parâmetros

parser

O analisador XML.

handler

Se null ou uma string vazia for passada, o manipulador será redefinido para seu estado padrão.

Se handler for um callable, o callable será definido como o manipulador.

Se handler for uma string, ela pode ser o nome de um método de um objet definido com xml_set_object().

A assinatura do manipulador deve ser:

handler(XMLParser $parser, string $data): void

parser: O analisador XML que chama o manipulador.
data: Dados de caracteres como uma string.

O manipulador de dados de caracteres é chamado para cada parte de um texto no documento XML. Ele pode ser chamado várias vezes dentro de cada fragmento (por exemplo, para strings não ASCII).

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão	Descrição
8.0.0	O parâmetro `parser` agora espera uma instância de XMLParser; anteriormente, um resource `xml` válido era esperado.