Diff for /embedaddon/libiconv/man/iconv_open.3.html between versions 1.1 and 1.1.1.2

version 1.1, 2012/02/21 22:57:48 version 1.1.1.2, 2012/05/29 09:29:43
Line 1 Line 1
<!-- Creator     : groff version 1.18.1 --><!-- Creator     : groff version 1.20.1 -->
<!-- CreationDate: Tue Jun 30 22:52:08 2009 --><!-- CreationDate: Sun Aug  7 19:49:14 2011 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
 <html>  <html>
 <head>  <head>
 <meta name="generator" content="groff -Thtml, see www.gnu.org">  <meta name="generator" content="groff -Thtml, see www.gnu.org">
   <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <meta name="Content-Style" content="text/css">  <meta name="Content-Style" content="text/css">
   <style type="text/css">
          p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
          pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
          table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
          h1      { text-align: center }
   </style>
 <title>ICONV_OPEN</title>  <title>ICONV_OPEN</title>
   
 </head>  </head>
 <body>  <body>
   
<h1 align=center>ICONV_OPEN</h1><h1 align="center">ICONV_OPEN</h1>
 
 <a href="#NAME">NAME</a><br>  <a href="#NAME">NAME</a><br>
 <a href="#SYNOPSIS">SYNOPSIS</a><br>  <a href="#SYNOPSIS">SYNOPSIS</a><br>
 <a href="#DESCRIPTION">DESCRIPTION</a><br>  <a href="#DESCRIPTION">DESCRIPTION</a><br>
Line 18 Line 29
 <a href="#SEE ALSO">SEE ALSO</a><br>  <a href="#SEE ALSO">SEE ALSO</a><br>
   
 <hr>  <hr>
   
   
   <h2>NAME
 <a name="NAME"></a>  <a name="NAME"></a>
<h2>NAME</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">iconv_open
<tr valign="top" align="left">&minus; allocate descriptor for character set conversion</p>
<td width="10%"></td>
<td width="89%"><h2>SYNOPSIS
<p>iconv_open &minus; allocate descriptor for character set 
conversion</p> 
</td> 
</table> 
 <a name="SYNOPSIS"></a>  <a name="SYNOPSIS"></a>
<h2>SYNOPSIS</h2></h2>
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<pre><b>#include &lt;iconv.h&gt; 
   
iconv_t iconv_open (const char*</b> <i>tocode</i><b>, const char*</b> <i>fromcode</i><b>);
</b></pre><p style="margin-left:11%; margin-top: 1em"><b>#include
</td>&lt;iconv.h&gt;</b></p>
</table>
 <p style="margin-left:11%; margin-top: 1em"><b>iconv_t
 iconv_open (const char*</b> <i>tocode</i><b>, const
 char*</b> <i>fromcode</i><b>);</b></p>
 
 <h2>DESCRIPTION
 <a name="DESCRIPTION"></a>  <a name="DESCRIPTION"></a>
<h2>DESCRIPTION</h2></h2>
<!-- INDENTATION --> 
   
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">The
<tr valign="top" align="left"><b>iconv_open</b> function allocates a conversion descriptor
<td width="10%"></td>suitable for converting byte sequences from character
<td width="89%">encoding <i>fromcode</i> to character encoding
<p>The <b>iconv_open</b> function allocates a conversion 
descriptor suitable for converting byte sequences from 
character encoding <i>fromcode</i> to character encoding 
 <i>tocode</i>.</p>  <i>tocode</i>.</p>
<!-- INDENTATION -->
<p>The values permitted for <i>fromcode</i> and<p style="margin-left:11%; margin-top: 1em">The values
<i>tocode</i> and the supported combinations are systempermitted for <i>fromcode</i> and <i>tocode</i> and the
dependent. For the libiconv library, the following encodingssupported combinations are system dependent. For the
are supported, in all combinations.</p>libiconv library, the following encodings are supported, in
</td>all combinations. <br>
</table>European languages</p>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p style="margin-left:22%;">ASCII,
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>European languages</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>ASCII, 
 ISO&minus;8859&minus;{1,2,3,4,5,7,9,10,13,14,15,16},  ISO&minus;8859&minus;{1,2,3,4,5,7,9,10,13,14,15,16},
 KOI8&minus;R, KOI8&minus;U, KOI8&minus;RU,  KOI8&minus;R, KOI8&minus;U, KOI8&minus;RU,
 CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},  CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
 Mac{Roman,CentralEurope,Iceland,Croatian,Romania},  Mac{Roman,CentralEurope,Iceland,Croatian,Romania},
 Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh</p>  Mac{Cyrillic,Ukraine,Greek,Turkish}, Macintosh</p>
