Movatterモバイル変換

Go to the documentation of this file.

2 // License & terms of use: http://www.unicode.org/copyright.html

3 /*

4 *******************************************************************************

7 *******************************************************************************

8 * file name: idna.h

9 * encoding: UTF-8

10 * tab size: 8 (not used)

11 * indentation:4

12 *

13 * created on: 2010mar05

14 * created by: Markus W. Scherer

15 */

17 #ifndef __IDNA_H__

18 #define __IDNA_H__

25 #include "unicode/utypes.h"

27 #if U_SHOW_CPLUSPLUS_API

29 #if !UCONFIG_NO_IDNA

31 #include "unicode/bytestream.h"

32 #include "unicode/stringpiece.h"

33 #include "unicode/uidna.h"

34 #include "unicode/unistr.h"

36 U_NAMESPACE_BEGIN

38 classIDNAInfo;

52 classU_COMMON_API IDNA :publicUObject {

53 public:

58 ~IDNA();

96 staticIDNA *

97 createUTS46Instance(uint32_t options,UErrorCode &errorCode);

119 virtualUnicodeString &

120 labelToASCII(constUnicodeString &label,UnicodeString &dest,

121 IDNAInfo &info,UErrorCode &errorCode)const = 0;

122

141 virtualUnicodeString &

142 labelToUnicode(constUnicodeString &label,UnicodeString &dest,

143 IDNAInfo &info,UErrorCode &errorCode)const = 0;

144

165 virtualUnicodeString &

166 nameToASCII(constUnicodeString &name,UnicodeString &dest,

167 IDNAInfo &info,UErrorCode &errorCode)const = 0;

168

187 virtualUnicodeString &

188 nameToUnicode(constUnicodeString &name,UnicodeString &dest,

189 IDNAInfo &info,UErrorCode &errorCode)const = 0;

190

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

192

207 virtualvoid

208 labelToASCII_UTF8(StringPiece label,ByteSink &dest,

209 IDNAInfo &info,UErrorCode &errorCode)const;

210

225 virtualvoid

226 labelToUnicodeUTF8(StringPiece label,ByteSink &dest,

227 IDNAInfo &info,UErrorCode &errorCode)const;

228

243 virtualvoid

244 nameToASCII_UTF8(StringPiece name,ByteSink &dest,

245 IDNAInfo &info,UErrorCode &errorCode)const;

246

261 virtualvoid

262 nameToUnicodeUTF8(StringPiece name,ByteSink &dest,

263 IDNAInfo &info,UErrorCode &errorCode)const;

264 };

265

266 classUTS46;

267

273 classU_COMMON_API IDNAInfo :publicUMemory {

274 public:

279 IDNAInfo() : errors(0), labelErrors(0), isTransDiff(false), isBiDi(false), isOkBiDi(true) {}

285 UBool hasErrors() const{return errors!=0; }

292 uint32_tgetErrors() const{return errors; }

306 UBool isTransitionalDifferent() const{return isTransDiff; }

307

308 private:

309 friendclassUTS46;

310

311 IDNAInfo(constIDNAInfo &other) =delete;// no copying

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

313

314 void reset() {

315 errors=labelErrors=0;

316 isTransDiff=false;

317 isBiDi=false;

318 isOkBiDi=true;

319 }

320

321 uint32_t errors, labelErrors;

322 UBool isTransDiff;

323 UBool isBiDi;

324 UBool isOkBiDi;

325 };

326

327 U_NAMESPACE_END

328

329 #endif// UCONFIG_NO_IDNA

330

331 #endif/* U_SHOW_CPLUSPLUS_API */

332

333 #endif// __IDNA_H__

bytestream.h

C++ API: Interface for writing bytes, and implementation classes.

icu::ByteSink

A ByteSink can be filled with bytes.

Definition:bytestream.h:55

icu::IDNAInfo

Output container for IDNA processing errors.

