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+3000JIS+7E7E) .«entity»: сутність кінцевого (у вихідному кодуванні) символу (Приклад:Ȁ) .
Значення, що повертаються
Якщо аргумент substitute_character заданий, функція поверне true у разі успішного виконання, інакше false. Якщо символ substitute_character не встановлено, буде повернуто поточне налаштування.
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | Передача порожнього рядка до параметра substitute_character більше не підтримується; натомість необхідно передавати «none» |
| 8.0.0 | Тепер параметр encoding може набувати значення null |
Приклади
Приклад #1 Приклад використання функції mb_substitute_character()****