Edit Report a Bug

    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