<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.iconv" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>iconv</refname>

<refpurpose>Konvertiert eine Zeichenkette von einem Zeichensatz in einen anderen</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>string</type><type>false</type></type><methodname>iconv</methodname>

<methodparam><type>string</type><parameter>from_encoding</parameter></methodparam>

<methodparam><type>string</type><parameter>to_encoding</parameter></methodparam>

<methodparam><type>string</type><parameter>string</parameter></methodparam>

</methodsynopsis>

<para>

Diese Funktion konvertiert die Zeichenkette <parameter>string</parameter>

vom Zeichensatz <parameter>from_encoding</parameter> in den Zeichensatz

<parameter>to_encoding</parameter>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>from_encoding</parameter></term>

<listitem>

<para>

Die aktuelle Kodierung, die zur Interpretation von

<parameter>string</parameter> verwendet wird.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>to_encoding</parameter></term>

<listitem>

<para>

Die gewünschte Kodierung des Ergebnisses.

</para>

<para>

Wenn die Zeichenkette <literal>//TRANSLIT</literal> an

<parameter>to_encoding</parameter> 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 <literal>//IGNORE</literal> angehängt wird, werden diese

nicht darstellbaren Zeichen stillschweigend verworfen. Ansonsten wird

eine <constant>E_NOTICE</constant> erzeugt und die Funktion gibt

&false; zurück.

</para>

<caution>

<para>

Ob und wie <literal>//TRANSLIT</literal> genau funktioniert, hängt von

der iconv()-Implementierung des Systems ab (vgl.

<constant>ICONV_IMPL</constant>). Einige Implementierungen sind

bekannt dafür, <literal>//TRANSLIT</literal> zu ignorieren, sodass die

Umwandlung für Zeichen, die illegal für den Zeichensatz

<parameter>to_encoding</parameter> sind, vermutlich fehlschlägt.

</para>

</caution>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>string</parameter></term>

<listitem>

<para>

Die zu konvertierende Zeichenkette.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Gibt die konvertierte Zeichenkette zurück. &return.falseforfailure;

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title><function>iconv</function>-Beispiel:</title>

<programlisting role="php">

</programlisting>

&example.outputs.similar;

<screen>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<note>

<para>

Welche Zeichenkodierungen und Optionen verfügbar sind, hängt von der

installierten iconv-Implementierung ab. Wenn

<parameter>from_encoding</parameter> oder

<parameter>to_encoding</parameter> vom aktuellen System nicht unterstützt

wird, wird &false; zurückgegeben.

</para>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>mb_convert_encoding</function></member>

<member><methodname>UConverter::transcode</methodname></member>

</simplelist>

</para>

</refsect1>

</refentry>