DOMDocument::createComment

(PHP 5, PHP 7, PHP 8)

DOMDocument::createComment — Crea un nuevo nodo de comentario

Descripción

public function DOMDocument::createComment(string $data): DOMComment

Esta función crea una nueva instancia de la clase DOMComment . Este nodo no será mostrado en el documento, a menos que sea insertado con DOMNode::appendChild() .

Parámetros

data: El contenido del comentario.

Valores devueltos

El nuevo DOMComment .

Historial de cambios

Versión	Descripción
8.1.0	En caso de error, una DomException es lanzada ahora. Anteriormente, `false` era devuelto.

Véase también

DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
DOMDocument::createAttribute() - Crea un nuevo atributo
DOMDocument::createAttributeNS() - Crea un nuevo atributo con un espacio de nombres asociado
DOMDocument::createCDATASection() - Crea un nuevo nodo cdata
DOMDocument::createDocumentFragment() - Crea un nuevo fragmento de documento
DOMDocument::createElement() - Crea un nuevo nodo elemento
DOMDocument::createElementNS() - Crea un nuevo nodo elemento con el nombre de espacio asociado
DOMDocument::createEntityReference() - Create new entity reference node
DOMDocument::createProcessingInstruction() - Crea un nuevo nodo PI
DOMDocument::createTextNode() - Crea un nuevo nodo de texto

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 1 note

down

php dot sirlancelot at spamgourmet dot com ¶

16 years ago

To prevent a parser error when the comment string would contain the character sequence "--", do this:
<?php
$CommentString = 'This contains -- some weird -- characters.';
$CommentNode = $DomDocument->createComment(
 str_replace('--', '-'.chr(194).chr(173).'-', $CommentString)
);
?>

This will insert a Soft Hyphen in between the two hyphens which will not cause the parser to error out.

+add a note