DOMDocument::createComment

(PHP 5)

DOMDocument::createCommentساخت گره توضیح جدید

Description

DOMComment DOMDocument::createComment ( string $data )

این تابع نمونه جدید کلاس DOMComment را می‌سازد. This node will not show up in the document unless it is inserted with (e.g.) DOMNode->appendChild().

Parameters

data

محتوای توضیح.

Return Values

DOMComment جدید یا FALSE اگر خطا رخ داده باشد.

See Also

add a note add a note

User Contributed Notes 2 notes

up
0
php dot sirlancelot at spamgourmet dot com
4 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.
up
0
capps at solareclipse dot net
7 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.
To Top