mb_substitute_character

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

mb_substitute_characterУстановить/получить символ замены

Описание

mb_substitute_character ( string|int|null $substitute_character = null ) : string|int|bool

Задаёт замещающий символ на случай, когда кодировка входных данных задана неверно или код символа не существует в кодировке выходных данных. Недопустимые символы могут быть заменены на "none" (нет вывода), строку (string) или числовое значение (int) (код символа Юникода).

Эта настройка влияет на поведение следующих функций: mb_convert_encoding(), mb_convert_variables(), mb_output_handler(), и mb_send_mail().

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

substitute_character

Задаёт значение Юникода в виде числа (int) или одной из следующих строк string:

  • "none" : нет вывода
  • "long" : код конечного (в выходной кодировке) символа (Пример: U+3000, JIS+7E7E)
  • "entity" : сущность конечного (в выходной кодировке) символа (Пример: Ȁ)

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

Если аргумент substitute_character задан, функция вернёт true в случае успеха, false в противном случае. Если substitute_character не задан, будет возвращена текущая настройка.

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

Версия Описание
8.0.0 Передача пустой строки в substitute_character больше не поддерживается; вместо этого используйте "none".
8.0.0 Теперь параметр encoding может принимать значение null.

Примеры

Пример #1 Пример использования mb_substitute_character()

<?php
/* Установка замещающего символа Unicode U+3013 (GETA MARK) */
mb_substitute_character(0x3013);

/* Задаём шестнадцатеричный формат */
mb_substitute_character("long");

/* Отображение текущей настройки */
echo mb_substitute_character();
?>

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top