mb_convert_variables

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

mb_convert_variables — Преобразовывает символы в переменной(-ых) из одной кодировки в другую

Описание

mb_convert_variables(
    string $to_encoding,
    array|string $from_encoding,
    mixed &$var,
    mixed &...$vars
): string|false

Конвертирует символы в переменных var и vars из кодировки, указанной в параметре from_encoding, в кодировку, указанную в параметре to_encoding.

Функция mb_convert_variables() объединяет строки из массива или объекта для определения их кодировки, так как в случае коротких строк определить кодировку часто не удаётся. Поэтому недопустимо помещать в один массив или объект строки в разных кодировках.

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

to_encoding: Кодировка, в которую необходимо перекодировать строку (string).
from_encoding: Параметр from_encoding задаётся в виде массива (array) или строки (string) с разделёнными запятой кодировками, функция попытается определить кодировку исходной строки на основе списка кодировок, заданных в параметре from-coding. Если параметр from_encoding не задан, будет выбрана кодировка, из INI-директивы с именем detect_order.
var: Параметр var — это ссылка на переменную, которую нужно преобразовать. Это может быть строка (string), массив (array) или объект (object). Функция mb_convert_variables() предполагает, что для всех параметров задана одинаковая кодировка.
vars: Дополнительные var.

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

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

Примеры

Пример #1 Пример использования функции mb_convert_variables()

<?php
/* Преобразование переменных $post1, $post2 во внутреннюю кодировку скрипта */
$interenc = mb_internal_encoding();
$inputenc = mb_convert_variables($interenc, "ASCII,UTF-8,SJIS-win", $post1, $post2);
?>

add a note

User Contributed Notes 2 notes

down

ryosuke_i_628 at yahoo dot co dot jp ¶

10 years ago


This function has a bug on recursion detection.
https://bugs.php.net/bug.php?id=66964

down

ivan dot plotnikov at corp dot oft-e dot com ¶

8 years ago


Last version of this function (php 5.6.27 and php7.0.12) have a bug
https://bugs.php.net/bug.php?id=73407

add a note