mb_internal_encoding

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_internal_encoding Устанавливает или получает внутреннюю кодировку символов файла скрипта

Описание

mb_internal_encoding(?string $encoding = null): string|bool

Функция устанавливает или получает внутреннюю кодировку скрипта.

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

encoding

Параметр encoding — имя кодировки символов, в которую преобразуется кодировка входных данных HTTP-запроса, из которой преобразуется кодировка HTTP-вывода, а также это имя кодировки по умолчанию для функций модуля mbstring, которые работают со строками. Обратите внимание: внутренняя кодировка и кодировка для многобайтовых регулярных выражений — не одно и то же.

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

Если аргумент encoding установили, функция Возвращает true в случае успешного выполнения или false, если возникла ошибка. При этом кодировка символов для многобайтовых регулярных выражений не изменяется. Функция возвращает имя текущей внутренней кодировки символов, если аргумент encoding не установили.

Ошибки

Начиная с PHP 8.0.0 функция выбрасывает исключение ValueError, если в параметр encoding передали недопустимое значение кодировки. До PHP 8.0.0 вместо этого функция выдавала ошибку уровня E_WARNING.

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

Версия Описание
8.0.0 Теперь параметр encoding принимает значение null.
8.0.0 Теперь функция выбрасывает исключение ValueError, если в параметр encoding передали недопустимое значение кодировки. Раньше вместо этого функция выдавала ошибку уровня E_WARNING.

Примеры

Пример #1 Пример использования функции mb_internal_encoding()

<?php

/* Установка внутренней кодировки в UTF-8 */
mb_internal_encoding("UTF-8");

/* Вывод на экран текущей внутренней кодировки */
echo mb_internal_encoding();

?>

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

  • mb_http_input() - Определяет кодировку символов входных данных HTTP-запроса
  • mb_http_output() - Устанавливает или получает кодировку символов HTTP-вывода
  • mb_detect_order() - Устанавливает или получает порядок определения кодировки символов
  • mb_regex_encoding() - Устанавливает или получает кодировку символов для многобайтового регулярного выражения