UConverter::transcode

(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)

UConverter::transcode — Перетворює рядок з одного кодування символів на інший

Опис

public static UConverter::transcode(    string $str,    string $toEncoding,    string $fromEncoding,    ?array $options = null): string|false

Перетворює рядок strиз кодировкиfromEncodingвtoEncoding

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

str

Рядок (string) для перетворення.

toEncoding

Необхідне кодування результату.

fromEncoding

Поточне кодування рядка str

options

Необов'язковий масив (array), який може містити такі ключі:

• 'to_subst'- підстановочний символ, який використовується замість будь-якого символу рядкаstr, який не може бути закодований уtoEncoding. Якщо ключ вказано, він повинен представляти один символ у цільовому кодуванні.

Значення, що повертаються

Возвращает преобразованную строку или**false**в случае возникновения ошибки.

Приклади

Приклад #1 Перетворення з UTF-8 на UTF-16 і назад

Loading...
▶

Результат виконання наведеного прикладу:

005a006f00eb
5a6fc3ab

Приклад #2 Неприпустимі символи у вхідному рядку

Якщо вхідний рядок містить послідовність байтів, яка не є допустимою у кодуванні, зазначеній у fromEncoding, то перед преобразованием вtoEncodingона заменяется кодовой точкой Unicode U+FFFD (Заменяющий символ).

Loading...
▶

Результат виконання наведеного прикладу:

fffd

Приклад #3 Символи, які не можуть бути закодовані

Якщо вхідний рядок містить символи, які не можуть бути представлені у кодуванні toEncoding, вони замінюються одним символом. За замовчуванням символ залежить від кодування і може керуватися за допомогою параметра 'to_subst'

Loading...
▶

Результат виконання наведеного прикладу:

1a
3f
3f

Дивіться також

• mb_convert_encoding() - Перетворює рядок з одного кодування символів на інший
• iconv() - Перетворює рядок з одного кодування символів на інший