# iswctype

> C++ Atlas: `cppatlas.com/w/c/string/wide/iswctype` | Source: https://en.cppreference.com/w/c/string/wide/iswctype | Domain: Strings | Standards: C95

Classifies the wide character wc using the current C locale's LC_CTYPE category identified by desc.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <wctype.h>
int iswctype( wint_t wc, wctype_t desc ); // (since C95)
```

Classifies the wide character `wc` using the current C locale's `LC_CTYPE` category identified by `desc`.

### Parameters

- `wc` - the wide character to classify
- `desc` - the `LC_CTYPE` category, obtained from a call to `wctype`

### Return value

Non-zero if the character `wc` has the property identified by `desc` in `LC_CTYPE` facet of the current C locale, zero otherwise.

### Example

```c
#include <locale.h>
#include <stdio.h>
#include <wchar.h>
#include <wctype.h>

const char* classify(wchar_t wc, const char* cat)
{
    return iswctype(wc, wctype(cat)) ? "true" : "false";
}

int main(void)
{
    setlocale(LC_ALL, "ja_JP.UTF-8");
    puts("The character \u6c34 is...");
    const char* cats[] = {"digit", "alpha", "space", "cntrl", "jkanji"};
    for (int n = 0; n < 5; ++n)
        printf("%s?\t%s\n", cats[n], classify(L'\u6c34', cats[n]));
}
```

Output:

```text
The character 水 is...
digit?  false
alpha?  true
space?  false
cntrl?  false
jkanji? true
```

### References

- C23 standard (ISO/IEC 9899:2024):

  - 7.30.2.2.1 The iswctype function (p: TBD)

- C17 standard (ISO/IEC 9899:2018):

  - 7.30.2.2.1 The iswctype function (p: TBD)

- C11 standard (ISO/IEC 9899:2011):

  - 7.30.2.2.1 The iswctype function (p: 451-452)

- C99 standard (ISO/IEC 9899:1999):

  - 7.25.2.2.1 The iswctype function (p: 397-398)

### See also

- [`wctype`](https://en.cppreference.com/w/c/string/wide/wctype) (C95): looks up a character classification category in the current C locale (function)

---
Attribution: content from https://en.cppreference.com/w/c/string/wide/iswctype (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.