Gecko [ paxlifestyle.com ]

Name	Size	Permission	Date
alphaindex.h	26.54 KB	-rw-r--r--	2023-12-11 22:27
appendable.h	8.54 KB	-rw-r--r--	2023-12-11 22:27
basictz.h	9.99 KB	-rw-r--r--	2023-12-11 22:27
brkiter.h	27.86 KB	-rw-r--r--	2023-12-11 22:27
bytestream.h	10.75 KB	-rw-r--r--	2023-12-11 22:27
bytestrie.h	20.8 KB	-rw-r--r--	2023-12-11 22:27
bytestriebuilder.h	7.48 KB	-rw-r--r--	2023-12-11 22:27
calendar.h	106.52 KB	-rw-r--r--	2023-12-11 22:27
caniter.h	7.47 KB	-rw-r--r--	2023-12-11 22:27
casemap.h	25.42 KB	-rw-r--r--	2023-12-11 22:27
char16ptr.h	7.22 KB	-rw-r--r--	2023-12-11 22:27
chariter.h	24.06 KB	-rw-r--r--	2023-12-11 22:27
choicfmt.h	24 KB	-rw-r--r--	2023-12-11 22:27
coleitr.h	13.78 KB	-rw-r--r--	2023-12-11 22:27
coll.h	56.3 KB	-rw-r--r--	2023-12-11 22:27
compactdecimalformat.h	6.88 KB	-rw-r--r--	2023-12-11 22:27
curramt.h	3.67 KB	-rw-r--r--	2023-12-11 22:27
currpinf.h	7.3 KB	-rw-r--r--	2023-12-11 22:27
currunit.h	4.02 KB	-rw-r--r--	2023-12-11 22:27
datefmt.h	40.72 KB	-rw-r--r--	2023-12-11 22:27
dbbi.h	1.19 KB	-rw-r--r--	2023-12-11 22:27
dcfmtsym.h	20.94 KB	-rw-r--r--	2023-12-11 22:27
decimfmt.h	87.54 KB	-rw-r--r--	2023-12-11 22:27
displayoptions.h	7.08 KB	-rw-r--r--	2023-12-11 22:27
docmain.h	7.3 KB	-rw-r--r--	2023-12-11 22:27
dtfmtsym.h	38.23 KB	-rw-r--r--	2023-12-11 22:27
dtintrv.h	3.85 KB	-rw-r--r--	2023-12-11 22:27
dtitvfmt.h	49.26 KB	-rw-r--r--	2023-12-11 22:27
dtitvinf.h	18.63 KB	-rw-r--r--	2023-12-11 22:27
dtptngen.h	28.64 KB	-rw-r--r--	2023-12-11 22:27
dtrule.h	8.69 KB	-rw-r--r--	2023-12-11 22:27
edits.h	20.73 KB	-rw-r--r--	2023-12-11 22:27
enumset.h	2.08 KB	-rw-r--r--	2023-12-11 22:27
errorcode.h	4.84 KB	-rw-r--r--	2023-12-11 22:27
fieldpos.h	8.7 KB	-rw-r--r--	2023-12-11 22:27
filteredbrk.h	5.37 KB	-rw-r--r--	2023-12-11 22:27
fmtable.h	24.45 KB	-rw-r--r--	2023-12-11 22:27
format.h	12.5 KB	-rw-r--r--	2023-12-11 22:27
formattednumber.h	6.15 KB	-rw-r--r--	2023-12-11 22:27
formattedvalue.h	9.75 KB	-rw-r--r--	2023-12-11 22:27
fpositer.h	3.03 KB	-rw-r--r--	2023-12-11 22:27
gender.h	3.35 KB	-rw-r--r--	2023-12-11 22:27
gregocal.h	30.03 KB	-rw-r--r--	2023-12-11 22:27
icudataver.h	1.02 KB	-rw-r--r--	2023-12-11 22:27
icuplug.h	12.1 KB	-rw-r--r--	2023-12-11 22:27
idna.h	12.71 KB	-rw-r--r--	2023-12-11 22:27
listformatter.h	8.59 KB	-rw-r--r--	2023-12-11 22:27
localebuilder.h	11.08 KB	-rw-r--r--	2023-12-11 22:27
localematcher.h	26.83 KB	-rw-r--r--	2023-12-11 22:27
localpointer.h	19.44 KB	-rw-r--r--	2023-12-11 22:27
locdspnm.h	7.12 KB	-rw-r--r--	2023-12-11 22:27
locid.h	48.27 KB	-rw-r--r--	2023-12-11 22:27
measfmt.h	11.42 KB	-rw-r--r--	2023-12-11 22:27
measunit.h	107.38 KB	-rw-r--r--	2023-12-11 22:27
measure.h	4.69 KB	-rw-r--r--	2023-12-11 22:27
messagepattern.h	33.72 KB	-rw-r--r--	2023-12-11 22:27
msgfmt.h	44.21 KB	-rw-r--r--	2023-12-11 22:27
normalizer2.h	34.73 KB	-rw-r--r--	2023-12-11 22:27
normlzr.h	30.97 KB	-rw-r--r--	2023-12-11 22:27
nounit.h	2.25 KB	-rw-r--r--	2023-12-11 22:27
numberformatter.h	90.03 KB	-rw-r--r--	2023-12-11 22:27
numberrangeformatter.h	25.32 KB	-rw-r--r--	2023-12-11 22:27
numfmt.h	50.26 KB	-rw-r--r--	2023-12-11 22:27
numsys.h	7.23 KB	-rw-r--r--	2023-12-11 22:27
parseerr.h	3.08 KB	-rw-r--r--	2023-12-11 22:27
parsepos.h	5.57 KB	-rw-r--r--	2023-12-11 22:27
platform.h	27.8 KB	-rw-r--r--	2023-12-11 22:27
plurfmt.h	25.25 KB	-rw-r--r--	2023-12-11 22:27
plurrule.h	20.64 KB	-rw-r--r--	2023-12-11 22:27
ptypes.h	3.49 KB	-rw-r--r--	2023-12-11 22:27
putil.h	6.32 KB	-rw-r--r--	2023-12-11 22:27
rbbi.h	32.07 KB	-rw-r--r--	2023-12-11 22:27
rbnf.h	49.92 KB	-rw-r--r--	2023-12-11 22:27
rbtz.h	15.77 KB	-rw-r--r--	2023-12-11 22:27
regex.h	84.45 KB	-rw-r--r--	2023-12-11 22:27
region.h	9.2 KB	-rw-r--r--	2023-12-11 22:27
reldatefmt.h	22.36 KB	-rw-r--r--	2023-12-11 22:27
rep.h	9.38 KB	-rw-r--r--	2023-12-11 22:27
resbund.h	18.11 KB	-rw-r--r--	2023-12-11 22:27
schriter.h	6.1 KB	-rw-r--r--	2023-12-11 22:27
scientificnumberformatter.h	6.44 KB	-rw-r--r--	2023-12-11 22:27
search.h	22.24 KB	-rw-r--r--	2023-12-11 22:27
selfmt.h	14.35 KB	-rw-r--r--	2023-12-11 22:27
simpleformatter.h	12.6 KB	-rw-r--r--	2023-12-11 22:27
simplenumberformatter.h	8.88 KB	-rw-r--r--	2023-12-11 22:27
simpletz.h	45.65 KB	-rw-r--r--	2023-12-11 22:27
smpdtfmt.h	71.85 KB	-rw-r--r--	2023-12-11 22:27
sortkey.h	11.19 KB	-rw-r--r--	2023-12-11 22:27
std_string.h	1.05 KB	-rw-r--r--	2023-12-11 22:27
strenum.h	9.96 KB	-rw-r--r--	2023-12-11 22:27
stringoptions.h	5.79 KB	-rw-r--r--	2023-12-11 22:27
stringpiece.h	10.05 KB	-rw-r--r--	2023-12-11 22:27
stringtriebuilder.h	15.5 KB	-rw-r--r--	2023-12-11 22:27
stsearch.h	21.44 KB	-rw-r--r--	2023-12-11 22:27
symtable.h	4.28 KB	-rw-r--r--	2023-12-11 22:27
tblcoll.h	36.94 KB	-rw-r--r--	2023-12-11 22:27
timezone.h	45.67 KB	-rw-r--r--	2023-12-11 22:27
tmunit.h	3.4 KB	-rw-r--r--	2023-12-11 22:27
tmutamt.h	4.91 KB	-rw-r--r--	2023-12-11 22:27
tmutfmt.h	7.42 KB	-rw-r--r--	2023-12-11 22:27
translit.h	65.83 KB	-rw-r--r--	2023-12-11 22:27
tzfmt.h	42.96 KB	-rw-r--r--	2023-12-11 22:27
tznames.h	16.85 KB	-rw-r--r--	2023-12-11 22:27
tzrule.h	34.86 KB	-rw-r--r--	2023-12-11 22:27
tztrans.h	6.13 KB	-rw-r--r--	2023-12-11 22:27
ubidi.h	89.61 KB	-rw-r--r--	2023-12-11 22:27
ubiditransform.h	12.71 KB	-rw-r--r--	2023-12-11 22:27
ubrk.h	24.43 KB	-rw-r--r--	2023-12-11 22:27
ucal.h	64.28 KB	-rw-r--r--	2023-12-11 22:27
ucasemap.h	15.21 KB	-rw-r--r--	2023-12-11 22:27
ucat.h	5.35 KB	-rw-r--r--	2023-12-11 22:27
uchar.h	145.7 KB	-rw-r--r--	2023-12-11 22:27
ucharstrie.h	22.56 KB	-rw-r--r--	2023-12-11 22:27
ucharstriebuilder.h	7.48 KB	-rw-r--r--	2023-12-11 22:27
uchriter.h	13.42 KB	-rw-r--r--	2023-12-11 22:27
uclean.h	11.21 KB	-rw-r--r--	2023-12-11 22:27
ucnv.h	83.46 KB	-rw-r--r--	2023-12-11 22:27
ucnv_cb.h	6.58 KB	-rw-r--r--	2023-12-11 22:27
ucnv_err.h	20.98 KB	-rw-r--r--	2023-12-11 22:27
ucnvsel.h	6.24 KB	-rw-r--r--	2023-12-11 22:27
ucol.h	62.7 KB	-rw-r--r--	2023-12-11 22:27
ucoleitr.h	9.82 KB	-rw-r--r--	2023-12-11 22:27
uconfig.h	12.31 KB	-rw-r--r--	2023-12-11 22:27
ucpmap.h	5.54 KB	-rw-r--r--	2023-12-11 22:27
ucptrie.h	22.51 KB	-rw-r--r--	2023-12-11 22:27
ucsdet.h	14.69 KB	-rw-r--r--	2023-12-11 22:27
ucurr.h	16.72 KB	-rw-r--r--	2023-12-11 22:27
udat.h	62.36 KB	-rw-r--r--	2023-12-11 22:27
udata.h	15.63 KB	-rw-r--r--	2023-12-11 22:27
udateintervalformat.h	11.93 KB	-rw-r--r--	2023-12-11 22:27
udatpg.h	30.13 KB	-rw-r--r--	2023-12-11 22:27
udisplaycontext.h	5.94 KB	-rw-r--r--	2023-12-11 22:27
udisplayoptions.h	8.86 KB	-rw-r--r--	2023-12-11 22:27
uenum.h	7.79 KB	-rw-r--r--	2023-12-11 22:27
ufieldpositer.h	4.41 KB	-rw-r--r--	2023-12-11 22:27
uformattable.h	10.97 KB	-rw-r--r--	2023-12-11 22:27
uformattednumber.h	8.09 KB	-rw-r--r--	2023-12-11 22:27
uformattedvalue.h	12.25 KB	-rw-r--r--	2023-12-11 22:27
ugender.h	2.06 KB	-rw-r--r--	2023-12-11 22:27
uidna.h	33.43 KB	-rw-r--r--	2023-12-11 22:27
uiter.h	22.75 KB	-rw-r--r--	2023-12-11 22:27
uldnames.h	10.48 KB	-rw-r--r--	2023-12-11 22:27
ulistformatter.h	10.78 KB	-rw-r--r--	2023-12-11 22:27
uloc.h	54.66 KB	-rw-r--r--	2023-12-11 22:27
ulocale.h	6.35 KB	-rw-r--r--	2023-12-11 22:27
ulocbuilder.h	16.72 KB	-rw-r--r--	2023-12-11 22:27
ulocdata.h	11.3 KB	-rw-r--r--	2023-12-11 22:27
umachine.h	15 KB	-rw-r--r--	2023-12-11 22:27
umisc.h	1.34 KB	-rw-r--r--	2023-12-11 22:27
umsg.h	24.25 KB	-rw-r--r--	2023-12-11 22:27
umutablecptrie.h	8.3 KB	-rw-r--r--	2023-12-11 22:27
unifilt.h	4 KB	-rw-r--r--	2023-12-11 22:27
unifunct.h	4.05 KB	-rw-r--r--	2023-12-11 22:27
unimatch.h	6.1 KB	-rw-r--r--	2023-12-11 22:27
unirepl.h	3.38 KB	-rw-r--r--	2023-12-11 22:27
uniset.h	66.85 KB	-rw-r--r--	2023-12-11 22:27
unistr.h	171.35 KB	-rw-r--r--	2023-12-11 22:27
unorm.h	20.55 KB	-rw-r--r--	2023-12-11 22:27
unorm2.h	25.71 KB	-rw-r--r--	2023-12-11 22:27
unum.h	55.16 KB	-rw-r--r--	2023-12-11 22:27
unumberformatter.h	19.68 KB	-rw-r--r--	2023-12-11 22:27
unumberoptions.h	5.23 KB	-rw-r--r--	2023-12-11 22:27
unumberrangeformatter.h	15.35 KB	-rw-r--r--	2023-12-11 22:27
unumsys.h	7.26 KB	-rw-r--r--	2023-12-11 22:27
uobject.h	10.66 KB	-rw-r--r--	2023-12-11 22:27
upluralrules.h	8.79 KB	-rw-r--r--	2023-12-11 22:27
uregex.h	71.99 KB	-rw-r--r--	2023-12-11 22:27
uregion.h	9.81 KB	-rw-r--r--	2023-12-11 22:27
ureldatefmt.h	16.98 KB	-rw-r--r--	2023-12-11 22:27
urename.h	140.82 KB	-rw-r--r--	2023-12-11 22:27
urep.h	5.38 KB	-rw-r--r--	2023-12-11 22:27
ures.h	36.65 KB	-rw-r--r--	2023-12-11 22:27
uscript.h	27.8 KB	-rw-r--r--	2023-12-11 22:27
usearch.h	39.21 KB	-rw-r--r--	2023-12-11 22:27
uset.h	45.61 KB	-rw-r--r--	2023-12-11 22:27
usetiter.h	9.63 KB	-rw-r--r--	2023-12-11 22:27
ushape.h	18 KB	-rw-r--r--	2023-12-11 22:27
usimplenumberformatter.h	7.46 KB	-rw-r--r--	2023-12-11 22:27
uspoof.h	80.32 KB	-rw-r--r--	2023-12-11 22:27
usprep.h	8.19 KB	-rw-r--r--	2023-12-11 22:27
ustdio.h	38.56 KB	-rw-r--r--	2023-12-11 22:27
ustream.h	1.89 KB	-rw-r--r--	2023-12-11 22:27
ustring.h	72.13 KB	-rw-r--r--	2023-12-11 22:27
ustringtrie.h	3.15 KB	-rw-r--r--	2023-12-11 22:27
utext.h	58.1 KB	-rw-r--r--	2023-12-11 22:27
utf.h	7.87 KB	-rw-r--r--	2023-12-11 22:27
utf16.h	23.35 KB	-rw-r--r--	2023-12-11 22:27
utf32.h	763 B	-rw-r--r--	2023-12-11 22:27
utf8.h	30.83 KB	-rw-r--r--	2023-12-11 22:27
utf_old.h	45.8 KB	-rw-r--r--	2023-12-11 22:27
utmscale.h	13.78 KB	-rw-r--r--	2023-12-11 22:27
utrace.h	17.18 KB	-rw-r--r--	2023-12-11 22:27
utrans.h	25.54 KB	-rw-r--r--	2023-12-11 22:27
utypes.h	31.06 KB	-rw-r--r--	2023-12-11 22:27
uvernum.h	6.33 KB	-rw-r--r--	2023-12-11 22:27
uversion.h	5.99 KB	-rw-r--r--	2023-12-11 22:27
vtzone.h	20.69 KB	-rw-r--r--	2023-12-11 22:27

