array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.get-html-translation-table.php', 1 => 'get_html_translation_table', 2 => 'Retorna a tabela de tradução usada por htmlspecialchars e htmlentities', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.fprintf.php', 1 => 'fprintf', ), 'next' => array ( 0 => 'function.hebrev.php', 1 => 'hebrev', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/get-html-translation-table.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

get_html_translation_table

(PHP 4, PHP 5, PHP 7, PHP 8)

get_html_translation_table — Retorna a tabela de tradução usada por htmlspecialchars() e htmlentities()

Descrição

get_html_translation_table(int $table = HTML_SPECIALCHARS, int $flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401, string $encoding = "UTF-8"): array

get_html_translation_table() retorna a tabela de tradução usada internamente para htmlspecialchars() e htmlentities().

Nota:

Caracteres especiais podem ser codificados de diversas maneiras. Por exemplo, " pode ser codificado como ", " ou &#x22. get_html_translation_table() retorna apenas a forma usada por htmlspecialchars() e htmlentities().

Parâmetros

table

Informa que tabela deve ser retornada. Pode ser HTML_ENTITIES ou HTML_SPECIALCHARS.

flags

Uma máscara de bits de uma ou mais das opções abaixo, que especificam que tipo de aspas a tabela conterá, assim como para que tipo de documento a tabela serve. O padrão é ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.
Constantes de flags disponíveis
Nome da Constante Descrição
ENT_COMPAT A tabela conterá entidades para aspas duplas, mas não para aspas simples.
ENT_QUOTES A tabela conterá entitades tanto para aspas duplas quanto para aspas simples.
ENT_NOQUOTES A tabela não conterá entidades nem para aspas simples nem para aspas duplas.
ENT_SUBSTITUTE Substitui sequências de unidade de código inválidas com um Caractere de Substituição Unicode U+FFFD (UTF-8) ou � ao invés de retornar uma string vazia.
ENT_HTML401 Tabela para HTML 4.01.
ENT_XML1 Tabela para XML 1.
ENT_XHTML Tabela para XHTML.
ENT_HTML5 Tabela para HTML 5.

encoding

A codificação a ser usada. Se omitida, o valor padrão para este argumento é UTF-8.

Os seguintes conjuntos de caracteres são suportados:
Conjuntos de caracteres suportados
Conjunto de caracteres Apelidos Descrição
ISO-8859-1 ISO8859-1 Western European, Latin-1.
ISO-8859-5 ISO8859-5 Conjunto de caracteres cirílicos, pouco usado (latim/cirílico).
ISO-8859-15 ISO8859-15 Western European, Latin-9. Adiciona o símbolo do Euro, letras francesas e finlandesas faltantes no Latin-1 (ISO-8859-1).
UTF-8   Código de multi-byte 8-bits Unicode compatível com ASCII.
cp866 ibm866, 866 Conjunto de caracteres do DOS específico para o russo.
cp1251 Windows-1251, win-1251, 1251 Conjunto de caracteres do Windows específico para o russo.
cp1252 Windows-1252, 1252 Conjunto de caracteres do Windows específico para a Europa Ocidental.
KOI8-R koi8-ru, koi8r Russo.
BIG5 950 Chinês tradicional, usado principalmente em Taiwan.
GB2312 936 Chinês simplificado, conjunto de caracteres padrão nacional.
BIG5-HKSCS   Big5 com extensões de Hong Kong, chinês tradicional.
Shift_JIS SJIS, SJIS-win, cp932, 932 Japonês
EUC-JP EUCJP, eucJP-win Japonês
MacRoman   Conjunto de caracteres que era usado pelo Mac OS.
''   Uma string vazia ativa a detecção a partir de codificação de script (multibyte Zend), conjunto padrão de caracteres e localidade atual (consulte nl_langinfo() e setlocale()), nesta ordem. Não recomendado.

Nota: Nenhum outro conjunto de caracteres é reconhecido. A codificação padrão será usada no lugar e um alerta será emitido.

Valor Retornado

Retorna a tabela de tradução como um array, com os caracteres originais como chaves e as entidades como valores.

Registro de Alterações

Versão Descrição
8.1.0 flags mudou de ENT_COMPAT para ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

Exemplos

Exemplo #1 Exemplo de Tabela de Tradução

<?php
var_dump(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES | ENT_HTML5));
?>

O exemplo acima produzirá algo semelhante a:

array(1510) {
  ["
"]=>
  string(9) "&NewLine;"
  ["!"]=>
  string(6) "&excl;"
  ["""]=>
  string(6) "&quot;"
  ["#"]=>
  string(5) "&num;"
  ["$"]=>
  string(8) "&dollar;"
  ["%"]=>
  string(8) "&percnt;"
  ["&"]=>
  string(5) "&amp;"
  ["'"]=>
  string(6) "&apos;"
  // ...
}

Veja Também