<!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.11"/>
<title>ICU 58.2: icu::IDNA Class 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="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">ICU 58.2
 <span id="projectnumber">58.2</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="classes.html"><span>Data Structure Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Data Fields</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceicu.html">icu</a></li><li class="navelem"><a class="el" href="classicu_1_1IDNA.html">IDNA</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> </div>
<div class="headertitle">
<div class="title">icu::IDNA Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div>
</div><!--header-->
<div class="contents">
<p>Abstract base class for <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing.
<a href="classicu_1_1IDNA.html#details">More...</a></p>
<p><code>#include <<a class="el" href="idna_8h_source.html">idna.h</a>></code></p>
<div class="dynheader">
Inheritance diagram for icu::IDNA:</div>
<div class="dyncontent">
<div class="center">
<img src="classicu_1_1IDNA.png" usemap="#icu::IDNA_map" alt=""/>
<map id="icu::IDNA_map" name="icu::IDNA_map">
<area href="classicu_1_1UObject.html" title="UObject is the common ICU "boilerplate" class. " alt="icu::UObject" shape="rect" coords="0,56,89,80"/>
<area href="classicu_1_1UMemory.html" title="UMemory is the common ICU base class. " alt="icu::UMemory" shape="rect" coords="0,0,89,24"/>
</map>
</div></div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a9ff3962da24b93b53cc1a6ddfec44a56"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#a9ff3962da24b93b53cc1a6ddfec44a56">~IDNA</a> ()</td></tr>
<tr class="memdesc:a9ff3962da24b93b53cc1a6ddfec44a56"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#a9ff3962da24b93b53cc1a6ddfec44a56">More...</a><br /></td></tr>
<tr class="separator:a9ff3962da24b93b53cc1a6ddfec44a56"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ab7fadd5aadc995bc5338f6c24e0b82a1"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#ab7fadd5aadc995bc5338f6c24e0b82a1">labelToASCII</a> (const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &label, <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const =0</td></tr>
<tr class="memdesc:ab7fadd5aadc995bc5338f6c24e0b82a1"><td class="mdescLeft"> </td><td class="mdescRight">Converts a single domain name label into its ASCII form for DNS lookup. <a href="#ab7fadd5aadc995bc5338f6c24e0b82a1">More...</a><br /></td></tr>
<tr class="separator:ab7fadd5aadc995bc5338f6c24e0b82a1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a5ea4bb72be103823696ce2a6d3d37429"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#a5ea4bb72be103823696ce2a6d3d37429">labelToUnicode</a> (const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &label, <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const =0</td></tr>
<tr class="memdesc:a5ea4bb72be103823696ce2a6d3d37429"><td class="mdescLeft"> </td><td class="mdescRight">Converts a single domain name label into its Unicode form for human-readable display. <a href="#a5ea4bb72be103823696ce2a6d3d37429">More...</a><br /></td></tr>
<tr class="separator:a5ea4bb72be103823696ce2a6d3d37429"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a9a69814150ced9dd2c42c67d618e457a"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#a9a69814150ced9dd2c42c67d618e457a">nameToASCII</a> (const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &name, <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const =0</td></tr>
<tr class="memdesc:a9a69814150ced9dd2c42c67d618e457a"><td class="mdescLeft"> </td><td class="mdescRight">Converts a whole domain name into its ASCII form for DNS lookup. <a href="#a9a69814150ced9dd2c42c67d618e457a">More...</a><br /></td></tr>
<tr class="separator:a9a69814150ced9dd2c42c67d618e457a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:abd9b7b1a0d474117bf254407a5751fdd"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#abd9b7b1a0d474117bf254407a5751fdd">nameToUnicode</a> (const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &name, <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const =0</td></tr>
<tr class="memdesc:abd9b7b1a0d474117bf254407a5751fdd"><td class="mdescLeft"> </td><td class="mdescRight">Converts a whole domain name into its Unicode form for human-readable display. <a href="#abd9b7b1a0d474117bf254407a5751fdd">More...</a><br /></td></tr>
<tr class="separator:abd9b7b1a0d474117bf254407a5751fdd"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae7ae843bc0bb5ba86b0677c21d034747"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#ae7ae843bc0bb5ba86b0677c21d034747">labelToASCII_UTF8</a> (<a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> label, <a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const </td></tr>
<tr class="memdesc:ae7ae843bc0bb5ba86b0677c21d034747"><td class="mdescLeft"> </td><td class="mdescRight">Converts a single domain name label into its ASCII form for DNS lookup. <a href="#ae7ae843bc0bb5ba86b0677c21d034747">More...</a><br /></td></tr>
<tr class="separator:ae7ae843bc0bb5ba86b0677c21d034747"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a7107a02e519550f1fae2ae6455ebbb34"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#a7107a02e519550f1fae2ae6455ebbb34">labelToUnicodeUTF8</a> (<a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> label, <a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const </td></tr>
<tr class="memdesc:a7107a02e519550f1fae2ae6455ebbb34"><td class="mdescLeft"> </td><td class="mdescRight">Converts a single domain name label into its Unicode form for human-readable display. <a href="#a7107a02e519550f1fae2ae6455ebbb34">More...</a><br /></td></tr>
<tr class="separator:a7107a02e519550f1fae2ae6455ebbb34"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ae4f139b56aef47a5210e1b16e5042e6a"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#ae4f139b56aef47a5210e1b16e5042e6a">nameToASCII_UTF8</a> (<a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> name, <a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const </td></tr>
<tr class="memdesc:ae4f139b56aef47a5210e1b16e5042e6a"><td class="mdescLeft"> </td><td class="mdescRight">Converts a whole domain name into its ASCII form for DNS lookup. <a href="#ae4f139b56aef47a5210e1b16e5042e6a">More...</a><br /></td></tr>
<tr class="separator:ae4f139b56aef47a5210e1b16e5042e6a"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:af69670da04f697ef6c7a4245284f8551"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#af69670da04f697ef6c7a4245284f8551">nameToUnicodeUTF8</a> (<a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> name, <a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> &dest, <a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> &info, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode) const </td></tr>
<tr class="memdesc:af69670da04f697ef6c7a4245284f8551"><td class="mdescLeft"> </td><td class="mdescRight">Converts a whole domain name into its Unicode form for human-readable display. <a href="#af69670da04f697ef6c7a4245284f8551">More...</a><br /></td></tr>
<tr class="separator:af69670da04f697ef6c7a4245284f8551"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="inherit_header pub_methods_classicu_1_1UObject"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classicu_1_1UObject')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="classicu_1_1UObject.html">icu::UObject</a></td></tr>
<tr class="memitem:af10026497704f510d3d1f2eff50acb18 inherit pub_methods_classicu_1_1UObject"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1UObject.html#af10026497704f510d3d1f2eff50acb18">~UObject</a> ()</td></tr>
<tr class="memdesc:af10026497704f510d3d1f2eff50acb18 inherit pub_methods_classicu_1_1UObject"><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#af10026497704f510d3d1f2eff50acb18">More...</a><br /></td></tr>
<tr class="separator:af10026497704f510d3d1f2eff50acb18 inherit pub_methods_classicu_1_1UObject"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a1aa93096e880907080b503ff1fb0f8bc inherit pub_methods_classicu_1_1UObject"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="uobject_8h.html#a22af10545208a455a6e884008df48e9f">UClassID</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1UObject.html#a1aa93096e880907080b503ff1fb0f8bc">getDynamicClassID</a> () const </td></tr>
<tr class="memdesc:a1aa93096e880907080b503ff1fb0f8bc inherit pub_methods_classicu_1_1UObject"><td class="mdescLeft"> </td><td class="mdescRight">ICU4C "poor man's RTTI", returns a UClassID for the actual ICU class. <a href="#a1aa93096e880907080b503ff1fb0f8bc">More...</a><br /></td></tr>
<tr class="separator:a1aa93096e880907080b503ff1fb0f8bc inherit pub_methods_classicu_1_1UObject"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr class="memitem:a9b12c06c1de1c1231f3eeae2f8d5ff4c"><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classicu_1_1IDNA.html">IDNA</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classicu_1_1IDNA.html#a9b12c06c1de1c1231f3eeae2f8d5ff4c">createUTS46Instance</a> (uint32_t options, <a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> &errorCode)</td></tr>
<tr class="memdesc:a9b12c06c1de1c1231f3eeae2f8d5ff4c"><td class="mdescLeft"> </td><td class="mdescRight">Returns an <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> instance which implements UTS #46. <a href="#a9b12c06c1de1c1231f3eeae2f8d5ff4c">More...</a><br /></td></tr>
<tr class="separator:a9b12c06c1de1c1231f3eeae2f8d5ff4c"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>Abstract base class for <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing. </p>
<p>See <a href="http://www.unicode.org/reports/tr46/">http://www.unicode.org/reports/tr46/</a> and <a href="http://www.ietf.org/rfc/rfc3490.txt">http://www.ietf.org/rfc/rfc3490.txt</a></p>
<p>The <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> class is not intended for public subclassing.</p>
<p>This C++ API currently only implements UTS #46. The <a class="el" href="uidna_8h.html" title="C API: Internationalizing Domain Names in Applications (IDNA) ">uidna.h</a> C API implements both UTS #46 (functions using UIDNA service object) and IDNA2003 (functions that do not use a service object). </p><dl class="stable"><dt><b><a class="el" href="stable.html#_stable000199">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
<p>Definition at line <a class="el" href="idna_8h_source.html#l00050">50</a> of file <a class="el" href="idna_8h_source.html">idna.h</a>.</p>
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
<a class="anchor" id="a9ff3962da24b93b53cc1a6ddfec44a56"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">icu::IDNA::~IDNA </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Destructor. </p>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000201">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<h2 class="groupheader">Member Function Documentation</h2>
<a class="anchor" id="a9b12c06c1de1c1231f3eeae2f8d5ff4c"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classicu_1_1IDNA.html">IDNA</a>* icu::IDNA::createUTS46Instance </td>
<td>(</td>
<td class="paramtype">uint32_t </td>
<td class="paramname"><em>options</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">static</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Returns an <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> instance which implements UTS #46. </p>
<p>Returns an unmodifiable instance, owned by the caller. Cache it for multiple operations, and delete it when done. The instance is thread-safe, that is, it can be used concurrently.</p>
<p>UTS #46 defines Unicode <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> Compatibility Processing, updated to the latest version of Unicode and compatible with both IDNA2003 and IDNA2008.</p>
<p>The worker functions use transitional processing, including deviation mappings, unless UIDNA_NONTRANSITIONAL_TO_ASCII or UIDNA_NONTRANSITIONAL_TO_UNICODE is used in which case the deviation characters are passed through without change.</p>
<p>Disallowed characters are mapped to U+FFFD.</p>
<p>For available options see the <a class="el" href="uidna_8h.html" title="C API: Internationalizing Domain Names in Applications (IDNA) ">uidna.h</a> header. Operations with the UTS #46 instance do not support the UIDNA_ALLOW_UNASSIGNED option.</p>
<p>By default, the UTS #46 implementation allows all ASCII characters (as valid or mapped). When the UIDNA_USE_STD3_RULES option is used, ASCII characters other than letters, digits, hyphen (LDH) and dot/full stop are disallowed and mapped to U+FFFD.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">options</td><td>Bit set to modify the processing and error checking. See option bit set values in <a class="el" href="uidna_8h.html" title="C API: Internationalizing Domain Names in Applications (IDNA) ">uidna.h</a>. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>the UTS #46 <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> instance, if successful </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000202">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="ab7fadd5aadc995bc5338f6c24e0b82a1"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a>& icu::IDNA::labelToASCII </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>label</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a single domain name label into its ASCII form for DNS lookup. </p>
<p>If any processing step fails, then info.hasErrors() will be TRUE and the result might not be an ASCII string. The label might be modified according to the types of errors. Labels with severe errors will be left in (or turned into) their Unicode form.</p>
<p>The UErrorCode indicates an error only in exceptional cases, such as a U_MEMORY_ALLOCATION_ERROR.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">label</td><td>Input domain name label </td></tr>
<tr><td class="paramname">dest</td><td>Destination string object </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000203">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="ae7ae843bc0bb5ba86b0677c21d034747"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void icu::IDNA::labelToASCII_UTF8 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> </td>
<td class="paramname"><em>label</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a single domain name label into its ASCII form for DNS lookup. </p>
<p>UTF-8 version of <a class="el" href="classicu_1_1IDNA.html#ab7fadd5aadc995bc5338f6c24e0b82a1" title="Converts a single domain name label into its ASCII form for DNS lookup. ">labelToASCII()</a>, same behavior.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">label</td><td>Input domain name label </td></tr>
<tr><td class="paramname">dest</td><td>Destination byte sink; Flush()ed if successful </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000207">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a5ea4bb72be103823696ce2a6d3d37429"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a>& icu::IDNA::labelToUnicode </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>label</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a single domain name label into its Unicode form for human-readable display. </p>
<p>If any processing step fails, then info.hasErrors() will be TRUE. The label might be modified according to the types of errors.</p>
<p>The UErrorCode indicates an error only in exceptional cases, such as a U_MEMORY_ALLOCATION_ERROR.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">label</td><td>Input domain name label </td></tr>
<tr><td class="paramname">dest</td><td>Destination string object </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000204">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a7107a02e519550f1fae2ae6455ebbb34"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void icu::IDNA::labelToUnicodeUTF8 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> </td>
<td class="paramname"><em>label</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a single domain name label into its Unicode form for human-readable display. </p>
<p>UTF-8 version of <a class="el" href="classicu_1_1IDNA.html#a5ea4bb72be103823696ce2a6d3d37429" title="Converts a single domain name label into its Unicode form for human-readable display. ">labelToUnicode()</a>, same behavior.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">label</td><td>Input domain name label </td></tr>
<tr><td class="paramname">dest</td><td>Destination byte sink; Flush()ed if successful </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000208">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="a9a69814150ced9dd2c42c67d618e457a"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a>& icu::IDNA::nameToASCII </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a whole domain name into its ASCII form for DNS lookup. </p>
<p>If any processing step fails, then info.hasErrors() will be TRUE and the result might not be an ASCII string. The domain name might be modified according to the types of errors. Labels with severe errors will be left in (or turned into) their Unicode form.</p>
<p>The UErrorCode indicates an error only in exceptional cases, such as a U_MEMORY_ALLOCATION_ERROR.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Input domain name </td></tr>
<tr><td class="paramname">dest</td><td>Destination string object </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000205">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="ae4f139b56aef47a5210e1b16e5042e6a"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void icu::IDNA::nameToASCII_UTF8 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a whole domain name into its ASCII form for DNS lookup. </p>
<p>UTF-8 version of <a class="el" href="classicu_1_1IDNA.html#a9a69814150ced9dd2c42c67d618e457a" title="Converts a whole domain name into its ASCII form for DNS lookup. ">nameToASCII()</a>, same behavior.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Input domain name </td></tr>
<tr><td class="paramname">dest</td><td>Destination byte sink; Flush()ed if successful </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000209">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="abd9b7b1a0d474117bf254407a5751fdd"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a>& icu::IDNA::nameToUnicode </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1UnicodeString.html">UnicodeString</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a whole domain name into its Unicode form for human-readable display. </p>
<p>If any processing step fails, then info.hasErrors() will be TRUE. The domain name might be modified according to the types of errors.</p>
<p>The UErrorCode indicates an error only in exceptional cases, such as a U_MEMORY_ALLOCATION_ERROR.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Input domain name </td></tr>
<tr><td class="paramname">dest</td><td>Destination string object </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000206">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<a class="anchor" id="af69670da04f697ef6c7a4245284f8551"></a>
<div class="memitem">
<div class="memproto">
<table class="mlabels">
<tr>
<td class="mlabels-left">
<table class="memname">
<tr>
<td class="memname">virtual void icu::IDNA::nameToUnicodeUTF8 </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classicu_1_1StringPiece.html">StringPiece</a> </td>
<td class="paramname"><em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1ByteSink.html">ByteSink</a> & </td>
<td class="paramname"><em>dest</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classicu_1_1IDNAInfo.html">IDNAInfo</a> & </td>
<td class="paramname"><em>info</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#a3343c1c8a8377277046774691c98d78c">UErrorCode</a> & </td>
<td class="paramname"><em>errorCode</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</td>
<td class="mlabels-right">
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
</tr>
</table>
</div><div class="memdoc">
<p>Converts a whole domain name into its Unicode form for human-readable display. </p>
<p>UTF-8 version of <a class="el" href="classicu_1_1IDNA.html#abd9b7b1a0d474117bf254407a5751fdd" title="Converts a whole domain name into its Unicode form for human-readable display. ">nameToUnicode()</a>, same behavior.</p>
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">name</td><td>Input domain name </td></tr>
<tr><td class="paramname">dest</td><td>Destination byte sink; Flush()ed if successful </td></tr>
<tr><td class="paramname">info</td><td>Output container of <a class="el" href="classicu_1_1IDNA.html" title="Abstract base class for IDNA processing. ">IDNA</a> processing details. </td></tr>
<tr><td class="paramname">errorCode</td><td>Standard ICU error code. Its input value must pass the <a class="el" href="utypes_8h.html#a527f2c69e6b2e3b2c53ad8a99fb36711" title="Does the error code indicate success? ">U_SUCCESS()</a> test, or else the function returns immediately. Check for <a class="el" href="utypes_8h.html#a4d202200b6aa6f3c965ea370e0c8155f" title="Does the error code indicate a failure? ">U_FAILURE()</a> on output or use with function chaining. (See User Guide for details.) </td></tr>
</table>
</dd>
</dl>
<dl class="section return"><dt>Returns</dt><dd>dest </dd></dl>
<dl class="stable"><dt><b><a class="el" href="stable.html#_stable000210">Stable:</a></b></dt><dd>ICU 4.6 </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="idna_8h_source.html">idna.h</a></li>
</ul>
</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.11
</small></address>
</body>
</html>
distrib
>
Mageia
>
6
>
armv5tl
>
media
>
core-release
>
by-pkgid
>
3a4e91bde08970529a0aa07935652fe8
>
files
>
124
