119 lines
5.2 KiB
C
119 lines
5.2 KiB
C
// © 2016 and later: Unicode, Inc. and others.
|
|
// License & terms of use: http://www.unicode.org/copyright.html
|
|
/*
|
|
******************************************************************************
|
|
*
|
|
* Copyright (C) 2003, International Business Machines
|
|
* Corporation and others. All Rights Reserved.
|
|
*
|
|
******************************************************************************
|
|
*/
|
|
/*
|
|
punycode.c from draft-ietf-idn-punycode-03
|
|
http://www.nicemice.net/idn/
|
|
Adam M. Costello
|
|
http://www.nicemice.net/amc/
|
|
|
|
This is ANSI C code (C89) implementing
|
|
Punycode (draft-ietf-idn-punycode-03).
|
|
|
|
Disclaimer and license
|
|
|
|
Regarding this entire document or any portion of it (including
|
|
the pseudocode and C code), the author makes no guarantees and
|
|
is not responsible for any damage resulting from its use. The
|
|
author grants irrevocable permission to anyone to use, modify,
|
|
and distribute it in any way that does not diminish the rights
|
|
of anyone else to use, modify, and distribute it, provided that
|
|
redistributed derivative works do not contain misleading author or
|
|
version information. Derivative works need not be licensed under
|
|
similar terms.
|
|
|
|
*/
|
|
#ifndef _PUNYREF_H
|
|
#define _PUNYREF_H
|
|
|
|
/************************************************************/
|
|
/* Public interface (would normally go in its own .h file): */
|
|
|
|
#include "unicode/utypes.h"
|
|
|
|
#if !UCONFIG_NO_IDNA
|
|
|
|
enum punycode_status {
|
|
punycode_success,
|
|
punycode_bad_input, /* Input is invalid. */
|
|
punycode_big_output, /* Output would exceed the space provided. */
|
|
punycode_overflow /* Input needs wider integers to process. */
|
|
};
|
|
|
|
|
|
typedef uint32_t punycode_uint;
|
|
|
|
U_CDECL_BEGIN
|
|
|
|
enum punycode_status punycode_encode(
|
|
punycode_uint input_length,
|
|
const punycode_uint input[],
|
|
const unsigned char case_flags[],
|
|
punycode_uint *output_length,
|
|
char output[] );
|
|
|
|
/* punycode_encode() converts Unicode to Punycode. The input */
|
|
/* is represented as an array of Unicode code points (not code */
|
|
/* units; surrogate pairs are not allowed), and the output */
|
|
/* will be represented as an array of ASCII code points. The */
|
|
/* output string is *not* null-terminated; it will contain */
|
|
/* zeros if and only if the input contains zeros. (Of course */
|
|
/* the caller can leave room for a terminator and add one if */
|
|
/* needed.) The input_length is the number of code points in */
|
|
/* the input. The output_length is an in/out argument: the */
|
|
/* caller passes in the maximum number of code points that it */
|
|
/* can receive, and on successful return it will contain the */
|
|
/* number of code points actually output. The case_flags array */
|
|
/* holds input_length boolean values, where nonzero suggests that */
|
|
/* the corresponding Unicode character be forced to uppercase */
|
|
/* after being decoded (if possible), and zero suggests that */
|
|
/* it be forced to lowercase (if possible). ASCII code points */
|
|
/* are encoded literally, except that ASCII letters are forced */
|
|
/* to uppercase or lowercase according to the corresponding */
|
|
/* uppercase flags. If case_flags is a null pointer then ASCII */
|
|
/* letters are left as they are, and other code points are */
|
|
/* treated as if their uppercase flags were zero. The return */
|
|
/* value can be any of the punycode_status values defined above */
|
|
/* except punycode_bad_input; if not punycode_success, then */
|
|
/* output_size and output might contain garbage. */
|
|
|
|
enum punycode_status punycode_decode(
|
|
punycode_uint input_length,
|
|
const char input[],
|
|
punycode_uint *output_length,
|
|
punycode_uint output[],
|
|
unsigned char case_flags[] );
|
|
|
|
/* punycode_decode() converts Punycode to Unicode. The input is */
|
|
/* represented as an array of ASCII code points, and the output */
|
|
/* will be represented as an array of Unicode code points. The */
|
|
/* input_length is the number of code points in the input. The */
|
|
/* output_length is an in/out argument: the caller passes in */
|
|
/* the maximum number of code points that it can receive, and */
|
|
/* on successful return it will contain the actual number of */
|
|
/* code points output. The case_flags array needs room for at */
|
|
/* least output_length values, or it can be a null pointer if the */
|
|
/* case information is not needed. A nonzero flag suggests that */
|
|
/* the corresponding Unicode character be forced to uppercase */
|
|
/* by the caller (if possible), while zero suggests that it be */
|
|
/* forced to lowercase (if possible). ASCII code points are */
|
|
/* output already in the proper case, but their flags will be set */
|
|
/* appropriately so that applying the flags would be harmless. */
|
|
/* The return value can be any of the punycode_status values */
|
|
/* defined above; if not punycode_success, then output_length, */
|
|
/* output, and case_flags might contain garbage. On success, the */
|
|
/* decoder will never need to write an output_length greater than */
|
|
/* input_length, because of how the encoding is defined. */
|
|
U_CDECL_END
|
|
|
|
#endif /* #if !UCONFIG_NO_IDNA */
|
|
|
|
#endif
|