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.

#include <stdio.h>
#include <unidef.h>

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

#include <unidef.h>

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

Related Functions