PHP 8.4.2 Released!

    xml_parser_create_ns

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

    xml_parser_create_ns — 名前空間をサポートした XML パーサを生成する

    説明

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

    xml_parser_create_ns() は XML 名前空間をサポートした 新しい XML パーサを作成し、他の XML 関数が使用する XMLParser インスタンスを返します。

    パラメータ

    encoding

    入力のエンコーディングは 自動判定されるので、encoding パラメータは 出力のエンコーディングのみを指定することになります。 デフォルトの出力文字セットは UTF-8 です。 サポートされるエンコーディングは ISO-8859-1、UTF-8 および US-ASCII です。

    separator

    名前空間を含めたタグパラメータをハンドラ関数に渡す際には、 名前空間名とタグ名を文字列 separator でつなげたものが使用されます。

    戻り値

    新しい XMLParser のインスタンスを返します。

    変更履歴

    バージョン 説明
    8.0.0 この関数は XMLParser のインスタンスを返すようになりました。 これより前のバージョンでは、リソースが返され、失敗した場合は false が返されていました。
    8.0.0 encoding は、 nullable になりました。

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    2
    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.
    up
    0
    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
    To Top