【PHP8.x】DOMProcessingInstruction::isDefaultNamespace()メソッドの使い方
isDefaultNamespaceメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
『isDefaultNamespaceメソッドは、引数で指定された名前空間URIが、対象となるノードにおけるデフォルトの名前空間であるかどうかを判定する処理を実行するメソッドです。このメソッドは、DOMProcessingInstructionクラスが親クラスであるDOMNodeから継承したものです。XML文書では、xmlns="http://example.com/default"のように接頭辞を付けずに名前空間を宣言することができ、これをデフォルトの名前空間と呼びます。isDefaultNamespaceメソッドは、あるノードがそのようなデフォルトの名前空間のスコープ内に存在するかどうかを確認するために使用されます。引数には、判定したい名前空間の一意な識別子であるURIを文字列として渡します。メソッドの実行結果として、指定されたURIがそのノードのデフォルトの名前空間であればtrueを、そうでなければfalseを返します。主にXML要素のコンテキストで名前空間を判定する際に役立つ機能ですが、DOMProcessingInstructionクラスのインスタンスからも呼び出すことが可能です。
構文(syntax)
1<?php 2 3$document = new DOMDocument(); 4$document->loadXML('<?xml version="1.0"?><?php-instruction value?>'); 5 6/** @var DOMProcessingInstruction $pi */ 7$pi = $document->firstChild; 8 9$namespaceURI = 'http://www.w3.org/2000/xmlns/'; 10 11$result = $pi->isDefaultNamespace($namespaceURI); 12 13?>
引数(parameters)
string $namespace
- string $namespace: チェック対象の namespace URI を指定する文字列
戻り値(return)
bool
このメソッドは、指定された名前空間がノードのデフォルト名前空間であるかどうかを判定し、真偽値(true または false)を返します。