Definition:idna.h:273

icu::IDNAInfo::getErrors

uint32_t getErrors() const

Returns a bit set indicating IDNA processing errors.

Definition:idna.h:292

icu::IDNAInfo::hasErrors

UBool hasErrors() const

Were there IDNA processing errors?

Definition:idna.h:285

icu::IDNAInfo::isTransitionalDifferent

UBool isTransitionalDifferent() const

Returns true if transitional and nontransitional processing produce different results.

Definition:idna.h:306

icu::IDNAInfo::IDNAInfo

IDNAInfo()

Constructor for stack allocation.

Definition:idna.h:279

icu::IDNA

Abstract base class for IDNA processing.

Definition:idna.h:52

icu::IDNA::labelToASCII_UTF8

virtual void labelToASCII_UTF8(StringPiece label, ByteSink &dest, IDNAInfo &info, UErrorCode &errorCode) const

Converts a single domain name label into its ASCII form for DNS lookup.

icu::IDNA::nameToASCII_UTF8

virtual void nameToASCII_UTF8(StringPiece name, ByteSink &dest, IDNAInfo &info, UErrorCode &errorCode) const

Converts a whole domain name into its ASCII form for DNS lookup.

icu::IDNA::labelToUnicode

virtual UnicodeString & labelToUnicode(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.

icu::IDNA::nameToUnicodeUTF8

virtual void nameToUnicodeUTF8(StringPiece name, ByteSink &dest, IDNAInfo &info, UErrorCode &errorCode) const

Converts a whole domain name into its Unicode form for human-readable display.

icu::IDNA::labelToUnicodeUTF8

virtual void labelToUnicodeUTF8(StringPiece label, ByteSink &dest, IDNAInfo &info, UErrorCode &errorCode) const

Converts a single domain name label into its Unicode form for human-readable display.

icu::IDNA::nameToASCII

virtual UnicodeString & nameToASCII(const UnicodeString &name, UnicodeString &dest, IDNAInfo &info, UErrorCode &errorCode) const =0

Converts a whole domain name into its ASCII form for DNS lookup.

icu::IDNA::createUTS46Instance

static IDNA * createUTS46Instance(uint32_t options, UErrorCode &errorCode)

Returns an IDNA instance which implements UTS #46.

icu::IDNA::~IDNA

~IDNA()

Destructor.

icu::IDNA::labelToASCII

virtual UnicodeString & labelToASCII(const UnicodeString &label, UnicodeString &dest, IDNAInfo &info, UErrorCode &errorCode) const =0

Converts a single domain name label into its ASCII form for DNS lookup.

icu::IDNA::nameToUnicode

virtual UnicodeString & nameToUnicode(const UnicodeString &name, UnicodeString &dest, IDNAInfo &info, UErrorCode &errorCode) const =0

Converts a whole domain name into its Unicode form for human-readable display.

icu::StringPiece

A string-like object that points to a sized piece of memory.

Definition:stringpiece.h:61

icu::UMemory

UMemory is the common ICU base class.

Definition:uobject.h:115

icu::UObject

UObject is the common ICU "boilerplate" class.

Definition:uobject.h:222

icu::UnicodeString

UnicodeString is a string class that stores Unicode characters directly and provides similar function...

Definition:unistr.h:303

stringpiece.h

C++ API: StringPiece: Read-only byte string wrapper class.

uidna.h

C API: Internationalizing Domain Names in Applications (IDNA)

UBool

int8_t UBool

The ICU boolean type, a signed-byte integer.

Definition:umachine.h:269

unistr.h

C++ API: Unicode String.

utypes.h

Basic definitions for ICU, for both C and C++ APIs.

UErrorCode

Standard ICU4C error code type, a substitute for exceptions.

Definition:utypes.h:509

U_COMMON_API

#define U_COMMON_API

Set to export library symbols from inside the common library, and to import them from outside.

Definition:utypes.h:315