iconv
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
iconv — Konvertiert eine Zeichenkette von einem Zeichensatz in einen anderen
Beschreibung
$from_encoding, string $to_encoding, string $string): string|false
Diese Funktion konvertiert die Zeichenkette string
vom Zeichensatz from_encoding in den Zeichensatz
to_encoding.
Parameter-Liste
-
from_encoding -
Die aktuelle Kodierung, die zur Interpretation von
stringverwendet wird. -
to_encoding -
Die gewünschte Kodierung des Ergebnisses.
Wenn die Zeichenkette
//TRANSLITanto_encodingangehängt wird, wird die Transliteration aktiviert. Das bedeutet, dass ein Zeichen, das im Zielzeichensatz nicht dargestellt werden kann, mit einem oder mehreren ähnlich aussehenden Zeichen annähernd dargestellt werden darf. Wenn die Zeichenkette//IGNOREangehängt wird, werden diese nicht darstellbaren Zeichen stillschweigend verworfen. Ansonsten wird eineE_NOTICEerzeugt und die Funktion gibtfalsezurück.AchtungOb und wie
//TRANSLITgenau funktioniert, hängt von der iconv()-Implementierung des Systems ab (vgl.ICONV_IMPL). Einige Implementierungen sind bekannt dafür,//TRANSLITzu ignorieren, sodass die Umwandlung für Zeichen, die illegal für den Zeichensatzto_encodingsind, vermutlich fehlschlägt. -
string -
Die zu konvertierende Zeichenkette.
Rückgabewerte
Gibt die konvertierte Zeichenkette zurück. Bei einem Fehler wird false zurückgegeben.
Beispiele
Beispiel #1 iconv()-Beispiel:
<?php
$text = "Das ist das Euro-Symbol: '€'.";
echo 'Original : ', $text, PHP_EOL;
echo 'Mit TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'Mit IGNORE : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Ohne Zusatz : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Original : Das ist das Euro-Symbol: '€'. Mit TRANSLIT : Das ist das Euro-Symbol: 'EUR'. Mit IGNORE : Das ist das Euro-Symbol: ''. Ohne Zusatz : Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7
Anmerkungen
Hinweis:
Welche Zeichenkodierungen und Optionen verfügbar sind, hängt von der installierten iconv-Implementierung ab. Wenn
from_encodingoderto_encodingvom aktuellen System nicht unterstützt wird, wirdfalsezurückgegeben.
Siehe auch
- mb_convert_encoding() - Convert a string from one character encoding to another
- UConverter::transcode() - Convert a string from one character encoding to another
