Annotation of embedaddon/libiconv/man/iconv_open_into.3.html, revision 1.1.1.2
1.1.1.2 ! misho 1: <!-- Creator : groff version 1.22.3 -->
! 2: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
! 3: "http://www.w3.org/TR/html4/loose.dtd">
1.1 misho 4: <html>
5: <head>
6: <meta name="generator" content="groff -Thtml, see www.gnu.org">
1.1.1.2 ! misho 7: <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
1.1 misho 8: <meta name="Content-Style" content="text/css">
1.1.1.2 ! misho 9: <style type="text/css">
! 10: p { margin-top: 0; margin-bottom: 0; vertical-align: top }
! 11: pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
! 12: table { margin-top: 0; margin-bottom: 0; vertical-align: top }
! 13: h1 { text-align: center }
! 14: </style>
1.1 misho 15: <title>ICONV_OPEN_INTO</title>
1.1.1.2 ! misho 16:
1.1 misho 17: </head>
18: <body>
19:
1.1.1.2 ! misho 20: <h1 align="center">ICONV_OPEN_INTO</h1>
! 21:
1.1 misho 22: <a href="#NAME">NAME</a><br>
23: <a href="#SYNOPSIS">SYNOPSIS</a><br>
24: <a href="#DESCRIPTION">DESCRIPTION</a><br>
25: <a href="#RETURN VALUE">RETURN VALUE</a><br>
26: <a href="#ERRORS">ERRORS</a><br>
27: <a href="#CONFORMING TO">CONFORMING TO</a><br>
28: <a href="#SEE ALSO">SEE ALSO</a><br>
29:
30: <hr>
1.1.1.2 ! misho 31:
! 32:
! 33: <h2>NAME
1.1 misho 34: <a name="NAME"></a>
1.1.1.2 ! misho 35: </h2>
! 36:
! 37:
! 38:
! 39: <p style="margin-left:11%; margin-top: 1em">iconv_open_into
! 40: − initialize descriptor for character set
! 41: conversion</p>
! 42:
! 43: <h2>SYNOPSIS
1.1 misho 44: <a name="SYNOPSIS"></a>
1.1.1.2 ! misho 45: </h2>
1.1 misho 46:
47:
1.1.1.2 ! misho 48: <p style="margin-left:11%; margin-top: 1em"><b>#include
! 49: <iconv.h></b></p>
! 50:
! 51: <p style="margin-left:11%; margin-top: 1em"><b>int
! 52: iconv_open_into (const char*</b> <i>tocode</i><b>, const
! 53: char*</b> <i>fromcode</i><b>, <br>
! 54: iconv_allocation_t*</b> <i>resultp</i><b>);</b></p>
! 55:
! 56: <h2>DESCRIPTION
1.1 misho 57: <a name="DESCRIPTION"></a>
1.1.1.2 ! misho 58: </h2>
1.1 misho 59:
1.1.1.2 ! misho 60:
! 61: <p style="margin-left:11%; margin-top: 1em">The
! 62: <b>iconv_open_into</b> function initializes a conversion
1.1 misho 63: descriptor suitable for converting byte sequences from
64: character encoding <i>fromcode</i> to character encoding
65: <i>tocode</i>. The conversion descriptor is stored in the
1.1.1.2 ! misho 66: memory pointed to by <i>resultp</i>.</p>
1.1 misho 67:
1.1.1.2 ! misho 68: <p style="margin-left:11%; margin-top: 1em">The values
! 69: permitted for <i>fromcode</i> and <i>tocode</i> are the same
! 70: as for the function <b>iconv_open</b>.</p>
! 71:
! 72: <p style="margin-left:11%; margin-top: 1em">After a
! 73: successful return from this function, <i>resultp</i> can be
! 74: be used as an <b>iconv_t</b> object with the <b>iconv</b>
! 75: function.</p>
1.1 misho 76:
1.1.1.2 ! misho 77: <h2>RETURN VALUE
1.1 misho 78: <a name="RETURN VALUE"></a>
1.1.1.2 ! misho 79: </h2>
1.1 misho 80:
1.1.1.2 ! misho 81:
! 82: <p style="margin-left:11%; margin-top: 1em">The
! 83: <b>iconv_open_into</b> function fills <b>*</b><i>resultp</i>
! 84: and returns 0 if it succeeds. In case of error, it sets
! 85: <b>errno</b> and returns −1.</p>
! 86:
! 87: <h2>ERRORS
1.1 misho 88: <a name="ERRORS"></a>
1.1.1.2 ! misho 89: </h2>
1.1 misho 90:
91:
1.1.1.2 ! misho 92: <p style="margin-left:11%; margin-top: 1em">The following
! 93: error can occur, among others:</p>
1.1 misho 94:
1.1.1.2 ! misho 95: <table width="100%" border="0" rules="none" frame="void"
! 96: cellspacing="0" cellpadding="0">
1.1 misho 97: <tr valign="top" align="left">
1.1.1.2 ! misho 98: <td width="11%"></td>
! 99: <td width="9%">
! 100:
! 101:
! 102: <p><b>EINVAL</b></p></td>
! 103: <td width="2%"></td>
! 104: <td width="78%">
! 105:
! 106:
! 107: <p>The conversion from <i>fromcode</i> to <i>tocode</i> is
! 108: not supported by the implementation.</p></td></tr>
! 109: </table>
! 110:
! 111: <h2>CONFORMING TO
1.1 misho 112: <a name="CONFORMING TO"></a>
1.1.1.2 ! misho 113: </h2>
1.1 misho 114:
1.1.1.2 ! misho 115:
! 116: <p style="margin-left:11%; margin-top: 1em">This function
! 117: is implemented only in GNU libiconv and not in other
! 118: <b>iconv</b> implementations. It is not backed by a
1.1 misho 119: standard. You can test for its presence through
1.1.1.2 ! misho 120: <b>(_LIBICONV_VERSION >= 0x010D)</b>.</p>
! 121:
! 122: <h2>SEE ALSO
1.1 misho 123: <a name="SEE ALSO"></a>
1.1.1.2 ! misho 124: </h2>
1.1 misho 125:
1.1.1.2 ! misho 126:
! 127:
! 128: <p style="margin-left:11%; margin-top: 1em"><b>iconv_open</b>(3)
! 129: <b>iconv</b>(3)</p>
1.1 misho 130: <hr>
131: </body>
132: </html>
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>