新しいエンティティ参照ノードを作成する

# DOMDocument::createEntityReference

(PHP 5, PHP 7)

DOMDocument::createEntityReference — 新しいエンティティ参照ノードを作成する

### 説明

public DOMDocument::createEntityReference ( string `$name` ) : DOMEntityReference

この関数は、DOMEntityReference クラスの新しいインスタンスを作成します。このノードは、( DOMNode::appendChild() などで) 挿入されない限り、ドキュメント内にあらわれません。

### パラメータ

`name`

  エンティティ参照の内容、つまり、エンティティ参照から 先頭の & および末尾の ; を取り除いたもの。

### 返り値

新しい DOMEntityReference、 あるいはエラーが発生した場合には `FALSE` を返します。

### エラー / 例外

`DOM_INVALID_CHARACTER_ERR`

  `name` が無効な文字を含んでいる場合に発生します。

### 参考

- DOMNode::appendChild() - 子要素群の最後に新しい子要素を追加する
- DOMDocument::createAttribute() - 新しい属性を作成する
- DOMDocument::createAttributeNS() - 関連付けられた名前空間に新しい属性を作成する
- DOMDocument::createCDATASection() - 新しい cdata ノードを作成する
- DOMDocument::createComment() - 新しい comment ノードを作成する
- DOMDocument::createDocumentFragment() - 新しい文書片を作成する
- DOMDocument::createElement() - 新しい要素ノードを作成する
- DOMDocument::createElementNS() - 関連付けられた名前空間に新しい要素を作成する
- DOMDocument::createProcessingInstruction() - 新しい PI ノードを作成する
- DOMDocument::createTextNode() - 新しいテキストノードを作成する