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

lengthプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

『lengthプロパティは、Dom\CDATASectionオブジェクトが表現するCDATAセクションに含まれるテキストの文字数を保持するプロパティです。Dom\CDATASectionクラスは、XMLやHTMLドキュメント内で、HTMLタグのような特殊な文字を特別な意味を持つマークアップとして解釈させず、単なる文字列として扱うためのCDATAセクション(<![CDATA[...]]>)を表します。このlengthプロパティを参照することで、CDATAセクション内に記述されている文字列が何文字で構成されているかを簡単に取得できます。このプロパティは読み取り専用であり、プロパティ値を直接変更することはできません。実際のテキストデータが変更されると、lengthプロパティの値も自動的に更新されます。例えば、CDATAセクションの内容がシステムの要件で定められた文字数制限を超えていないかを検証する場合や、取得したテキストデータに対して何らかの処理を行う前の事前確認などに利用されます。なお、このプロパティは親クラスであるDom\CharacterDataから継承されたものであり、テキストやコメントなど、文字データを持つ他のDOMノードにも同様に存在します。』

構文(syntax)

1<?php
2
3$document = new \DOMDocument();
4$cdata = $document->createCDATASection('This is a sample CDATA content.');
5
6// The length property returns the number of characters.
7echo $cdata->length;

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

Dom\CDATASection::length は、CDATA セクションに含まれる文字数を整数(int)で返します。