</td>
</table><p style="margin-left:11%;">Semitic languages</p>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p style="margin-left:22%;">ISO&minus;8859&minus;{6,8},
       cols="2" cellspacing="0" cellpadding="0">CP{1255,1256}, CP862, Mac{Hebrew,Arabic}</p>
<tr valign="top" align="left">
<td width="10%"></td><p style="margin-left:11%;">Japanese</p>
<td width="89%">
<p>Semitic languages</p></td><p style="margin-left:22%;">EUC&minus;JP, SHIFT_JIS, CP932,
</table>ISO&minus;2022&minus;JP, ISO&minus;2022&minus;JP&minus;2,
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>ISO&minus;8859&minus;{6,8}, CP{1255,1256}, CP862, 
Mac{Hebrew,Arabic}</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Japanese</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>EUC&minus;JP, SHIFT_JIS, CP932, ISO&minus;2022&minus;JP, 
ISO&minus;2022&minus;JP&minus;2, 
 ISO&minus;2022&minus;JP&minus;1</p>  ISO&minus;2022&minus;JP&minus;1</p>
</td>
</table><p style="margin-left:11%;">Chinese</p>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p style="margin-left:22%;">EUC&minus;CN, HZ, GBK, CP936,
       cols="2" cellspacing="0" cellpadding="0">GB18030, EUC&minus;TW, BIG5, CP950, BIG5&minus;HKSCS,
<tr valign="top" align="left">BIG5&minus;HKSCS:2004, BIG5&minus;HKSCS:2001,
<td width="10%"></td> 
<td width="89%"> 
<p>Chinese</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>EUC&minus;CN, HZ, GBK, CP936, GB18030, EUC&minus;TW, 
BIG5, CP950, BIG5&minus;HKSCS, BIG5&minus;HKSCS:2001, 
 BIG5&minus;HKSCS:1999, ISO&minus;2022&minus;CN,  BIG5&minus;HKSCS:1999, ISO&minus;2022&minus;CN,
 ISO&minus;2022&minus;CN&minus;EXT</p>  ISO&minus;2022&minus;CN&minus;EXT</p>
</td>
</table><table width="100%" border="0" rules="none" frame="void"
<!-- TABS -->       cellspacing="0" cellpadding="0">
<table width="100%" border=0 rules="none" frame="void" 
       cols="3" cellspacing="0" cellpadding="0"> 
 <tr valign="top" align="left">  <tr valign="top" align="left">
 <td width="11%"></td>  <td width="11%"></td>
<td width="8%"><td width="9%">
   
<p>Korean</p>
</td><p>Korean</p></td>
<td width="79%"><td width="2%"></td>
</td><td width="50%">
 
 
 <p>EUC&minus;KR, CP949, ISO&minus;2022&minus;KR, JOHAB</p></td>
 <td width="28%">
 </td></tr>
 </table>  </table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p style="margin-left:11%;">Armenian</p>
       cols="2" cellspacing="0" cellpadding="0">
 <p style="margin-left:22%;">ARMSCII&minus;8</p>
 
 <p style="margin-left:11%;">Georgian</p>
 
 <p style="margin-left:22%;">Georgian&minus;Academy,
 Georgian&minus;PS</p>
 
 <table width="100%" border="0" rules="none" frame="void"
        cellspacing="0" cellpadding="0">
 <tr valign="top" align="left">  <tr valign="top" align="left">
 <td width="21%"></td>  
 <td width="77%">  
 <p>EUC&minus;KR, CP949, ISO&minus;2022&minus;KR, JOHAB</p>  
 </td>  
 </table>  
 <!-- INDENTATION -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="2" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="10%"></td>  
 <td width="89%">  
 <p>Armenian</p></td>  
 </table>  
 <!-- INDENTATION -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="2" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="21%"></td>  
 <td width="77%">  
 <p>ARMSCII&minus;8</p>  
 </td>  
 </table>  
 <!-- INDENTATION -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="2" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="10%"></td>  
 <td width="89%">  
 <p>Georgian</p></td>  
 </table>  
 <!-- INDENTATION -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="2" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="21%"></td>  
 <td width="77%">  
 <p>Georgian&minus;Academy, Georgian&minus;PS</p>  
 </td>  
 </table>  
 <!-- TABS -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="3" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="11%"></td>  <td width="11%"></td>