Rename

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
*   Copyright (C) 2010-2012, International Business Machines
*   Corporation and others.  All Rights Reserved.
*******************************************************************************
*   file name:  idna.h
*   encoding:   UTF-8
*   tab size:   8 (not used)
*   indentation:4
*
*   created on: 2010mar05
*   created by: Markus W. Scherer
*/

#ifndef __IDNA_H__
#define __IDNA_H__

/**
 * \file
 * \brief C++ API: Internationalizing Domain Names in Applications (IDNA)
 */

#include "unicode/utypes.h"

#if U_SHOW_CPLUSPLUS_API

#if !UCONFIG_NO_IDNA

#include "unicode/bytestream.h"
#include "unicode/stringpiece.h"
#include "unicode/uidna.h"
#include "unicode/unistr.h"

U_NAMESPACE_BEGIN

class IDNAInfo;

/**
 * Abstract base class for IDNA processing.
 * See http://www.unicode.org/reports/tr46/
 * and http://www.ietf.org/rfc/rfc3490.txt
 *
 * The IDNA class is not intended for public subclassing.
 *
 * This C++ API currently only implements UTS #46.
 * The uidna.h C API implements both UTS #46 (functions using UIDNA service object)
 * and IDNA2003 (functions that do not use a service object).
 * @stable ICU 4.6
 */
