DOMDocument::createComment

(PHP 5, PHP 7, PHP 8)

DOMDocument::createComment — Создать новый узел комментария

Описание

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

Эта функция создаёт новый экземпляр класса DOMComment. Этот узел не будет отображаться в документе до тех пор, пока он не будет вставлен, например, функцией DOMNode::appendChild().

Список параметров

data: Содержимое комментария.

Возвращаемые значения

Новый объект класса DOMComment.

Список изменений

Версия	Описание
8.1.0	В случае возникновения ошибки теперь выбрасывает исключение DomException. Ранее вместо этого возвращалось значение `false`.

Смотрите также

DOMNode::appendChild() - Добавляет новый дочерний узел в конец списка потомков
DOMDocument::createAttribute() - Создаёт новый атрибут
DOMDocument::createAttributeNS() - Создаёт новый атрибут узла с соответствующим пространством имён
DOMDocument::createCDATASection() - Создаёт новый узел cdata
DOMDocument::createDocumentFragment() - Создаёт новый фрагмент документа
DOMDocument::createElement() - Создаёт новый узел элемента
DOMDocument::createElementNS() - Создать новый узел элемента с соответствующим пространством имён
DOMDocument::createEntityReference() - Создать новый узел ссылки на сущность
DOMDocument::createProcessingInstruction() - Создать новый PI-узел
DOMDocument::createTextNode() - Создать новый текстовый узел

Улучшение страницы

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 1 note

down

php dot sirlancelot at spamgourmet dot com ¶

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

＋Добавить