<!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>