【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)

戻り値なし

戻り値はありません

関連コンテンツ

関連プログラミング言語

【PHP8.x】containsメソッドの使い方 | いっしー@Webエンジニア