class U_COMMON_API IDNA : public UObject {
public:
    /**
     * Destructor.
     * @stable ICU 4.6
     */
    ~IDNA();

/**
     * Returns an IDNA instance which implements UTS #46.
     * 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.
     *
     * UTS #46 defines Unicode IDNA Compatibility Processing,
     * updated to the latest version of Unicode and compatible with both
     * IDNA2003 and IDNA2008.
     *
     * 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.
     *
     * Disallowed characters are mapped to U+FFFD.
     *
     * For available options see the uidna.h header.
     * Operations with the UTS #46 instance do not support the
     * UIDNA_ALLOW_UNASSIGNED option.
     *
     * 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.
     *
     * @param options Bit set to modify the processing and error checking.
     *                See option bit set values in uidna.h.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return the UTS #46 IDNA instance, if successful
     * @stable ICU 4.6
     */
    static IDNA *
    createUTS46Instance(uint32_t options, UErrorCode &errorCode);

/**
     * Converts a single domain name label into its ASCII form for DNS lookup.
     * 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.
     *
     * The UErrorCode indicates an error only in exceptional cases,
     * such as a U_MEMORY_ALLOCATION_ERROR.
     *
     * @param label Input domain name label
     * @param dest Destination string object
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual UnicodeString &
    labelToASCII(const UnicodeString &label, UnicodeString &dest,
                 IDNAInfo &info, UErrorCode &errorCode) const = 0;

/**
     * Converts a single domain name label into its Unicode form for human-readable display.
     * If any processing step fails, then info.hasErrors() will be true.
     * The label might be modified according to the types of errors.
     *
     * The UErrorCode indicates an error only in exceptional cases,
     * such as a U_MEMORY_ALLOCATION_ERROR.
     *
     * @param label Input domain name label
     * @param dest Destination string object
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual UnicodeString &
    labelToUnicode(const UnicodeString &label, UnicodeString &dest,
                   IDNAInfo &info, UErrorCode &errorCode) const = 0;

/**
     * Converts a whole domain name into its ASCII form for DNS lookup.
     * 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.
     *
     * The UErrorCode indicates an error only in exceptional cases,
     * such as a U_MEMORY_ALLOCATION_ERROR.
     *
     * @param name Input domain name
     * @param dest Destination string object
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual UnicodeString &
    nameToASCII(const UnicodeString &name, UnicodeString &dest,
                IDNAInfo &info, UErrorCode &errorCode) const = 0;

/**
     * Converts a whole domain name into its Unicode form for human-readable display.
     * If any processing step fails, then info.hasErrors() will be true.
     * The domain name might be modified according to the types of errors.
     *
     * The UErrorCode indicates an error only in exceptional cases,
     * such as a U_MEMORY_ALLOCATION_ERROR.
     *
     * @param name Input domain name
     * @param dest Destination string object
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual UnicodeString &
    nameToUnicode(const UnicodeString &name, UnicodeString &dest,
                  IDNAInfo &info, UErrorCode &errorCode) const = 0;

// UTF-8 versions of the processing methods ---------------------------- ***

/**
     * Converts a single domain name label into its ASCII form for DNS lookup.
     * UTF-8 version of labelToASCII(), same behavior.
     *
     * @param label Input domain name label
     * @param dest Destination byte sink; Flush()ed if successful
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual void
    labelToASCII_UTF8(StringPiece label, ByteSink &dest,
                      IDNAInfo &info, UErrorCode &errorCode) const;

/**
     * Converts a single domain name label into its Unicode form for human-readable display.
     * UTF-8 version of labelToUnicode(), same behavior.
     *
     * @param label Input domain name label
     * @param dest Destination byte sink; Flush()ed if successful
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual void
    labelToUnicodeUTF8(StringPiece label, ByteSink &dest,
                       IDNAInfo &info, UErrorCode &errorCode) const;

/**
     * Converts a whole domain name into its ASCII form for DNS lookup.
     * UTF-8 version of nameToASCII(), same behavior.
     *
     * @param name Input domain name
     * @param dest Destination byte sink; Flush()ed if successful
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual void
    nameToASCII_UTF8(StringPiece name, ByteSink &dest,
                     IDNAInfo &info, UErrorCode &errorCode) const;

/**
     * Converts a whole domain name into its Unicode form for human-readable display.
     * UTF-8 version of nameToUnicode(), same behavior.
     *
     * @param name Input domain name
     * @param dest Destination byte sink; Flush()ed if successful
     * @param info Output container of IDNA processing details.
     * @param errorCode Standard ICU error code. Its input value must
     *                  pass the U_SUCCESS() test, or else the function returns
     *                  immediately. Check for U_FAILURE() on output or use with
     *                  function chaining. (See User Guide for details.)
     * @return dest
     * @stable ICU 4.6
     */
    virtual void
    nameToUnicodeUTF8(StringPiece name, ByteSink &dest,
                      IDNAInfo &info, UErrorCode &errorCode) const;
};

