Заменяет одну лексему в списке на другую

# Dom\TokenList::replace

(PHP 8 >= 8.4.0)

Dom\TokenList::replace — Заменяет одну лексему в списке на другую

### Описание

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

Заменяет одну лексему в списке на другую.

### Список параметров

`token`
  Лексему для замены.
`newToken`
  Новая лексема.

### Возвращаемые значения

Возвращает значение `true`, если лексема `token` была в списке, в противном случае возвращает значение `false`.

### Ошибки

- Выбрасывает ошибку ValueError, если токен содержит нулевые байты.
- Выбрасывает исключение Dom\DOMException с кодом `Dom\SYNTAX_ERR`, если лексема является пустой строкой.
- Выбрасывает исключение Dom\DOMException с кодом `Dom\INVALID_CHARACTER_ERR`, если лексема содержит любой пробел ASCII. ASCII whitespace.

### Примеры

Пример #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>

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