pr29.h File Reference

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

Go to the source code of this file.

Defines

#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)


Define Documentation

#define IDNAPI

Definition at line 33 of file pr29.h.


Enumeration Type Documentation

enum Pr29_rc

Enumerator:
PR29_SUCCESS 
PR29_PROBLEM 
PR29_STRINGPREP_ERROR 

Definition at line 49 of file pr29.h.


Function Documentation

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

pr29_4 - check if input trigger Unicode normalization bugs

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 1239 of file pr29.c.

IDNAPI int pr29_4z ( const uint32_t *  in  ) 

pr29_4z - check if input trigger Unicode normalization bugs

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 1280 of file pr29.c.

IDNAPI int pr29_8z ( const char *  in  ) 

pr29_8z - check if input trigger Unicode normalization bugs

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 1305 of file pr29.c.

IDNAPI const char* pr29_strerror ( Pr29_rc  rc  ) 

pr29_strerror - return string describing pr29 error code

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_8() and pr29_8z()).

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

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


Generated on Tue Sep 8 13:18:12 2009 for libidn by  doxygen 1.5.5