# Dom\TokenList::replace

(PHP 8 >= 8.4.0)

Dom\TokenList::replace — Replaces a token in the list with another one

### 说明

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

Replaces a token in the list with another one.

### 参数

`token`
  The token to replace.
`newToken`
  The new token.

### 返回值

Returns `true` if `token` was in the list, `false` otherwise.

### 错误／异常

- 如果 token 包含 null 字节，抛出 ValueError。
- 如果 token 是空字符串，抛出 code 为 `Dom\SYNTAX_ERR` 的 Dom\DOMException。
- 如果 token 包含 ASCII 空格，抛出 code 为 `Dom\INVALID_CHARACTER_ERR` 的 Dom\DOMException。

### 示例

示例 #1 Dom\TokenList::replace() example

Replaces a token in the paragraph with another one.

`<?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>

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open