- Справочник: PHP5.4

Описание

array get_html_translation_table ([ int $table = HTML_SPECIALCHARS [, int $quote_style = ENT_COMPAT [, string $charset_hint ]]] )

get_html_translation_table() возвращает таблицу преобразований, используемую функциями htmlspecialchars() и htmlentities() с кодировкой по умолчанию.

Замечание:
Специальные символы могут быть закодированы разными способами. Например, " может быть закодирован как ", " или &#x22. get_html_translation_table() возвращает только формы, используемые функциями htmlspecialchars() и htmlentities().

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

table

Существуют две новые константы (HTML_ENTITIES, HTML_SPECIALCHARS), позволяющие указать нужную таблицу преобразований.

quote_style

Аналогично функциям htmlspecialchars() и htmlentities() можно задать необязательный аргумент quote_style. Описание режимов этого параметра см. в описании функции htmlspecialchars().

charset_hint

Аналогично функции htmlentities(), данная функция принимает необязательный третий параметр charset, определяющий используемую при преобразовании кодировку. В настоящий момент по умолчанию используется ISO-8859-1.

Начиная с PHP 4.3.0 поддерживаются следующие кодировки.

**Поддерживаемые кодировки**
Кодировка	Псевдонимы	Описание
ISO-8859-1	ISO8859-1	Западно-европейская Latin-1
ISO-8859-15	ISO8859-15	Западно-европейская Latin-9. Добавляет знак евро, французские и финские буквы к кодировке Latin-1(ISO-8859-1).
UTF-8		8-битная Unicode, совместимая с ASCII.
cp866	ibm866, 866	Кириллическая кодировка, применяемая в DOS. Поддерживается в версии 4.3.2.
cp1251	Windows-1251, win-1251, 1251	Кириллическая кодировка, применяемая в Windows. Поддерживается в версии 4.3.2.
cp1252	Windows-1252, 1252	Западно-европейская кодировка, применяемая в Windows.
KOI8-R	koi8-ru, koi8r	Русская кодировка. Поддерживается в версии 4.3.2.
BIG5	950	Традиционный китайский, применяется в основном на Тайване.
GB2312	936	Упрощенный китайский, стандартная национальная кодировка.
BIG5-HKSCS		Расширенная Big5, применяемая в Гонг-Конге.
Shift_JIS	SJIS, 932	Японская кодировка.
EUC-JP	EUCJP	Японская кодировка.
''		Пустая строка активирует режим определения кодировки из файла скрипта (Zend multibyte), default_charset и текущей локали (см. nl_langinfo() и setlocale()), в указанном порядке. Не рекомендуется к использованию.

Замечание: Остальные кодировки не поддерживаются, вместо них будет применена кодировка по умолчанию и сгенерировано предупреждение.

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

Возвращает таблицу преобразований в виде массива.

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

Версия	Описание
5.3.4	Добавлен параметр `charset_hint`.

Примеры

Пример #1 Пример таблицы преобразований


<?php
$trans = get_html_translation_table(HTML_ENTITIES);
$str = "Hallo & <Frau> & Kr?mer";
$encoded = strtr($str, $trans);

echo $encoded;
?>

Результат выполнения данного примера:

Hallo &amp; &lt;Frau&gt; &amp; Kr&auml;mer

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

htmlspecialchars() - Преобразует специальные символы в HTML-сущности
htmlentities() - Преобразует все возможные символы в соответствующие HTML-сущности
html_entity_decode() - Преобразует все HTML-сущности в соответствующие символы