utf8n2uni

Converts a string from UTF-8 to Unicode.

Library:LibC
Service:Characters and Strings

Syntax

  #include <unilib.h> 
   
  int utf8n2uni (
     unicode_t    *dest,
     size_t       *destLen,
     const char   *src
     size_t        srcLen);
  

Parameters

dest

(OUT) Points to the converted string.

destLen

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

src

(IN) Points to the source string.

srcLen

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

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