(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
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();
?>