xml_parser_set_option

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

xml_parser_set_option在 XML 解析器中设置选项

说明

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

在 XML 解析器中设置选项。

参数

parser

指向要设置选项的 XML 解析器。

option

要设置的选项。见下文。

以下选项可用:

XML 解析器选项
选项常量数据类型说明
XML_OPTION_CASE_FOLDINGbool 控制是否为此 XML 解析器启用大写转换。默认启用。
XML_OPTION_SKIP_TAGSTARTinteger 指定在标记名称的开头应略过多少个字符。
XML_OPTION_SKIP_WHITEbool 是否略过由空白字符组成的值。
XML_OPTION_TARGET_ENCODINGstring 设置要在此 XML 解析器中使用的目标编码。默认情况下,设置的编码与 xml_parser_create() 使用的源编码相同。支持的目标编码有 ISO-8859-1US-ASCIIUTF-8
value

选项的新值。

返回值

成功时返回 true,失败时返回 false

错误/异常

当传递到 option 的值无效时抛出 ValueError

在 PHP 8.0.0 之前,向 option 传递的值无效时会生成 E_WARNING 并使函数返回 false

更新日志

版本说明
8.3.0value 参数现在也接受 bool。选项 XML_OPTION_CASE_FOLDINGXML_OPTION_SKIP_WHITE 现在是 bool 选项。
8.0.0parser 现在接受 XMLParser 实例;之前接受有效的 xmlresource
8.0.0 如果 option 无效,现在抛出 ValueError
To Top