mb_convert_encoding

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

mb_convert_encodingKarakter kodlaması dönüşümü yapar

Açıklama

mb_convert_encoding(array|string $dizge, string $kodlamaya, array|string|null $kodlamadan = null): array|string|false

Belirtilen dizgenin karakter kodlamasını kodlamadan veya dahili kodlamadan kodlamaya dönüştürür. dizge olarak bir dizi verilmişse tüm dizge değerler sırayla dönüştürülür.

Bağımsız Değişkenler

dizge

Kodlaması dönüştürülecek dizge veya dizi.

kodlamaya

Dizgenin dönüştürüleceği kodlama.

kodlamadan

kodlamadan bağımsız değişkeninde, dizge kodlamasını algılamak için kullanılacak karakter kodlamaları bir dizi veya virgül ayraçlı liste olarak belirtilir. Doğru kodlama mb_detect_encoding() işlevinde kullanılan algoritma ile saptanmaya çalışılır.

kodlamadan null ise veya atlanmışsa mbstring.internal_encoding yönergesinin değeri, aksi takdirde default_charset değeri kullanılır.

kodlamaya ve kodlamadan bağımsız değişkenlerine aktarılabilecek geçerli değerler için Desteklenen Karakter Kodlamaları sayfasına bakılabilir.

Dönen Değerler

Kodlaması dönüştürülen dizge.

Hatalar/İstisnalar

PHP 8.0.0 ve sonrasında, kodlamaya veya kodlamadan geçersiz bir kodlama içeriyorsa bir ValueError yavrulanıyor. PHP 8.0.0 öncesinde sadece E_WARNING çıktılanırdı.

Sürüm Bilgisi

Sürüm: Açıklama
8.2.0 mb_convert_encoding() tarafından artık döndürülmeyen tek baytlık kodlamalar: "Base64", "QPrint", "UUencode", "HTML entities", "7 bit" ve "8 bit".
8.0.0 kodlamadan geçersiz bir kodlama içeriyorsa mb_convert_encoding() artık bir ValueError yavruluyor. Evvelce sadece E_WARNING çıktılanırdı.
8.0.0 kodlamaya geçersiz bir kodlama içeriyorsa mb_convert_encoding() artık bir ValueError yavruluyor. Evvelce sadece E_WARNING çıktılanırdı.
8.0.0 kodlamadan artık null olabiliyor.
7.2.0 İşlev dizge olarak artık dizi de kabul ediyor. Evvelce sadece dizge destekleniyordu.

Örnekler

Örnek 1 - mb_convert_encoding() örneği

<?php
/* Dahili karakter kodlamasını SJIS'e çevirelim */
$str = mb_convert_encoding($str, "SJIS");

/* EUC-JP'den UTF-7'ye dönüştürelim */
$str = mb_convert_encoding($str, "UTF-7", "EUC-JP");

/* Kodlamayı algılayarak JIS, eucjp-win, sjis-win, kodlamalarından
UCS-2LE'ye dönüşüm yaptıralım */
$str = mb_convert_encoding($str, "UCS-2LE", "JIS, eucjp-win, sjis-win");

/* mbstring.language değeri "Japanese" ise, "auto" değeri
* "ASCII,JIS,UTF-8,EUC-JP,SJIS" olarak genişletilir
*/
$str = mb_convert_encoding($str, "EUC-JP", "auto");
?>

Ayrıca Bakınız