loc2uni

Syntax

  #include <unilib.h> 
   
  int loc2uni (
     UniRuleTable_t   table, 
     unicode_t       *dest,
     const char      *src,
     unicode_t        noMapCh,
     int              noMapFlag);
  

Parameters

table

(IN) Specifies the table to use in 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.

src

(IN) Points to 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

• locn2uni
• locnx2uni
• uni2loc