unin2locspecial

Converts a string from Unicode to the local display's code page.

Library:LibC
Service:Characters and Strings

Syntax

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

Parameters

handle

(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.

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.

srcLen

(IN) Specifies the number of Unicode characters in the source string.

Return Values

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

Decimal

Name

Description

-496

UNI_ERR_BAD_HANDLE

The table parameter specifies a nonexistent rule table.

-532

UNI_ERR_UNMAPPABLE_CHAR

A character in the source is unmappable.

See Also