[edit] Last updated: Fri, 24 May 2013

DOMDocument::createComment

(PHP 5)

DOMDocument::createComment — Crea un nuevo nodo de comentario

Descripción

DOMComment DOMDocument::createComment ( string $data )

Esta función crea una nueva instancia de la clase DOMComment. Este nodo no se mostrará en el documento a no ser que sea insertado con (p.e.j.) DOMNode::appendChild().

Parámetros

data: El contenido del comentario.

Valores devueltos

El nuevo DOMComment o FALSE si ha ocurrido un error.

Ver también

DOMNode::appendChild() - Añade un nuevo hijo al final de los hijos
DOMDocument::createAttribute() - Crear nuevo attribute
DOMDocument::createAttributeNS() - Crea un nuevo nodo atributo con un namespace 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

add a note User Contributed Notes DOMDocument::createComment - [2 notes]

down

php dot sirlancelot at spamgourmet dot com ¶

3 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.

down

capps at solareclipse dot net ¶

6 years ago


Use caution: this function does NOT escape, encode, or otherwise change the contents of the string.



This means that if your string contains two hyphens in a row (--), that will *end* the comment, which can easily create invalid XML when the document is serialized.

add a note