<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../style.css">
<title>
Gambas Documentation - Conv$
</title>
</head>
<table class="none" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr><td align="left">
<font size="-1">
<a href="../../help+en"><img class="flag" alt="Home" border="0" src="../../img/lang/en.png" align="center"></a>&nbsp;
<a href="../lang+en">Up</a>&nbsp;
<a href="continue+en">Previous</a>&nbsp;
<a href="copy+en">Next</a>&nbsp;
</td></tr></table>
<div class="notab">
<h1>
Conv$
</h1>
<div class="black"><font 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+en">ASCII</a>&quot;</tt>, <tt>&quot;ISO-8859-1&quot;</tt>, or <tt>&quot;<a href="../def/utf8+en">UTF-8</a>&quot;</tt>.
<p>
The <a href="../def/gambas+en">Gambas</a> interpreter internally uses the <a href="../def/utf8+en">UTF-8</a> charset.
<p>
The charset used by the system is returned by <a href="../comp/gb/system+en">System</a>.<a href="../comp/gb/system/charset+en">Charset</a>. It is <tt>ISO-8859-15</tt> on a Mandrake 10.2, but <tt><a href="../def/utf8+en">UTF-8</a></tt> on a RedHat! In the future, all <a href="../def/linux+en">Linux</a> systems will probably be <tt><a href="../def/utf8+en">UTF-8</a></tt> based.
<p>
The charset used by the graphical user interface is returned by <a href="../comp/gb.qt/desktop+en">Desktop</a>.<a href="../comp/gb.qt/desktop/charset+en">Charset</a>. It should always be <tt><a href="../def/utf8+en">UTF-8</a></tt>.
<p>
The conversion relies on the <i>iconv()</i> GNU library function.
<p>
<div class="gray"><font 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 class="dark"><td valign="top">
<a href="../error/conv+en">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+en">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 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+en">Conversion Functions</a>&nbsp;

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

