/** @file  ../include/wctype.h

@internalComponent

*/

/** @fn  iswalnum(wint_t i)

@param i

@return   The functions return non-zero if i is wide alphabet or wide digit and zero otherwise.

 The iswalnum() function tests whether 'i' is a wide alphabet or wide digit i.e. it belongs to class alnum(see defns for definition).

 The result of this function is undefined unless

the argument is WEOF or a valid wchar_t

value.

 The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class alnum, irrespective of the locale they belong to.

Examples:

@code

#include<wctype.h> //iswalnum()

#include<stdio.h>  //printf()

void test_iswalnum()

{

   int arr[]={'8',0xe1,'5','Z',0xfd,0xFF12,0xFF19,0xFF71,0x03A3};

   int i = 0;

   int size = 9;

   for( i=0; i<size; i++)

   {

     int ret = iswalnum(arr[i]); //call to the API with chars in the arr[]

     if( (!ret) != 0 )

     {

        printf("

%lc is not wide alnum", arr[i]);

     }

     else

     {

        printf("

%lc is a wide alnum ", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

8 is wide alnum

«¡ is wide alnum

5 is wide alnum

Z is wide alnum

«ò is wide alnum

£² is wide alnum

£¹ is wide alnum

± is wide alnum

¦² is wide alnum

@endcode

@see isalnum()

@see iswctype()

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswalpha(wint_t i)

@param i

@return   The functions return non-zero if 'i' is a wide alphabet and zero otherwise.

 The iswalpha() function tests whether 'i' is a wide alphabet i.e. 

  it belongs to class alpha (see defns for definition).

 The result of this function is undefined unless

the argument is WEOF or a valid wchar_t

value.

 The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class alpha, irrespective of the locale they belong to.

Examples:

@code

#include<wctype.h> //iswalpha()

#include<stdio.h>  //printf()

void test_iswalpha()

{

   int arr[]={'a',0xe1,'5','Z',0xfd, 0x3041,0xFF9D,0x009F,0x007E};

   int i = 0;

   int size = 9;

   for( i=0; i<size; i++)

   {

     int ret = iswalpha(arr[i]); //call to API with chars in arr[]

     if( (!ret) != 0 )

     {

        printf("

%lc is not wide alphabet", arr[i]);

     }

     else

     {

        printf("

%lc is wide alphabet", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

a is wide alphabet

«¡ is wide alphabet

5 is not wide alphabet

Z is wide alphabet

«ò is wide alphabet

¤¡ is wide alphabet

Ý is wide alphabet

 is not wide alphabet

~ is not wide alphabet

@endcode

@see isalpha()

@see iswctype()

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswblank(wint_t i)

@param i

@return   The functions return non-zero if 'i' is wide blank character and zero otherwise.

 The iswblank() function tests whether 'i' is a wide-character that belongs to the

character class - blank (see defns for definition).

The character class blank contains the character space('') and the horizontal tabulation(' ').

 The result of this function is undefined unless

the argument is WEOF or a valid wchar_t

value.

 The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class blank, irrespective of the locale they belong to.

Examples:

@code

#include<wctype.h> //iswblank()

#include<stdio.h> //printf()

int test_iswblank()

{

   int arr[]={0x0020,'0',0x0009,'R',0x3000, 0x000A, 0x002};

   int i = 0;

   int size = 7;

   for( i=0; i<size; i++)

   {

     int ret = iswblank(arr[i]); //call to the API with the chars in arr[]

     if( (!ret) != 0 )

     {

        printf("

%lc is not wide blank ", arr[i]);

     }

     else

     {

        printf("

%lc is wide blank", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

is wide blank

0 is not wide blank

     is wide blank

R is not wide blank

¡¡ is wide blank

 is not wide blank

 is not wide blank

@endcode

@see iswctype()

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswcntrl(wint_t i)

@param i

@return   The functions return non-zero if 'i' is a wide control character and returns zero otherwise.

 The iswcntrl() function tests whether 'i' is a wide control character 

  i.e it belongs to class cntrl (see defns for definition).

 The result of this function is undefined unless

the argument is WEOF or a valid wchar_t

value.

 The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class cntrl, irrespective of the locale they belong to.

 The control characters are:

 BELL

 DELETE

 BACKSPACE

 LINE FEED

 VERTICAL TABULATION

 FORM FEED

 CARRIAGE RETURN...and the like.

Examples:

@code

#include<wctype.h> //iswcntrl()

#include<stdio.h> //printf()

int test_iswcntrl()

{

   int arr[]={0x7F,'9','A','$','\a'};

   int i = 0;

   int size = 5;

   for( i=0; i<size; i++)

   {

     int ret = iswcntrl(arr[i]); //call to API with chars in arr[]

     if( (!ret) != 0 )

     {

        printf("

%lc is not wide cntrl char ", arr[i]);

     }

     else

     {

        printf("

%lc is wide cntrl char", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

is wide cntrl char

9 is not wide cntrl char

A is not wide cntrl char

$ is not wide cntrl char

 is wide cntrl char

@endcode

@see iswcntrl()

@see iswctype()

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswctype(wint_t wc, wctype_t charclass)

@param wc

@param charclass

Note: This description also covers the following functions -

 wctype() 

@return   The iswctype function returns non-zero if, and only if, wc has the property described by charclass , or charclass is zero. The wctype function returns 0 if property is invalid, otherwise it returns a value of type wctype_t

that can be used in subsequent calls to iswctype .

The iswctype() function tests whether the wide-character wch belongs to the character class/category chcl. 

The result of this function is undefined unless the argument is WEOF or a valid wchar_t value. 

The functionality of this API is independent of the program’s current locale and so it returns non-zero for all the characters given in ’wch’(of various locales supported) that belong to the class chcl(see _ctype.h for definition of values that can be used to specify category), irrespective of the locale they belong to. 

For example: digits 0 to 9 would belong to _CTYPE_D class (i.e. class digit), and a to z would belong to _CTYPE_L class (i.e. class lower).

Examples:

 Reimplement iswalpha in terms of iswctype and wctype :

@code

int

myiswalpha(wint_t wc)

{

        return (iswctype(wc, wctype("alpha")));

}

@endcode

@code

#include <wchar.h>

/* Illustrates how to use wctype API */

