xml_parser_set_option

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

    xml_parser_set_option — Define opções em um analisador XML

    Descrição

    xml_parser_set_option(XMLParser$parser, int$option, string|int|bool$value): bool

    Define uma opção em uma analisador XML.

    Parâmetros

    parser

    Uma referência ao analisador XML ao qual se deseja definir uma opção.

    option

    Qual a opção a definir. Veja abaixo.

    As opções a seguir estão disponíveis:

    Opções do analisador XML
    Constante da opçãoTipo de dadosDescrição
    XML_OPTION_CASE_FOLDINGbool Controla se case-folding está habilitado para este analisador XML. Ativado por padrão.
    XML_OPTION_SKIP_TAGSTARTinteger Especifica quantos caracteres devem ser ignorados no início do nome de uma etiqueta.
    XML_OPTION_SKIP_WHITEbool Controla se deve-se ignorar valores constituídos por espaços em branco.
    XML_OPTION_TARGET_ENCODINGstring Define qual codificação de destino será usada neste analisador XML. Por pradrão, é definida com a mesma codificação usada por xml_parser_create(). Codificações de destino suportadas são ISO-8859-1, US-ASCII e UTF-8.
    value

    O novo valor da opção.

    Valor Retornado

    Retorna true em caso de sucesso ou false em caso de falha.

    Erros/Exceções

    Lança uma exceção ValueError quando um valor inválido é passado em option.

    Antes do PHP 8.0.0, passar um valor inválido em option gerava um erro de nível E_WARNING e também fazia a função retornar false.

    Registro de Alterações

    VersãoDescrição
    8.3.0 O parâmetro value agora aceita booleanos. As opções XML_OPTION_CASE_FOLDING e XML_OPTION_SKIP_WHITE são agora opções booleanas.
    8.0.0 O parâmetro parser agora espera uma instância de XMLParser; anteriormente, um resourcexml válido era esperado.
    8.0.0 Uma exceção ValueError agora é lançada se option for inválido.
    To Top