# Dom\TokenList::replace

(PHP 8 >= 8.4.0)

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

### Beschreibung

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

Replaces a token in the list with another one.

### Parameter-Liste

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

### Rückgabewerte

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

### Fehler/Exceptions

- Wenn ein Token Null-Bytes enthält, wird ein ValueError ausgelöst.
- Wenn ein Token eine leere Zeichenkette ist, wird eine Dom\DOMException mit dem Code `Dom\SYNTAX_ERR` ausgelöst.
- Wenn ein Token ein ASCII-Leerzeichen enthält, wird eine Dom\DOMException mit dem Code `Dom\INVALID_CHARACTER_ERR` ausgelöst.

### Beispiele

Beispiel #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);
?>`

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

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

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