【PHP8.x】splitTextメソッドの使い方

splitTextメソッドは、PHPのDom\Textクラスに属し、既存のテキストノードを指定した位置で2つのテキストノードに分割するメソッドです。

このメソッドは、引数として整数値のoffsetを受け取ります。offsetは、テキストノード内の0から始まる文字インデックスであり、この位置でテキストが分割されます。具体的には、元のテキストノードはoffsetで指定された位置までの文字列を保持するように変更されます。そして、offset位置以降の残りの文字列を含む新しいDom\Textノードが生成され、この新しいノードがメソッドの戻り値として返されます。

例えば、「こんにちは世界」というテキストノードに対してoffsetに「5」を指定してsplitTextメソッドを呼び出すと、元のノードは「こんにちは」を保持するように変更され、「世界」という内容を持つ新しいテキストノードが返されます。この機能は、DOMツリー内の特定のテキスト部分にのみスタイルを適用したり、リンクを埋め込んだりするなど、テキストノードの一部を操作する必要がある場合に非常に役立ちます。

新しいテキストノードは、元のテキストノードの直後に自動的に挿入されるわけではないため、必要に応じて手動でDOMツリーに挿入する必要があります。offsetの値がテキストノードの長さを超える場合や負の値の場合には、エラーが発生する点に注意してください。

Copy
1<?php
2
3$textNode = new DOMDocument()->createTextNode('Original Text Content');
4$newTextNode = $textNode->splitText(8);
5
6?>

int $offset

• int $offset: 分割する位置を指定する整数

Dom\Text

splitTextメソッドは、指定したオフセット位置で現在のテキストノードを2つに分割します。分割された後、元のテキストノードにはオフセット位置までの文字列が残り、新しく作成されたDom\Textオブジェクトにオフセット位置以降の文字列が格納されて返されます。