PHP 8.4.1 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 になりました。

    参考

    Improve This Page

    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