<td width="7%"><td width="9%">
   
<p>Tajik</p>
</td><p>Tajik</p></td>
<td width="80%"><td width="2%"></td>
</td><td width="35%">
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p>KOI8&minus;T</p></td>
       cols="2" cellspacing="0" cellpadding="0"><td width="43%">
 </td></tr>
 <tr valign="top" align="left">  <tr valign="top" align="left">
 <td width="21%"></td>  
 <td width="77%">  
 <p>KOI8&minus;T</p>  
 </td>  
 </table>  
 <!-- TABS -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="3" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="11%"></td>  <td width="11%"></td>
<td width="8%"><td width="9%">
   
<p>Kazakh</p>
</td><p>Kazakh</p></td>
<td width="79%"><td width="2%"></td>
</td><td width="35%">
</table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p>PT154, RK1048</p></td>
       cols="2" cellspacing="0" cellpadding="0"><td width="43%">
 </td></tr>
 <tr valign="top" align="left">  <tr valign="top" align="left">
 <td width="21%"></td>  
 <td width="77%">  
 <p>PT154, RK1048</p>  
 </td>  
 </table>  
 <!-- TABS -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="3" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="11%"></td>  <td width="11%"></td>
<td width="5%"><td width="9%">
   
<p>Thai</p>
</td><p>Thai</p></td>
<td width="82%"><td width="2%"></td>
</td><td width="35%">
 
 
 <p>TIS&minus;620, CP874, MacThai</p></td>
 <td width="43%">
 </td></tr>
 </table>  </table>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p style="margin-left:11%;">Laotian</p>
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"><p style="margin-left:22%;">MuleLao&minus;1, CP1133</p>
<td width="21%"></td>
<td width="77%"><p style="margin-left:11%;">Vietnamese</p>
<p>TIS&minus;620, CP874, MacThai</p>
</td><p style="margin-left:22%;">VISCII, TCVN, CP1258</p>
</table>
<!-- INDENTATION --><p style="margin-left:11%;">Platform specifics</p>
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:22%;">HP&minus;ROMAN8, NEXTSTEP</p>
<tr valign="top" align="left">
<td width="10%"></td><p style="margin-left:11%;">Full Unicode</p>
<td width="89%">
<p>Laotian</p></td><p style="margin-left:22%;">UTF&minus;8 <br>
</table>UCS&minus;2, UCS&minus;2BE, UCS&minus;2LE <br>
<!-- INDENTATION -->UCS&minus;4, UCS&minus;4BE, UCS&minus;4LE <br>
<table width="100%" border=0 rules="none" frame="void"UTF&minus;16, UTF&minus;16BE, UTF&minus;16LE <br>
       cols="2" cellspacing="0" cellpadding="0">UTF&minus;32, UTF&minus;32BE, UTF&minus;32LE <br>
<tr valign="top" align="left">UTF&minus;7 <br>
<td width="21%"></td>C99, JAVA</p>
<td width="77%">
<p>MuleLao&minus;1, CP1133</p><p style="margin-left:11%;">Full Unicode, in terms of
</td><b>uint16_t</b> or <b>uint32_t</b></p>
</table>
<!-- INDENTATION --><p style="margin-left:22%;">(with machine dependent
<table width="100%" border=0 rules="none" frame="void"endianness and alignment) <br>
       cols="2" cellspacing="0" cellpadding="0">UCS&minus;2&minus;INTERNAL, UCS&minus;4&minus;INTERNAL</p>
<tr valign="top" align="left">
<td width="10%"></td><p style="margin-left:11%;">Locale dependent, in terms of
<td width="89%"><b>char</b> or <b>wchar_t</b></p>
<p>Vietnamese</p></td>
</table><p style="margin-left:22%;">(with machine dependent
<!-- INDENTATION -->endianness and alignment, and with semantics depending on
<table width="100%" border=0 rules="none" frame="void"the OS and the current LC_CTYPE locale facet) <br>
       cols="2" cellspacing="0" cellpadding="0">char, wchar_t</p>
