xml_parser_create_ns

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

xml_parser_create_ns — Crée un analyseur XML

Description

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

xml_parser_create_ns() crée un nouvel analyseur XML avec le support des espaces de noms, et retourne une instance de XMLParser à utiliser avec les autres fonctions XML.

Liste de paramètres

encoding: Ce jeu de caractères est automatiquement détecté et, donc, le paramètre encoding ne spécifie plus que la sortie. Le jeu de caractères de sortie par défaut est UTF-8. Les jeux de caractères supportés sont ISO-8859-1, UTF-8 et US-ASCII.
separator: Avec un analyseur qui supporte les espaces de noms, les balises qui sont passées aux différentes fonctions de gestion seront constituées du nom de l'espace et du nom de balise, séparé par la chaîne seperator.

Valeurs de retour

Retourne une nouvelle instance de XMLParser.

Historique

Version	Description
8.0.0	Cette fonction retourne désormais une instance de XMLParser; auparavant, une resource était retournée, ou `false` si une erreur survient.
8.0.0	`encoding` est désormais nullable.

Voir aussi

xml_parser_create() - Création d'un analyseur XML
xml_parser_free() - Détruit un analyseur XML

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