PHP 8.4.2 Released!

DOMCharacterData::before

(PHP 8)

DOMCharacterData::beforeAdiciona nós antes dos dados de caracteres

Descrição

public DOMCharacterData::before(DOMNode|string ...$nodes): void

Adiciona os nós informados em nodes antes dos dados de caracteres.

Parâmetros

nodes

Nós a serem adicionados antes do nó. Strings são automaticamente convertidas em nós de texto.

Valor Retornado

Nenhum valor é retornado.

Erros/Exceções

DOM_HIERARCHY_REQUEST_ERR

Emitido se o pai é de um tipo que não permite filhos do tipo de um dos nodes informados, ou se o nó a ser inserido é um dos ancestrais deste nó, ou este próprio nó.

DOM_WRONG_DOCUMENT_ERR

Emitido se um dos nodes informados foi criado a partir de um documento diferente daquele que criou este nó.

Registro de Alterações

Versão Descrição
8.3.0 Chamar este método em um nó sem pai agora é uma operação sem efeito para alinhar o comportamento com a especificação do DOM. Anteriormente, era lançada uma exceção DOMException com código DOM_HIERARCHY_REQUEST_ERR.

Exemplos

Exemplo #1 Exemplo de DOMCharacterData::before()

Adiciona nós antes dos dados de caracteres.

<?php
$doc
= new DOMDocument;
$doc->loadXML("<container><![CDATA[world]]></container>");
$cdata = $doc->documentElement->firstChild;

$cdata->before("hello", $doc->createElement("beautiful"));

echo
$doc->saveXML();
?>

O exemplo acima produzirá:

<?xml version="1.0"?>
<container>hello<beautiful/><![CDATA[world]]></container>

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top