<HTML ><HEAD ><TITLE >iconv functions</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Function Reference" HREF="funcref.html"><LINK REL="PREVIOUS" TITLE="hw_api->userlist" HREF="function.hwapi-userlist.html"><LINK REL="NEXT" TITLE="iconv_get_encoding" HREF="function.iconv-get-encoding.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="reference" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.hwapi-userlist.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.iconv-get-encoding.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="reference" ><A NAME="ref.iconv" ></A ><DIV CLASS="TITLEPAGE" ><H1 CLASS="title" >XL. iconv functions</H1 ><DIV CLASS="PARTINTRO" ><A NAME="AEN33274" ></A ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.intro" ></A >Introduction</H1 ><P > This module contains an interface to the iconv library functions. The iconv library functions convert strings between various character sets encodings. The supported character sets depend on the iconv() implementation on your system. Note that the iconv() function on some systems may not work as well as you expect. In this case, you should install the libiconv library. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.requirements" ></A >Requirements</H1 ><P > Your systems standard C library must provide the iconv() function or you must have libiconv installed on your system. The libiconv library is available from <A HREF="http://www.gnu.org/software/libiconv/" TARGET="_top" >http://www.gnu.org/software/libiconv/</A >. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.installation" ></A >Installation</H1 ><P > To be able to use the functions defined in this module you must compile your PHP interpreter using the configure line <TT CLASS="option" >--with-iconv[=DIR]</TT >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note to Win32 Users: </B > In order to enable this module on a Windows environment, you must copy <SPAN CLASS="emphasis" ><I CLASS="emphasis" >iconv-1.3.dll</I ></SPAN > from the DLL folder of the PHP/Win32 binary package to the SYSTEM32 folder of your windows machine. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32). Starting with PHP 4.2.1 the name changed to <SPAN CLASS="emphasis" ><I CLASS="emphasis" >iconv.dll</I ></SPAN > </P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.configuration" ></A >Runtime Configuration</H1 ><P > The behaviour of these functions is affected by settings in <TT CLASS="filename" >php.ini</TT >. </P ><P > <DIV CLASS="table" ><A NAME="AEN33296" ></A ><P ><B >Table 1. Iconv configuration options</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Name</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Default</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Changeable</TH ></TR ></THEAD ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >iconv.input_encoding</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ICONV_INPUT_ENCODING</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >iconv.output_encoding</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ICONV_OUTPUT_ENCODING</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >iconv.internal_encoding</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ICONV_INTERNAL_ENCODING</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ></TBODY ></TABLE ></DIV > For further details and definition of the PHP_INI_* constants see <A HREF="function.ini-set.html" ><B CLASS="function" >ini_set()</B ></A >. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.resources" ></A >Resource Types</H1 ><P >This extension has no resource types defined.</P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.constants" ></A >Predefined Constants</H1 ><P > Since PHP 4.3.0 it is possible to identify at runtime which iconv implementation is adopted by this extension. <DIV CLASS="table" ><A NAME="AEN33324" ></A ><P ><B >Table 2. iconv constants</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH ALIGN="LEFT" VALIGN="MIDDLE" >constant</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >type</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >description</TH ></TR ></THEAD ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ICONV_IMPL</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" ><A HREF="language.types.string.html" >string</A ></TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >The implementation name</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >ICONV_VERSION</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" ><A HREF="language.types.string.html" >string</A ></TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >The implementation version</TD ></TR ></TBODY ></TABLE ></DIV > </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B > Writing implementation-dependent scripts with these constants should be discouraged. </P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="iconv.seealso" ></A >See Also</H1 ><P > See also the <A HREF="ref.recode.html" >GNU Recode functions</A >. </P ></DIV ></DIV ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT ><A HREF="function.iconv-get-encoding.html" >iconv_get_encoding</A > -- Get current setting for character encoding conversion</DT ><DT ><A HREF="function.iconv-set-encoding.html" >iconv_set_encoding</A > -- Set current setting for character encoding conversion</DT ><DT ><A HREF="function.iconv.html" >iconv</A > -- Convert string to requested character encoding</DT ><DT ><A HREF="function.ob-iconv-handler.html" >ob_iconv_handler</A > -- Convert character encoding as output buffer handler</DT ></DL ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.hwapi-userlist.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.iconv-get-encoding.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >hw_api->userlist</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="funcref.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >iconv_get_encoding</TD ></TR ></TABLE ></DIV ></BODY ></HTML >