utf8n2loc

Syntax

  #include <unilib.h> 
   
  int utf8n2loc (
     UniRuleTable_t   table,
     char            *dest,
     size_t          *destLen,
     const char      *src,
     size_t           srcLen,
     char             noMapCh,
     int              noMapFlag);
  

Parameters

table

(IN) Specifies the table to use for the conversion. To use the host's default code page, specify UNI_LOCAL_DEFAULT. Otherwise, specify the value returned from the UniGetTable function.

dest

(OUT) Points to the converted string.

destLen

(IN/OUT) Points to the maximum number of bytes that the destination string can hold when the function is called. When the function returns, it contains the number of bytes in the converted string.

src

(IN) Points to the source string in UTF-8 format.

srcLen

(IN) Specifies the number of UTF-8 characters in the source string.

noMapCh

(IN) Specifies an arbitrary character to be used in place of a source character for which no mapping can be found in the table. The noMapFlag parameter determines whether this character is used.

noMapFlag

(IN) Specifies whether to replace an unmappable character or simply return an error. It uses one of the following flags:

Flag	Value	Description
UNI_MAP_NO_CHAR	0	Returns the UNI_ERR_UNMAPPABLE_CHAR error code as soon as a character is found to be unmappable. The result is null-terminated at the offending position in the string.
UNI_MAP_CHAR	1	Uses the value in noMapCh for all unmappable characters.
UNI_MAP_SELF	2	Uses the source character. In many cases this does not result in anything useful.

Return Values

If successful, returns 0. Otherwise, returns a negative error code:

See Also

• locn2utf8
• utf82loc
• utf8nx2loc