wctype_t example_wctype()

{  

 wctype_t type;

  /* get the type by passing the operation string to the wctype API */

 type = wctype("alnum");

 /* if the operation is successful then it should return non-zero value */

 /* else returns 0 */

  return type;

}

@endcode

Limitations:

The current implementation of iswctype and wctype is dependent on the locale support of Symbian OS. It doesn't work for the locales which the Symbian OS

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswdigit(wint_t i)

@param i

@return   The functions return non-zero if 'i' is a wide digit and zero otherwise.

 The iswdigit() function tests whether 'i' is a wide digit.

The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class digit(see defns for definition), irrespective of the locale they belong to.

 For example, the digits 0 to 9 fall under class digit.

Examples:

@code

#include<wctype.h> //iswdigit()

#include<stdio.h> //printf()

void test_iswdigit()

{

   int arr[]={'8',0xe1,'5','Z',0xfd,

   0xFF12,0xFF19,0xFF71,0x03A3};

   int i = 0;

   int size = 9;

   for( i=0; i<size; i++)

   {

     int ret = iswdigit(arr[i]); //call to the API with chars in arr[]

     if( (!ret) != 0 )

     {

         printf("

%lc is not a wide digit", arr[i]);

     }

     else

     {

         printf("

%lc is a wide digit", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

8 is wide digit

«¡ is not wide digit

5 is wide digit

Z is not wide digit

«ò is not wide digit

£² is wide digit

£¹ is wide digit

±  is not wide digit

¦²  is not wide digit

@endcode

@see isdigit()

@see iswctype()

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswgraph(wint_t i)

@param i

@return   The function returns non-zero if 'i' has visual representation and zero otherwise.

 The iswgraph() function tests whether 'wch' is a visible wide-character 

  i.e it belongs to class graph (see defns for definition).

 The result of this function is undefined unless

the argument is WEOF or a valid wchar_t

value.

 The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class graph, irrespective of the locale they belong to.

Examples:

@code

#include<wctype.h>

#include<stdio.h>

int test_iswgraph()

{

   int arr[]={'n','\f', 0xe1, '6', ' '};

   int i = 0;

   int size = 5;

   for( i=0; i<size; i++)

   {

     int ret = iswgraph(arr[i]);

     if( (!ret) != 0 )

     {

        printf("

%lc is not wide visible char ", arr[i]);

     }

     else

     {

        printf("

%lc is wide visible char", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

n is wide visible char

 is not wide visible char

«¡ is wide visible char

6 is wide visible char

  is not wide visible char

@endcode

@see isgraph()

@see iswctype()

@publishedAll

@externallyDefinedApi

*/

/** @fn  iswlower(wint_t i)

@param i

@return   The function returns non-zero if 'i' is wide lower-case and zero otherwise.

 The iswlower() function tests whether 'i' is a wide-character which is from among lower-case alphabets.

 Characters that belong to class cntrl, class punct and digit are not a part 

  of class lower (see defns for definition).

 The result of this function is undefined unless

the argument is WEOF or a valid wchar_t

value.

 The functionality of this API is independent of the program's current locale and so it returns non-zero for all the characters (of various locales supported) that belong to the class lower(see defns for definition), irrespective of the locale they belong to.

Examples:

@code

#include<wctype.h> //iswlower()

#include<stdio.h> //printf()

int test_iswlower()

{

   int arr[]={ 0x0126, 0xee, 'r' , '9' , 'g', 0xFF51, 0x0451, 0x03CE };

   int i = 0;

   int size = 8;

   for( i=0; i<size; i++)

   {

     int ret = iswlower(arr[i]); //call to the API with chars in arr[]

     if( (!ret) != 0 )

     {

        printf("

%lc is not wide lower-case ", arr[i]);

     }

     else

     {

        printf("

%lc is wide lower-case", arr[i]);

     }

   }

printf("

");

}

@endcode

 Output

@code

©¤ is not wide lower-case

«Â is wide lower-case

r is wide lower-case

9 is not wide lower-case

g is wide lower-case