---

OCI Character Classification Functions

Table 21-6 lists the OCI character classification functions.

Table 21-6 OCI Character Classification Functions

Function/Page	Purpose
OCIWideCharIsAlnum()	Tests whether the wide character is a letter or a decimal digit.
OCIWideCharIsAlpha()	Tests whether the wide character is an alphabetic letter.
OCIWideCharIsCntrl()	Tests whether the wide character is a control character.
OCIWideCharIsDigit()	Tests whether the wide character is a decimal digital character.
OCIWideCharIsGraph()	Tests whether the wide character is a graph character.
OCIWideCharIsLower()	Tests whether the wide character is a lowercase character.
OCIWideCharIsPrint()	Tests whether the wide character is a printable character.
OCIWideCharIsPunct()	Tests whether the wide character is a punctuation character.
OCIWideCharIsSingleByte()	Tests whether the wide character is a single-byte character when converted to multibyte.
OCIWideCharIsSpace()	Tests whether the wide character is a space character.
OCIWideCharIsUpper()	Tests whether the wide character is an uppercase character.
OCIWideCharIsXdigit()	Tests whether the wide character is a hexadecimal digit.

---

OCIWideCharIsAlnum()

Purpose

Tests whether a wide character is a letter or decimal digit.

Syntax

boolean OCIWideCharIsAlnum ( dvoid      *hndl,
                             OCIWchar   wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsAlpha()

Purpose

Tests whether a wide character is an alphabetic letter.

Syntax

boolean OCIWideCharIsAlpha ( dvoid     *hndl, 
                             OCIWchar  wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsCntrl()

Purpose

Tests whether a wide character is a control character.

Syntax

boolean OCIWideCharIsCntrl ( dvoid       *hndl, 
                             OCIWchar    wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsDigit()

Purpose

Tests whether a wide character is a decimal digit character.

Syntax

boolean OCIWideCharIsDigit ( dvoid      *hndl, 
                             OCIWchar   wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsGraph()

Purpose

Tests whether a wide character is a graph character. A graph character is a character with a visible representation and normally includes alphabetic letters, decimal digits, and punctuation.

Syntax

boolean OCIWideCharIsGraph ( dvoid     *hndl, 
                           OCIWchar    wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsLower()

Purpose

Tests whether a wide character is a lowercase letter.

Syntax

boolean OCIWideCharIsLower ( dvoid      *hndl, 
                             OCIWchar    wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsPrint()

Purpose

Tests whether a wide character is a printable character.

Syntax

boolean OCIWideCharIsPrint ( dvoid     *hndl, 
                             OCIWchar  wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsPunct()

Purpose

Tests whether a wide character is a punctuation character.

Syntax

boolean OCIWideCharIsPunct ( dvoid      *hndl, 
                             OCIWchar   wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsSingleByte()

Purpose

Tests whether a wide character is a single-byte character when converted into multibyte.

Syntax

boolean OCIWideCharIsSingleByte ( dvoid     *hndl, 
                                  OCIWchar  wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsSpace()

Purpose

Tests whether a wide character is a space character. A space character causes white space only in displayed text (for example, space, tab, carriage return, new line, vertical tab or form feed).

Syntax

boolean OCIWideCharIsSpace ( dvoid    *hndl, 
                             OCIWchar wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsUpper()

Purpose

Tests whether a wide character is an uppercase letter

Syntax

boolean OCIWideCharIsUpper ( dvoid     *hndl, 
                             OCIWchar  wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.

---

OCIWideCharIsXdigit()

Purpose

Tests whether a wide character is a hexadecimal digit (0-9, A-F, a-f)

Syntax

boolean OCIWideCharIsXdigit ( dvoid     *hndl, 
                              OCIWchar  wc );

Parameters

hndl (IN/OUT)

OCI environment or user session handle to determine the character set.

wc (IN)

wchar for testing.

Returns

TRUE or FALSE.