Задание/получение символа заместителя


(PHP 4 >= 4.0.6, PHP 5)

mb_substitute_characterЗадание/получение символа заместителя

Описание

mixed mb_substitute_character ([ mixed $substrchar = mb_substitute_character() ] )

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

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

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

substrchar

Задает значение Юникода в виде числа 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();
?>