xml_parser_create_ns

(PHP 4 >= 4.0.5, PHP 5, PHP 7)

xml_parser_create_ns — Create an XML parser with namespace support

Descrierea

xml_parser_create_ns ( string|null $encoding = null , string $separator = ":" ) : XMLParser

xml_parser_create_ns() creates a new XML parser with XML namespace support and returns a XMLParser instance to be used by the other XML functions.

Parametri

encoding: The input encoding is automatically detected, so that the encoding parameter specifies only the output encoding. In PHP 5.0.0 and 5.0.1, the default output charset is ISO-8859-1, while in PHP 5.0.2 and upper is UTF-8. The supported encodings are ISO-8859-1, UTF-8 and US-ASCII.
separator: With a namespace aware parser tag parameters passed to the various handler functions will consist of namespace and tag name separated by the string specified in separator.

Valorile întoarse

Returns a new XMLParser instance.

Istoricul schimbărilor

Versiune	Descriere
8.0.0	This function returns an XMLParser instance now; previously, a resource was returned, sau `false` în cazul eșecului.
8.0.0	`encoding` is nullable now.

A se vedea și

xml_parser_create() - Create an XML parser
xml_parser_free() - Free an XML parser

add a note

User Contributed Notes 2 notes

down

jonnyNO at SPAM dot sanriowasteland dot net ¶

22 years ago


This is from the Expat Function Reference by Clark Cooper, which is a reference to the C api.   

"XML_Parser XML_ParserCreateNS(const XML_Char*encoding, XML_Char sep)
Constructs a new parser that has namespace processing in effect. Namespace expanded element names and attribute names are returned as a concatenation of the namespace URI, sep, and the local part of the name. This means that you should pick a character for sep that can't be part of a legal URI."

(from http://www.xml.com/pub/a/1999/09/expat/reference.html)

So thats what this function is for.  Now you know.

down

bishop at php dot net ¶

5 years ago


Internals has proposed[1] changing this extension from resource-based to object-based. When this change is made, xml_parser_create_ns will return an object, not a resource. Application developers are encouraged to replace any checks for explicit success, like:

<?php
$res = xml_parser_create_ns(/*...*/);
if (! is_resource($res)) {
    // ...
}
?>

With a check for explicit failure:
<?php
$res = xml_parser_create_ns(/*...*/);
if (false === $res) {
    // ...
}

[1]: https://marc.info/?l=php-internals&m=154998365013373&w=2

add a note