<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../style.css">
<title>
Gambas Documentation - Conv$
</title>
</head>
<body>
<table class="none" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr><td align="left">
<font size="-1">
<a href="../../help%3Fen"><img class="flag" alt="Home" border="0" src="../../img/lang/en.png" align="center"></a>&nbsp;&nbsp;
<a href="../lang%3Fen">Up</a>&nbsp;&nbsp;
<a href="continue%3Fen">Previous</a>&nbsp;&nbsp;
<a href="copy%3Fen">Next</a>&nbsp;&nbsp;
</td></tr></table>
<div class="notab">
<h1>
Conv$
</h1>
<div class="black"><font color="white" size="-2"><b>Syntax</b></font></div>
<pre class="syntax"><u>ConvertedString</u> <b>= Conv$ (</b> <u>String</u> AS String <b>,</b> <u>SourceCharset</u> AS String <b>,</b> <u>DestinationCharset</u> AS String <b>)</b> AS String
<u>ConvertedString</u> <b>= Conv (</b> <u>String</u> AS String <b>,</b> <u>SourceCharset</u> AS String <b>,</b> <u>DestinationCharset</u> AS String <b>)</b> AS String</pre><p>

Converts a string from one charset to another charset. A charset is represented by a string like <tt>&quot;<a href="../def/ascii%3Fen">ASCII</a>&quot;</tt>, <tt>&quot;ISO-8859-1&quot;</tt>, or <tt>&quot;<a href="../def/utf8%3Fen">UTF-8</a>&quot;</tt>.
<p>
The <a href="../def/gambas%3Fen">Gambas</a> interpreter internally uses the <a href="../def/utf8%3Fen">UTF-8</a> charset.
<p>
The charset used by the system is returned by <a href="../comp/gb/system%3Fen">System</a>.<a href="../comp/gb/system/charset%3Fen">Charset</a>. It is <tt>ISO-8859-15</tt> on a Mandrake 10.2, but <tt><a href="../def/utf8%3Fen">UTF-8</a></tt> on a RedHat! In the future, all <a href="../def/linux%3Fen">Linux</a> systems will probably be <tt><a href="../def/utf8%3Fen">UTF-8</a></tt> based.
<p>
The charset used by the graphical user interface is returned by <a href="../comp/gb.qt/desktop%3Fen">Desktop</a>.<a href="../comp/gb.qt/desktop/charset%3Fen">Charset</a>. It should always be <tt><a href="../def/utf8%3Fen">UTF-8</a></tt>.
<p>
The conversion relies on the <i>iconv()</i> GNU library function.
<p>
<div class="gray"><font color="white" size="-2"><b>Errors</b></font></div>
<table class="table" border="0" bordercolor="#000000" cellpadding="6" cellspacing="0" width="100%">
<tr><th>Message</th><th>Description</th></tr><tr bgcolor="white"><td valign="top">
<a href="../error/conv%3Fen">Bad string conversion (#32)</a>
</td><td valign="top">
The string to convert contains untranslatable characters.
</td></tr>
<tr><td valign="top">
<a href="../error/uconv%3Fen">Unsupported string conversion (#31)</a>
</td><td valign="top">
The specified charsets are unknown, or cannot be converted.
</td></tr>
</table>
<p>
<div class="gray"><font color="white" size="-2"><b>Example</b></font></div>
<pre class="example">DIM sStr AS String
DIM iInd AS Integer

sStr = Conv$(&quot;Gambas&quot;, &quot;ASCII&quot;, &quot;EBCDIC-US&quot;)

FOR iInd = 1 TO Len(sStr)
  PRINT Hex$(Asc(Mid$(sStr, iInd, 1)), 2); &quot; &quot;;
NEXT
<hr>C7 81 94 82 81 A2</pre>
<p>
<hr><b>See also</b><br>
<a href="../cat/conv%3Fen">Conversion Functions</a>&nbsp;&nbsp;

</div>
<hr>
</body>
</html>

