【PHP8.x】containsメソッドの使い方
containsメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
containsメソッドは、DOMTextクラスに属し、HTMLやXML文書内でテキスト内容を表現するDOMTextオブジェクトが、特定の文字列を含んでいるかどうかを判定するメソッドです。このメソッドは、指定されたDOMTextオブジェクトが保持するテキストデータの中に、引数として渡された検索文字列($needle)が存在するかどうかを確認します。
利用する際は、まずDOMTextオブジェクトのインスタンスを作成するか、既存の文書から取得します。そのDOMTextオブジェクトに対してcontainsメソッドを呼び出し、引数には検索したい文字列を指定します。例えば、あるテキストノードの内容が「Hello, World!」である場合に、contains('World')を実行するとtrueが返されます。しかし、contains('PHP')のように含まれない文字列で検索するとfalseが返されます。
このメソッドは、検索文字列が見つかった場合に真偽値trueを、見つからなかった場合にfalseを返します。この真偽値を活用することで、特定のキーワードやフレーズが含まれるテキスト要素を効率的に識別し、それに応じた処理をプログラムで実行できます。ウェブコンテンツのスクレイピングや文書解析など、HTML/XMLドキュメントのテキスト内容を扱う場面で非常に有用な機能です。
構文(syntax)
1<?php 2 3$dom = new DOMDocument(); 4$textNode = $dom->createTextNode('Hello, PHP DOM!'); 5$dom->appendChild($textNode); 6 7$isContained = $textNode->contains('PHP'); 8 9?>
引数(parameters)
DOMNode $other
- DOMNode $other: 比較対象となるDOMNodeオブジェクト
戻り値(return)
戻り値なし
戻り値はありません