pr29.h File Reference

#include <stdlib.h>
#include <idn-int.h>

Go to the source code of this file.

Macros
#define	IDNAPI

Enumerations
enum	Pr29_rc { PR29_SUCCESS = 0 , PR29_PROBLEM = 1 , PR29_STRINGPREP_ERROR = 2 }

Functions
IDNAPI const char *	pr29_strerror (Pr29_rc rc)
IDNAPI int	pr29_4 (const uint32_t *in, size_t len)
IDNAPI int	pr29_4z (const uint32_t *in)
IDNAPI int	pr29_8z (const char *in)

Macro Definition Documentation

IDNAPI

#define IDNAPI

SECTION:pr29

Parameters

title	pr29.h
short_description	PR29-related functions

PR29-related functions.

Definition at line 49 of file pr29.h.

Enumeration Type Documentation

Pr29_rc

enum Pr29_rc

Enumerator
PR29_SUCCESS
PR29_PROBLEM
PR29_STRINGPREP_ERROR

Definition at line 65 of file pr29.h.

Function Documentation

pr29_4()

IDNAPI int pr29_4	(	const uint32_t *	in,
		size_t	len
	)

pr29_4:

Parameters

in	input array with unicode code points.
len	length of input array with unicode code points.

Check the input to see if it may be normalized into different strings by different NFKC implementations, due to an anomaly in the NFKC specifications.

Return value: Returns the Pr29_rc value PR29_SUCCESS on success, and PR29_PROBLEM if the input sequence is a "problem sequence" (i.e., may be normalized into different strings by different implementations).

Definition at line 1247 of file pr29.c.

pr29_4z()

IDNAPI int pr29_4z

(

const uint32_t *

in

)

pr29_4z:

Parameters

in	zero terminated array of Unicode code points.

Check the input to see if it may be normalized into different strings by different NFKC implementations, due to an anomaly in the NFKC specifications.

Return value: Returns the Pr29_rc value PR29_SUCCESS on success, and PR29_PROBLEM if the input sequence is a "problem sequence" (i.e., may be normalized into different strings by different implementations).

Definition at line 1288 of file pr29.c.

pr29_8z()

IDNAPI int pr29_8z

(

const char *

in

)

pr29_8z:

Parameters

in	zero terminated input UTF-8 string.

Check the input to see if it may be normalized into different strings by different NFKC implementations, due to an anomaly in the NFKC specifications.

Return value: Returns the Pr29_rc value PR29_SUCCESS on success, and PR29_PROBLEM if the input sequence is a "problem sequence" (i.e., may be normalized into different strings by different implementations), or PR29_STRINGPREP_ERROR if there was a problem converting the string from UTF-8 to UCS-4.

Definition at line 1313 of file pr29.c.

pr29_strerror()

IDNAPI const char* pr29_strerror

(

Pr29_rc

rc

)

pr29_strerror:

Parameters

rc	an Pr29_rc return code.

Convert a return code integer to a text string. This string can be used to output a diagnostic message to the user.

PR29_SUCCESS: Successful operation. This value is guaranteed to always be zero, the remaining ones are only guaranteed to hold non-zero values, for logical comparison purposes. PR29_PROBLEM: A problem sequence was encountered. PR29_STRINGPREP_ERROR: The character set conversion failed (only for pr29_8z()).

Return value: Returns a pointer to a statically allocated string containing a description of the error with the return code @rc.

Definition at line 57 of file strerror-pr29.c.