chr2utf8

Converts an ASCII character to a UTF-8 character.

Library:LibC
Service:Characters and Strings

Syntax

  #include <unilib.h> 
   
  int chr2utf8 (
     UniRuleTable_t   table,
     char            *dest,
     const char      *src,
     int             *used );
  

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 address of the converted character, which is null terminated.

src

(IN) Points to the source character. You do not need to null terminate the character, and you do not need to know the width of the character to be converted

used

(OUT) Points to the number of bytes in the UTF-8 character that was converted.

Return Values

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

Decimal

Name

Description

-532

UNI_ERR_UNMAPPABLE_CHAR

A character in the source is unmappable.

See Also