iconv

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

    iconv — Konvertiert eine Zeichenkette von einem Zeichensatz in einen anderen

    Beschreibung

    iconv(string$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 string verwendet wird.

    to_encoding

    Die gewünschte Kodierung des Ergebnisses.

    Wenn die Zeichenkette //TRANSLIT an to_encoding angehä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 //IGNORE angehängt wird, werden diese nicht darstellbaren Zeichen stillschweigend verworfen. Ansonsten wird eine E_NOTICE erzeugt und die Funktion gibt false zurück.

    Achtung

    Ob und wie //TRANSLIT genau funktioniert, hängt von der iconv()-Implementierung des Systems ab (vgl. ICONV_IMPL). Einige Implementierungen sind bekannt dafür, //TRANSLIT zu ignorieren, sodass die Umwandlung für Zeichen, die illegal für den Zeichensatz to_encoding sind, 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_encoding oder to_encoding vom aktuellen System nicht unterstützt wird, wird false zurückgegeben.

    Siehe auch

    To Top