ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/nls3.htm

97 lines
4.1 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Data Conversion APIs</title>
<!-- Begin Header Records ========================================= -->
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Change History: -->
<!-- YYMMDD USERID Change description -->
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
<!-- File restructured for V5R2 -->
<!-- 031111 JETAYLOR replaced API and/or Exit listings with -->
<!-- pagegenerator output from javascript array -->
<!-- End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>Data Conversion APIs</h2>
<p>The data conversion APIs are:</p>
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
<!-- Updates made in this section *will* be overlaid by automated tools -->
<!-- Notify User Technologies of needed updates to be made in XML for API finder.-->
<!--***************API BEGIN PASTE***************-->
<ul>
<li><A HREF="iconv.htm">Code Conversion</A> (iconv()) converts a buffer of characters from one coded character set identifier (CCSID) into another CCSID.</li>
<li><A HREF="QTQICONV.htm">Code Conversion Allocation</A> (QtqIconvOpen()) performs the necessary initializations to convert character encodings and returns a conversion descriptor.</li>
<li><A HREF="iconvopn.htm">Code Conversion Allocation</A> (iconv_open()) performs the necessary initializations to convert character encodings and returns a conversion descriptor of type iconv_t.</li>
<li><A HREF="iconvcls.htm">Code Conversion Deallocation</A> (iconv_close()) closes the conversion descriptor cd that was initialized by the iconv_open() or QtqIconvOpen() function.</li>
<li><A HREF="QDCXLATE.htm">Convert Data</A> (QDCXLATE) converts data through the use of a table object.</li>
</ul>
<!--***************API END PASTE***************-->
<p>The following code conversion APIs are designed to meet the X/Open industry
standard functions (formerly Spec 1170).</p>
<ul>
<li><strong>iconv()</strong></li>
<li><strong>iconv_open()</strong></li>
<li><strong>iconv_close()</strong></li>
</ul>
<p><strong>Note:</strong> The <strong>QtqIconvOpen()</strong> function does not
meet the X/Open industry standard.</p>
<p>The three-step conversion provided by the code conversion APIs allows
applications to:</p>
<ul>
<li>Open a conversion descriptor with a specified CCSID pair
(<strong>iconv_open()</strong> or <strong>QtqIconvOpen()</strong>
function)</li>
<li>Do multiple conversions (<strong>iconv()</strong> function)</li>
<li>Close the conversion descriptor when done (<strong>iconv_close()</strong>
function)</li>
</ul>
<p>This reduces the overhead for applications that need to do multiple
conversions using the same CCSID pairs. These functions are carried out on the
iSeries<SUP>(TM)</SUP> system as entry points in a bindable Integrated Language Environment
(ILE) service program.</p>
<p><strong>Note:</strong> The CDRA API, <a href="CDRCVRT.htm">Convert a Graphic
Character String</a> (CDRCVRT), converts a graphic character data string from
one CCSID to another CCSID.</p>
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center">
<a href="#Top_Of_Page">Top</a> |
<a href="nls1.htm">National Language Support APIs</a> |
<a href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>