array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.xml-parser-set-option.php', 1 => 'xml_parser_set_option', ), 'up' => array ( 0 => 'ref.xml.php', 1 => 'XML Parser Functions', ), 'prev' => array ( 0 => 'function.xml-parser-get-option.php', 1 => 'xml_parser_get_option', ), 'next' => array ( 0 => 'function.xml-set-character-data-handler.php', 1 => 'xml_set_character_data_handler', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/xml/functions/xml-parser-set-option.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
xml_parser_set_option — Set options in an XML parser
Sets an option in an XML parser.
parser
A reference to the XML parser to set an option in.
option
Which option to set. See below.
The following options are available:
Option constant | Data type | Description |
---|---|---|
XML_OPTION_CASE_FOLDING |
bool | Controls whether case-folding is enabled for this XML parser. Enabled by default. |
XML_OPTION_SKIP_TAGSTART |
integer | Specify how many characters should be skipped in the beginning of a tag name. |
XML_OPTION_SKIP_WHITE |
bool | Whether to skip values consisting of whitespace characters. |
XML_OPTION_TARGET_ENCODING |
string |
Sets which target encoding to
use in this XML parser.By default, it is set to the same as the
source encoding used by xml_parser_create().
Supported target encodings are ISO-8859-1 ,
US-ASCII and UTF-8 .
|
value
The option's new value.
Throws a ValueError when an invalid value is passed
to option
.
Prior to PHP 8.0.0, the function returned false when passing an invalid
value to
option
generated a E_WARNING
as well as making the function return false
.
Version | Description |
---|---|
8.3.0 |
The value parameter now also accepts booleans.
The options XML_OPTION_CASE_FOLDING and XML_OPTION_SKIP_WHITE
are now boolean options.
|
8.0.0 |
parser expects an XMLParser
instance now; previously, a valid xml resource was expected.
|
8.0.0 |
A ValueError is now thrown if
option is invalid.
|