class UTS46;

/**
 * Output container for IDNA processing errors.
 * The IDNAInfo class is not suitable for subclassing.
 * @stable ICU 4.6
 */
class U_COMMON_API IDNAInfo : public UMemory {
public:
    /**
     * Constructor for stack allocation.
     * @stable ICU 4.6
     */
    IDNAInfo() : errors(0), labelErrors(0), isTransDiff(false), isBiDi(false), isOkBiDi(true) {}
    /**
     * Were there IDNA processing errors?
     * @return true if there were processing errors
     * @stable ICU 4.6
     */
    UBool hasErrors() const { return errors!=0; }
    /**
     * Returns a bit set indicating IDNA processing errors.
     * See UIDNA_ERROR_... constants in uidna.h.
     * @return bit set of processing errors
     * @stable ICU 4.6
     */
    uint32_t getErrors() const { return errors; }
    /**
     * Returns true if transitional and nontransitional processing produce different results.
     * This is the case when the input label or domain name contains
     * one or more deviation characters outside a Punycode label (see UTS #46).
     * <ul>
     * <li>With nontransitional processing, such characters are
     * copied to the destination string.
     * <li>With transitional processing, such characters are
     * mapped (sharp s/sigma) or removed (joiner/nonjoiner).
     * </ul>
     * @return true if transitional and nontransitional processing produce different results
     * @stable ICU 4.6
     */
    UBool isTransitionalDifferent() const { return isTransDiff; }

private:
    friend class UTS46;

IDNAInfo(const IDNAInfo &other) = delete;  // no copying
    IDNAInfo &operator=(const IDNAInfo &other) = delete;  // no copying

void reset() {
        errors=labelErrors=0;
        isTransDiff=false;
        isBiDi=false;
        isOkBiDi=true;
    }

uint32_t errors, labelErrors;
    UBool isTransDiff;
    UBool isBiDi;
    UBool isOkBiDi;
};

U_NAMESPACE_END

#endif  // UCONFIG_NO_IDNA

#endif /* U_SHOW_CPLUSPLUS_API */

#endif  // __IDNA_H__