UniQueryCharType

UniQueryCharType is used to query the type of the character.

Syntax
UNICTYPE * UniQueryCharType (UniChar uc)

Parameters

 * uc (UniChar) : The Unicode character whose type will be queried.

Returns
A pointer to a structure of type UNICTYPE is returned from this call.

Remarks
UniQueryCharType is designed to provide information to support both the XPG/4 character type as well as the Win32 GetCharType type. Where the function is similar, this API is designed to be a superset of the Win32 function so that the Win32 functions can be supported by masking off bits in the returned data structure. GetCharType is similar to the C library "is" functions.

The UNICTYPE structure contains character set information, information regarding Bidirectional attributes, information regarding XPG/4 attributes and information on extended attributes.

Example
This example shows how to query a character type. 
 * 1) include 
 * 2) include 

int main(void) {

UNICTYPE  * uct; UniChar   uni_char = 0x3456;    /* Some random Unicode character */

/* Query the character type */ uct = UniQueryCharType(uni_char);

/* Examine the returned structure to determine information about * the character. For example, what is its BiDi orientation and * is the character Arabic or Hebrew? */    if (uct->bidi==C2_RIGHTTOLEFT) printf("Character is presented right to left\n"); else printf("Character is presented left to right\n");

if (uct->charset==CHS_ARABIC) printf("Character is Arabic\n"); else if (uct->charset==CHS_HEBREW) printf("Character is Hebrew\n"); else printf("Character is not Arabic or Hebrew\n");

return ULS_SUCCESS; } 

Format

 * 1) include 

UNICTYPE * UniQueryCharType (   UniChar uc    /* I  - Character to query */ ) 

Related Functions

 * UniQueryAttr
 * UniQueryChar
 * UniQueryCharAttr
 * UniQueryCharTypeTable