mb_substitute_character

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

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

Описание

mb_substitute_character ([ mixed $substchar = mb_substitute_character() ] ) : mixed

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

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

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

substchar

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

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

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

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

Примеры

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

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

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

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