Dom\TokenList::replace

(PHP 8 >= 8.4.0)

Dom\TokenList::replace — リスト中のトークンを別のものに置き換える

説明

public function Dom\TokenList::replace(string $token, string $newToken): bool

リスト中のトークンを別のものに置き換えます。

パラメータ

token: 置き換えるトークン
newToken: 新しいトークン

戻り値

token がリスト中に存在した場合は true を返します。存在しない場合は、false を返します。

エラー / 例外

トークンが NULL バイトを含んでいる場合、 ValueError をスローします。
トークンが空文字列である場合、エラーコード Dom\SYNTAX_ERR を持つ Dom\DOMException をスローします。
トークンが ASCII の空白文字を含む場合、エラーコード Dom\INVALID_CHARACTER_ERR を持つ Dom\DOMException をスローします。

例

例1 Dom\TokenList::replace() の例

パラグラフ中のトークンを別のものに置き換えます

<?php
$dom = Dom\HTMLDocument::createFromString('<p class="font-bold important"></p>', LIBXML_NOERROR);
$p = $dom->body->firstChild;

$p->classList->replace('font-bold', 'font-small');

echo $dom->saveHtml($p);
?>

上の例の出力は以下となります。

<p class="font-small important"></p>

関連キーワード:

トークン TokenList replace font token newToken エラーコード DOMException bold important small remove supports バイト ValueError 空白パラグラフ HTMLDocument createFromString body firstChild classList saveHtml