<tr valign="top" align="left">
<td width="21%"></td><p style="margin-left:11%; margin-top: 1em">When configured
<td width="77%">with the option
<p>VISCII, TCVN, CP1258</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Platform specifics</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>HP&minus;ROMAN8, NEXTSTEP</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Full Unicode</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>UTF&minus;8</p> 
<!-- INDENTATION --> 
<p>UCS&minus;2, UCS&minus;2BE, UCS&minus;2LE</p> 
<!-- INDENTATION --> 
<p>UCS&minus;4, UCS&minus;4BE, UCS&minus;4LE</p> 
<!-- INDENTATION --> 
<p>UTF&minus;16, UTF&minus;16BE, UTF&minus;16LE</p> 
<!-- INDENTATION --> 
<p>UTF&minus;32, UTF&minus;32BE, UTF&minus;32LE</p> 
<!-- INDENTATION --> 
<p>UTF&minus;7</p> 
<!-- INDENTATION --> 
<p>C99, JAVA</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Full Unicode, in terms of <b>uint16_t</b> or 
<b>uint32_t</b></p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>(with machine dependent endianness and alignment)</p> 
<!-- INDENTATION --> 
<p>UCS&minus;2&minus;INTERNAL, 
UCS&minus;4&minus;INTERNAL</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Locale dependent, in terms of <b>char</b> or 
<b>wchar_t</b></p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>(with machine dependent endianness and alignment, and 
with semantics depending on the OS and the current LC_CTYPE 
locale facet)</p> 
<!-- INDENTATION --> 
<p>char, wchar_t</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>When configured with the option 
 <b>&minus;&minus;enable&minus;extra&minus;encodings</b>, it  <b>&minus;&minus;enable&minus;extra&minus;encodings</b>, it
also provides support for a few extra encodings:</p>also provides support for a few extra encodings: <br>
</td>European languages</p>
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>European languages</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<pre>CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125} 
</pre> 
</td> 
</table> 
<!-- INDENTATION --> 
   
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:22%;">CP{437,737,775,852,853,855,857,858,860,861,863,865,869,1125}</p>
<tr valign="top" align="left">
<td width="10%"></td><p style="margin-left:11%;">Semitic languages</p>
<td width="89%">
<p>Semitic languages</p></td><p style="margin-left:22%;">CP864</p>
</table>
<!-- INDENTATION --><p style="margin-left:11%;">Japanese</p>
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:22%;">EUC&minus;JISX0213,
<tr valign="top" align="left">Shift_JISX0213, ISO&minus;2022&minus;JP&minus;3</p>
<td width="21%"></td>
<td width="77%"><p style="margin-left:11%;">Chinese</p>
<p>CP864</p>
</td><p style="margin-left:22%;">BIG5&minus;2003
</table>(experimental)</p>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"<p style="margin-left:11%;">Turkmen</p>
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"><p style="margin-left:22%;">TDS565</p>
<td width="10%"></td>
<td width="89%"><p style="margin-left:11%;">Platform specifics</p>
<p>Japanese</p></td>
</table><p style="margin-left:22%;">ATARIST,
<!-- INDENTATION -->RISCOS&minus;LATIN1</p>
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">The empty
<tr valign="top" align="left">encoding name &quot;&quot; is equivalent to
<td width="21%"></td> 
<td width="77%"> 
<p>EUC&minus;JISX0213, Shift_JISX0213, 
ISO&minus;2022&minus;JP&minus;3</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Chinese</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>BIG5&minus;2003 (experimental)</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Turkmen</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>TDS565</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>Platform specifics</p></td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="21%"></td> 
<td width="77%"> 
<p>ATARIST, RISCOS&minus;LATIN1</p> 
</td> 
</table> 
<!-- INDENTATION --> 
<table width="100%" border=0 rules="none" frame="void" 
       cols="2" cellspacing="0" cellpadding="0"> 
<tr valign="top" align="left"> 
<td width="10%"></td> 
<td width="89%"> 
<p>The empty encoding name &quot;&quot; is equivalent to 
 &quot;char&quot;: it denotes the locale dependent character  &quot;char&quot;: it denotes the locale dependent character
 encoding.</p>  encoding.</p>
