iswcntrl Function

Test for a control wide character.

Attention: This function is implemented only by MPLAB XC32 C compilers.

Include

<wctype.h>

Prototype

int iswcntrl(wint_t wc);

Argument

wc
The wide character to test.

Return Value

Returns a non-zero integer value if the wide character, wc, is a control wide character; otherwise, returns a zero.

Remarks

A control wide character does not occupy any printing position on a display when printed.

Example

See the notes at the beginning of this chapter or section for information on using printf() or scanf() (and other functions reading and writing the stdin or stdout streams) in the example code.

#include <wctype.h>
#include <stdio.h>
#include <stdbool.h>

int main(void)
{
  wint_t wStr[] = L"A string, 2 wide 4 some.\n";
  wint_t wc;
  unsigned idx = 0;
  bool found = false;

  do {
    wc = wStr[idx];
    if(iswcntrl(wc)) {
      if( ! found)
        printf("Found matching wide char at position: ");
      printf("%s%u", found ? ", " : "", idx);
      found = true;
    }
    idx++;
  } while(wStr[idx]);
  printf("\n");
}

Example Output

Found matching wide char at position: 24