<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.12"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>FreeTDS API: src/tds/iconv.c File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">FreeTDS API
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.12 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_000003.html">src</a></li><li class="navelem"><a class="el" href="dir_000011.html">tds</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#define-members">Macros</a> |
<a href="#enum-members">Enumerations</a> |
<a href="#func-members">Functions</a> |
<a href="#var-members">Variables</a> </div>
<div class="headertitle">
<div class="title">iconv.c File Reference</div> </div>
</div><!--header-->
<div class="contents">
<p>Handle character conversions to/from server.
<a href="#details">More...</a></p>
<div class="textblock"><code>#include <config.h></code><br />
<code>#include <stdarg.h></code><br />
<code>#include <stdio.h></code><br />
<code>#include <assert.h></code><br />
<code>#include <<a class="el" href="a00434_source.html">freetds/tds.h</a>></code><br />
<code>#include <freetds/iconv.h></code><br />
<code>#include "encodings.h"</code><br />
</div><div class="textblock"><div class="dynheader">
Include dependency graph for iconv.c:</div>
<div class="dyncontent">
<div class="center"><iframe scrolling="no" frameborder="0" src="a01343.svg" width="1467" height="336"><p><b>This browser is not able to show SVG: try Firefox, Chrome, Safari, or Opera instead.</b></p></iframe>
</div>
</div>
</div><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:af1a73e78c29d6c2f6fe4947d70585781"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><b>CHARSIZE</b>(charset)</td></tr>
<tr class="separator:af1a73e78c29d6c2f6fe4947d70585781"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga849bb1ce9f0ea276dcc0695cfba2492b"><td class="memItemLeft" align="right" valign="top">
#define </td><td class="memItemRight" valign="bottom"><b>CHUNK_ALLOC</b>   4</td></tr>
<tr class="separator:ga849bb1ce9f0ea276dcc0695cfba2492b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3b9bc0b29c1be1f3d74242e27871d787"><td class="memItemLeft" align="right" valign="top"><a id="a3b9bc0b29c1be1f3d74242e27871d787"></a>
#define </td><td class="memItemRight" valign="bottom"><b>TDS_ICONV_ENCODING_TABLES</b></td></tr>
<tr class="separator:a3b9bc0b29c1be1f3d74242e27871d787"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="enum-members"></a>
Enumerations</h2></td></tr>
<tr class="memitem:adc29c2ff13d900c2f185ee95427fb06c"><td class="memItemLeft" align="right" valign="top"><a id="adc29c2ff13d900c2f185ee95427fb06c"></a>enum  </td><td class="memItemRight" valign="bottom">{ <b>POS_ISO1</b>,
<b>POS_UTF8</b>,
<b>POS_UCS2LE</b>,
<b>POS_UCS2BE</b>
}</td></tr>
<tr class="separator:adc29c2ff13d900c2f185ee95427fb06c"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:gac84d63747b4310901ea09a8995ffbf30"><td class="memItemLeft" align="right" valign="top">
static void </td><td class="memItemRight" valign="bottom"><b>_iconv_close</b> (iconv_t *cd)</td></tr>
<tr class="separator:gac84d63747b4310901ea09a8995ffbf30"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga091a479fdf6ef1c3e2ceba8d3caec6cd"><td class="memItemLeft" align="right" valign="top">
static int </td><td class="memItemRight" valign="bottom"><b>collate2charset</b> (int sql_collate, int lcid)</td></tr>
<tr class="separator:ga091a479fdf6ef1c3e2ceba8d3caec6cd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacbb493e233cbcba830fd0185a86958e0"><td class="memItemLeft" align="right" valign="top">
static int </td><td class="memItemRight" valign="bottom"><b>lookup_canonic</b> (const <a class="el" href="a00933.html">CHARACTER_SET_ALIAS</a> aliases[], const char *charset_name)</td></tr>
<tr class="separator:gacbb493e233cbcba830fd0185a86958e0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3380140fc6eb9f2090c430f40e846876"><td class="memItemLeft" align="right" valign="top">static size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#ga3380140fc6eb9f2090c430f40e846876">skip_one_input_sequence</a> (iconv_t cd, const <a class="el" href="a00434.html#a6a0febfe3d78cb085172d18282a8cfaf">TDS_ENCODING</a> *charset, const char **input, size_t *input_size)</td></tr>
<tr class="memdesc:ga3380140fc6eb9f2090c430f40e846876"><td class="mdescLeft"> </td><td class="mdescRight">Move the input sequence pointer to the next valid position. <a href="a00531.html#ga3380140fc6eb9f2090c430f40e846876">More...</a><br /></td></tr>
<tr class="separator:ga3380140fc6eb9f2090c430f40e846876"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacc72a994f6ce06c64bc9223ace6eb9a0"><td class="memItemLeft" align="right" valign="top">
void </td><td class="memItemRight" valign="bottom"><b>tds7_srv_charset_changed</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, int sql_collate, int lcid)</td></tr>
<tr class="separator:gacc72a994f6ce06c64bc9223ace6eb9a0"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga38c0ac641a8c6e25e91ee9205c3c50c5"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#ga38c0ac641a8c6e25e91ee9205c3c50c5">tds_canonical_charset</a> (const char *charset_name)</td></tr>
<tr class="memdesc:ga38c0ac641a8c6e25e91ee9205c3c50c5"><td class="mdescLeft"> </td><td class="mdescRight">Determine canonical iconv character set. <a href="a00531.html#ga38c0ac641a8c6e25e91ee9205c3c50c5">More...</a><br /></td></tr>
<tr class="separator:ga38c0ac641a8c6e25e91ee9205c3c50c5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga6561d1dba1a04c168431b16ec17d7e4c"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#ga6561d1dba1a04c168431b16ec17d7e4c">tds_canonical_charset_name</a> (const char *charset_name)</td></tr>
<tr class="memdesc:ga6561d1dba1a04c168431b16ec17d7e4c"><td class="mdescLeft"> </td><td class="mdescRight">Determine canonical iconv character set name. <a href="a00531.html#ga6561d1dba1a04c168431b16ec17d7e4c">More...</a><br /></td></tr>
<tr class="separator:ga6561d1dba1a04c168431b16ec17d7e4c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga87db49044919f1bc84c0ff5e9ab00304"><td class="memItemLeft" align="right" valign="top">size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#ga87db49044919f1bc84c0ff5e9ab00304">tds_iconv</a> (<a class="el" href="a01193.html">TDSSOCKET</a> *tds, <a class="el" href="a00945.html">TDSICONV</a> *conv, TDS_ICONV_DIRECTION io, const char **inbuf, size_t *inbytesleft, char **outbuf, size_t *outbytesleft)</td></tr>
<tr class="memdesc:ga87db49044919f1bc84c0ff5e9ab00304"><td class="mdescLeft"> </td><td class="mdescRight">Wrapper around iconv(3). <a href="a00531.html#ga87db49044919f1bc84c0ff5e9ab00304">More...</a><br /></td></tr>
<tr class="separator:ga87db49044919f1bc84c0ff5e9ab00304"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a026957dbbd994b48b571a63405f427cd"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="a01342.html#a026957dbbd994b48b571a63405f427cd">tds_iconv_alloc</a> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn)</td></tr>
<tr class="memdesc:a026957dbbd994b48b571a63405f427cd"><td class="mdescLeft"> </td><td class="mdescRight">Allocate iconv stuff. <a href="#a026957dbbd994b48b571a63405f427cd">More...</a><br /></td></tr>
<tr class="separator:a026957dbbd994b48b571a63405f427cd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga443693697445c37abcd4b7103b1c47ac"><td class="memItemLeft" align="right" valign="top">
void </td><td class="memItemRight" valign="bottom"><b>tds_iconv_close</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn)</td></tr>
<tr class="separator:ga443693697445c37abcd4b7103b1c47ac"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad79cfd8c6b158aa6992e510abe4612aa"><td class="memItemLeft" align="right" valign="top">
static void </td><td class="memItemRight" valign="bottom"><b>tds_iconv_err</b> (<a class="el" href="a01193.html">TDSSOCKET</a> *tds, int err)</td></tr>
<tr class="separator:gad79cfd8c6b158aa6992e510abe4612aa"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gad161ada50068b9a8a05786cce7b3dc1d"><td class="memItemLeft" align="right" valign="top">
void </td><td class="memItemRight" valign="bottom"><b>tds_iconv_free</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn)</td></tr>
<tr class="separator:gad161ada50068b9a8a05786cce7b3dc1d"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaed775f7fcca42b5c2a53f9508c140259"><td class="memItemLeft" align="right" valign="top">
<a class="el" href="a00945.html">TDSICONV</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#gaed775f7fcca42b5c2a53f9508c140259">tds_iconv_from_collate</a> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, TDS_UCHAR collate[5])</td></tr>
<tr class="memdesc:gaed775f7fcca42b5c2a53f9508c140259"><td class="mdescLeft"> </td><td class="mdescRight">Get iconv information from a LCID (to support different column encoding under MSSQL2K) <br /></td></tr>
<tr class="separator:gaed775f7fcca42b5c2a53f9508c140259"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga978d2036de6a11a73ed4ab78b69c79f5"><td class="memItemLeft" align="right" valign="top">
<a class="el" href="a00945.html">TDSICONV</a> * </td><td class="memItemRight" valign="bottom"><b>tds_iconv_get</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, const char *client_charset, const char *server_charset)</td></tr>
<tr class="separator:ga978d2036de6a11a73ed4ab78b69c79f5"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gac85bc9c101048a124707c7050035e30f"><td class="memItemLeft" align="right" valign="top">
static <a class="el" href="a00945.html">TDSICONV</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#gac85bc9c101048a124707c7050035e30f">tds_iconv_get_info</a> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, int canonic_client, int canonic_server)</td></tr>
<tr class="memdesc:gac85bc9c101048a124707c7050035e30f"><td class="mdescLeft"> </td><td class="mdescRight">Get a iconv info structure, allocate and initialize if needed. <br /></td></tr>
<tr class="separator:gac85bc9c101048a124707c7050035e30f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gacacca154f73a30b2fb8a4736de51755f"><td class="memItemLeft" align="right" valign="top">
static void </td><td class="memItemRight" valign="bottom"><b>tds_iconv_info_close</b> (<a class="el" href="a00945.html">TDSICONV</a> *char_conv)</td></tr>
<tr class="separator:gacacca154f73a30b2fb8a4736de51755f"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3a7a7b4d6ed344127e164dd0b443d790"><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="a00531.html#ga3a7a7b4d6ed344127e164dd0b443d790">tds_iconv_info_init</a> (<a class="el" href="a00945.html">TDSICONV</a> *char_conv, int client_canonical, int server_canonical)</td></tr>
<tr class="memdesc:ga3a7a7b4d6ed344127e164dd0b443d790"><td class="mdescLeft"> </td><td class="mdescRight">Open iconv descriptors to convert between character sets (both directions). <a href="a00531.html#ga3a7a7b4d6ed344127e164dd0b443d790">More...</a><br /></td></tr>
<tr class="separator:ga3a7a7b4d6ed344127e164dd0b443d790"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a89de4d12be43b135ad355236717e9cbb"><td class="memItemLeft" align="right" valign="top"><a id="a89de4d12be43b135ad355236717e9cbb"></a>
static int </td><td class="memItemRight" valign="bottom"><a class="el" href="a01342.html#a89de4d12be43b135ad355236717e9cbb">tds_iconv_init</a> (void)</td></tr>
<tr class="memdesc:a89de4d12be43b135ad355236717e9cbb"><td class="mdescLeft"> </td><td class="mdescRight">Initialize charset searching for UTF-8, UCS-2 and ISO8859-1. <br /></td></tr>
<tr class="separator:a89de4d12be43b135ad355236717e9cbb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga1e4275b3494b59d8b6c642955bb72106"><td class="memItemLeft" align="right" valign="top">
TDSRET </td><td class="memItemRight" valign="bottom"><b>tds_iconv_open</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, const char *charset, int use_utf16)</td></tr>
<tr class="separator:ga1e4275b3494b59d8b6c642955bb72106"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a29bd4b16c03829201a2807c25548f807"><td class="memItemLeft" align="right" valign="top"><a id="a29bd4b16c03829201a2807c25548f807"></a>
static void </td><td class="memItemRight" valign="bottom"><b>tds_iconv_reset</b> (<a class="el" href="a00945.html">TDSICONV</a> *conv)</td></tr>
<tr class="separator:a29bd4b16c03829201a2807c25548f807"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a010ab1d181c8996f6a5984c9900eca6b"><td class="memItemLeft" align="right" valign="top"><a id="a010ab1d181c8996f6a5984c9900eca6b"></a>
static const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="a01342.html#a010ab1d181c8996f6a5984c9900eca6b">tds_set_iconv_name</a> (int charset)</td></tr>
<tr class="memdesc:a010ab1d181c8996f6a5984c9900eca6b"><td class="mdescLeft"> </td><td class="mdescRight">Get iconv name given canonic. <br /></td></tr>
<tr class="separator:a010ab1d181c8996f6a5984c9900eca6b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5252425e5f0ba60e3e10a0e26b88e254"><td class="memItemLeft" align="right" valign="top">
void </td><td class="memItemRight" valign="bottom"><b>tds_srv_charset_changed</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, const char *charset)</td></tr>
<tr class="separator:ga5252425e5f0ba60e3e10a0e26b88e254"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga9ab19ef36c79c203029ef4090bc54409"><td class="memItemLeft" align="right" valign="top">
static void </td><td class="memItemRight" valign="bottom"><b>tds_srv_charset_changed_num</b> (<a class="el" href="a01189.html">TDSCONNECTION</a> *conn, int canonic_charset_num)</td></tr>
<tr class="separator:ga9ab19ef36c79c203029ef4090bc54409"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="var-members"></a>
Variables</h2></td></tr>
<tr class="memitem:adfcb5f764a415848334752f81482a46b"><td class="memItemLeft" align="right" valign="top"><a id="adfcb5f764a415848334752f81482a46b"></a>
static int </td><td class="memItemRight" valign="bottom"><b>iconv_initialized</b> = 0</td></tr>
<tr class="separator:adfcb5f764a415848334752f81482a46b"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a3c445351ca101be9a912648255c4d0b2"><td class="memItemLeft" align="right" valign="top"><a id="a3c445351ca101be9a912648255c4d0b2"></a>
static const char * </td><td class="memItemRight" valign="bottom"><b>iconv_names</b> [sizeof(canonic_charsets)/sizeof(canonic_charsets[0])]</td></tr>
<tr class="separator:a3c445351ca101be9a912648255c4d0b2"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5611977532816dfba0aa491d2008ec03"><td class="memItemLeft" align="right" valign="top"><a id="a5611977532816dfba0aa491d2008ec03"></a>
static const char * </td><td class="memItemRight" valign="bottom"><b>ucs2name</b></td></tr>
<tr class="separator:a5611977532816dfba0aa491d2008ec03"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Handle character conversions to/from server. </p>
</div><h2 class="groupheader">Macro Definition Documentation</h2>
<a id="af1a73e78c29d6c2f6fe4947d70585781"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af1a73e78c29d6c2f6fe4947d70585781">§ </a></span>CHARSIZE</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define CHARSIZE</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">charset</td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<b>Value:</b><div class="fragment"><div class="line">( ((charset)->min_bytes_per_char == (charset)->max_bytes_per_char )? \</div><div class="line"> (charset)->min_bytes_per_char : 0 )</div></div><!-- fragment -->
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a id="a026957dbbd994b48b571a63405f427cd"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a026957dbbd994b48b571a63405f427cd">§ </a></span>tds_iconv_alloc()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int tds_iconv_alloc </td>
<td>(</td>
<td class="paramtype"><a class="el" href="a01189.html">TDSCONNECTION</a> * </td>
<td class="paramname"><em>conn</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Allocate iconv stuff. </p>
<dl class="section return"><dt>Returns</dt><dd>0 for success </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</body>
</html>