<!-- INDENTATION -->
<p>When the string &quot;//TRANSLIT&quot; is appended to<p style="margin-left:11%; margin-top: 1em">When the string
<i>tocode</i>, transliteration is activated. This means that&quot;//TRANSLIT&quot; is appended to <i>tocode</i>,
when a character cannot be represented in the targettransliteration is activated. This means that when a
character set, it can be approximated through one or severalcharacter cannot be represented in the target character set,
characters that look similar to the original character.</p>it can be approximated through one or several characters
<!-- INDENTATION -->that look similar to the original character.</p>
<p>When the string &quot;//IGNORE&quot; is appended to
<i>tocode</i>, characters that cannot be represented in the<p style="margin-left:11%; margin-top: 1em">When the string
target character set will be silently discarded.</p>&quot;//IGNORE&quot; is appended to <i>tocode</i>,
<!-- INDENTATION -->characters that cannot be represented in the target
<p>The resulting conversion descriptor can be used withcharacter set will be silently discarded.</p>
<b>iconv</b> any number of times. It remains valid until
deallocated using <b>iconv_close</b>.</p><p style="margin-left:11%; margin-top: 1em">The resulting
<!-- INDENTATION -->conversion descriptor can be used with <b>iconv</b> any
<p>A conversion descriptor contains a conversion state.number of times. It remains valid until deallocated using
After creation using <b>iconv_open</b>, the state is in the<b>iconv_close</b>.</p>
initial state. Using <b>iconv</b> modifies the
descriptor&rsquo;s conversion state. (This implies that a<p style="margin-left:11%; margin-top: 1em">A conversion
conversion descriptor can not be used in multiple threadsdescriptor contains a conversion state. After creation using
simultaneously.) To bring the state back to the initial<b>iconv_open</b>, the state is in the initial state. Using
state, use <b>iconv</b> with NULL as <i>inbuf</i><b>iconv</b> modifies the descriptor&rsquo;s conversion
argument.</p>state. (This implies that a conversion descriptor can not be
</td>used in multiple threads simultaneously.) To bring the state
</table>back to the initial state, use <b>iconv</b> with NULL as
 <i>inbuf</i> argument.</p>
 
 <h2>RETURN VALUE
 <a name="RETURN VALUE"></a>  <a name="RETURN VALUE"></a>
<h2>RETURN VALUE</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">The
<tr valign="top" align="left"><b>iconv_open</b> function returns a freshly allocated
<td width="10%"></td>conversion descriptor. In case of error, it sets
<td width="89%"> 
<p>The <b>iconv_open</b> function returns a freshly 
allocated conversion descriptor. In case of error, it sets 
 <b>errno</b> and returns (iconv_t)(&minus;1).</p>  <b>errno</b> and returns (iconv_t)(&minus;1).</p>
</td>
</table><h2>ERRORS
 <a name="ERRORS"></a>  <a name="ERRORS"></a>
<h2>ERRORS</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">The following
 error can occur, among others:</p>
 
 <table width="100%" border="0" rules="none" frame="void"
        cellspacing="0" cellpadding="0">
 <tr valign="top" align="left">  <tr valign="top" align="left">
 <td width="10%"></td>  
 <td width="89%">  
 <p>The following error can occur, among others:</p>  
 </td>  
 </table>  
 <!-- TABS -->  
 <table width="100%" border=0 rules="none" frame="void"  
        cols="4" cellspacing="0" cellpadding="0">  
 <tr valign="top" align="left">  
 <td width="11%"></td>  <td width="11%"></td>
<td width="8%"><td width="9%">
   
 <p><b>EINVAL</b></p>  
 </td>  
 <td width="1%"></td>  
 <td width="77%">  
   
   <p><b>EINVAL</b></p></td>
   <td width="2%"></td>
   <td width="78%">
   
   
 <p>The conversion from <i>fromcode</i> to <i>tocode</i> is  <p>The conversion from <i>fromcode</i> to <i>tocode</i> is
not supported by the implementation.</p>not supported by the implementation.</p></td></tr>
</td> 
 </table>  </table>
   
   <h2>CONFORMING TO
 <a name="CONFORMING TO"></a>  <a name="CONFORMING TO"></a>
<h2>CONFORMING TO</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0"><p style="margin-left:11%; margin-top: 1em">POSIX:2001</p>
<tr valign="top" align="left">
<td width="10%"></td><h2>SEE ALSO
<td width="89%"> 
<p>POSIX:2001</p> 
</td> 
</table> 
 <a name="SEE ALSO"></a>  <a name="SEE ALSO"></a>
<h2>SEE ALSO</h2></h2>
<!-- INDENTATION -->
<table width="100%" border=0 rules="none" frame="void"
       cols="2" cellspacing="0" cellpadding="0">
<tr valign="top" align="left"><p style="margin-left:11%; margin-top: 1em"><b>iconv</b>(3)
<td width="10%"></td><b>iconvctl</b>(3) <b>iconv_close</b>(3)</p>
<td width="89%"> 
<p><b>iconv</b>(3) <b>iconvctl</b>(3) 
<b>iconv_close</b>(3)</p> 
</td> 
</table> 
 <hr>  <hr>
 </body>  </body>
 </html>  </html>

Removed from v.1.1  
changed lines
  Added in v.1.1.1.2


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>