mb_substitute_character
(PHP 4 >= 4.0.6, PHP 5, PHP 7)
mb_substitute_character — Установить/получить символ замены
Описание
$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();
?>