【PHP8.x】lengthプロパティの使い方

lengthプロパティは、PHP 8のDom\Textクラスに属し、テキストノードの長さを保持するプロパティです。このプロパティは、PHPのDOM（Document Object Model）拡張機能の一部として提供され、XMLやHTMLドキュメントのツリー構造において、純粋なテキストコンテンツを表すDom\Textオブジェクトが持つテキストの長さを取得するために利用されます。

Dom\Textクラスのインスタンスは、例えばHTMLドキュメント内の段落タグ（<p>）の内部にある「こんにちは、世界！」といった文字列そのものをオブジェクトとして扱います。このlengthプロパティにアクセスすることで、そのテキスト文字列に含まれる文字の総数を、整数値（int型）として取得することができます。これは、テキストコンテンツの文字数を正確に把握したい場合に非常に役立ちます。

例えば、Webアプリケーションでユーザーが入力したテキストのバリデーション（入力されたテキストが長すぎないか確認するなど）や、表示領域に合わせてテキストを切り詰める処理を行う際に利用できます。このプロパティは読み取り専用であり、直接値を設定することはできません。Dom\Textオブジェクトのテキスト内容が変更されると、lengthプロパティの値は自動的に更新され、常に現在のテキストの長さを反映します。

Copy
1<?php
2$dom = new DOMDocument();
3$element = $dom->createElement('p');
4$textNode = $dom->createTextNode('これはサンプルテキストです。');
5$element->appendChild($textNode);
6$dom->appendChild($element);
7
8$textObject = $element->firstChild;
9
10echo $textObject->length;

引数なし

引数はありません

int

このプロパティは、ノードに含まれる文字数を整数（int）で返します。