DOMDocument::createComment

(PHP 5, PHP 7, PHP 8)

DOMDocument::createComment — Crée un nouveau nœud de commentaire

Description

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

Cette fonction crée une nouvelle instance de la classe DOMComment. Ce nœud ne sera pas affiché dans le document, à moins qu'il ne soit inséré avec DOMNode::appendChild().

Liste de paramètres

data: Le contenu du commentaire.

Valeurs de retour

Le nouveau DOMComment.

Historique

Version	Description
8.1.0	En cas d'erreur, une DomException est désormais lancée. Auparavant, `false` était retourné.

Voir aussi

DOMNode::appendChild() - Ajoute un nouveau fils à la fin des fils
DOMDocument::createAttribute() - Crée un nouvel attribut
DOMDocument::createAttributeNS() - Crée un nouvel attribut avec un espace de noms associé
DOMDocument::createCDATASection() - Crée un nouveau nœud cdata
DOMDocument::createDocumentFragment() - Crée un nouveau fragment de document
DOMDocument::createElement() - Crée un nouveau nœud
DOMDocument::createElementNS() - Crée un nouveau nœud avec un espace de noms associé
DOMDocument::createEntityReference() - Crée un nouveau nœud de référence d'entité
DOMDocument::createProcessingInstruction() - Crée un nouveau nœud PI
DOMDocument::createTextNode() - Crée un nouveau nœud de texte

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 ¶

15 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