DOMDocument::createComment

(PHP 5, PHP 7, PHP 8)

DOMDocument::createComment — Cria novo nó de comentárioe

Descrição

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

Esta função cria uma nova instância da classe DOMComment. Este nó não aparecerá no documento a menos que seja inserido, por exemplo, com DOMNode::appendChild().

Parâmetros

data: O conteúdo do comentário.

Valor Retornado

O novo DOMComment.

Registro de Alterações

Versão	Descrição
8.1.0	Em caso de erro, agora é lançada uma DomException. Anteriormente, `false` era retornado.

Veja Também

DOMNode::appendChild() - Adiciona um novo filho ao final dos filhos
DOMDocument::createAttribute() - Cria um novo attribute
DOMDocument::createAttributeNS() - Cria um novo nó de atributo com um namespace associado
DOMDocument::createCDATASection() - Cria um novo nó de CDATA
DOMDocument::createDocumentFragment() - Cria novo fragmento de documento
DOMDocument::createElement() - Cria novo nó de elemento
DOMDocument::createElementNS() - Cria novo nó de elemento com um namespace associado
DOMDocument::createEntityReference() - Cria novo nó de referência de entidade
DOMDocument::createProcessingInstruction() - Cria novo nó PI (Processing Instruction)
DOMDocument::createTextNode() - Cria novo nó de texto

Melhore Esta Página

Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema

＋adicione uma nota

Notas Enviadas por Usuários (em inglês) 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.

＋adicione uma nota