<HTML ><HEAD ><TITLE >GNU Recode 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="readline" HREF="function.readline.html"><LINK REL="NEXT" TITLE="recode_file" HREF="function.recode-file.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.readline.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.recode-file.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="reference" ><A NAME="ref.recode" ></A ><DIV CLASS="TITLEPAGE" ><H1 CLASS="title" >LXXXVII. GNU Recode functions</H1 ><DIV CLASS="PARTINTRO" ><A NAME="AEN80728" ></A ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="recode.intro" ></A >Introduction</H1 ><P > This module contains an interface to the GNU Recode library, version 3.5. The GNU Recode library converts files between various coded character sets and surface encodings. When this cannot be achieved exactly, it may get rid of the offending characters or fall back on approximations. The library recognises or produces nearly 150 different character sets and is able to convert files between almost any pair. Most <A HREF="http://www.faqs.org/rfcs/rfc1345.html" TARGET="_top" >RFC 1345</A > character sets are supported. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Note: </B >This extension is not available on Windows platforms.</P ></BLOCKQUOTE ></DIV ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="recode.requirements" ></A >Requirements</H1 ><P > You must have GNU Recode 3.5 or higher installed on your system. You can download the package from <A HREF="http://www.gnu.org/directory/All_GNU_Packages/recode.html" TARGET="_top" >here</A >. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="recode.installation" ></A >Installation</H1 ><P > To be able to use the functions defined in this module you must compile your PHP interpreter using the <TT CLASS="option" >--with-recode[=DIR]</TT > option. </P ><DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Warning</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > Crashes and startup problems of <TT CLASS="literal" >PHP</TT > may be encountered when loading the recode as extension <SPAN CLASS="strong" ><B CLASS="emphasis" >after</B ></SPAN > loading any extension of <A HREF="ref.mysql.html" >mysql</A > or <A HREF="ref.imap.html" >imap</A >. Loading the recode before those extension has proven to fix the problem. This is due a technical problem that both the c-client library used by imap and recode have their own <TT CLASS="literal" >hash_lookup()</TT > function and both mysql and recode have their own <TT CLASS="literal" >hash_insert</TT > function. </P ></TD ></TR ></TABLE ></DIV ><DIV CLASS="warning" ><P ></P ><TABLE CLASS="warning" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Warning</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P >The <A HREF="ref.imap.html" >IMAP</A > extension cannot be used in conjuction with the <A HREF="ref.recode.html" >recode</A > or <A HREF="ref.yaz.html" >YAZ</A > extensions. This is due to the fact that they both share the same internal symbol.</P ></TD ></TR ></TABLE ></DIV ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="recode.configuration" ></A >Runtime Configuration</H1 ><P >This extension has no configuration directives defined in <TT CLASS="filename" >php.ini</TT >.</P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="recode.resources" ></A >Resource Types</H1 ><P >This extension has no resource types defined.</P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="recode.constants" ></A >Predefined Constants</H1 ><P >This extension has no constants defined.</P ></DIV ></DIV ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT ><A HREF="function.recode-file.html" >recode_file</A > -- Recode from file to file according to recode request </DT ><DT ><A HREF="function.recode-string.html" >recode_string</A > -- Recode a string according to a recode request</DT ><DT ><A HREF="function.recode.html" >recode</A > -- Recode a string according to a recode request</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.readline.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.recode-file.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >readline</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="funcref.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >recode_file</TD ></TR ></TABLE ></DIV ></BODY ></HTML >