libc/newlib/libc/ctype/iscntrl.c

53 lines
1.2 KiB
C
Raw Normal View History

2000-02-17 20:39:52 +01:00
/*
FUNCTION
<<iscntrl>>, <<iscntrl_l>>---control character predicate
2000-02-17 20:39:52 +01:00
INDEX
iscntrl
INDEX
iscntrl_l
SYNOPSIS
2000-02-17 20:39:52 +01:00
#include <ctype.h>
int iscntrl(int <[c]>);
#include <ctype.h>
int iscntrl_l(int <[c]>, locale_t <[locale]>);
2000-02-17 20:39:52 +01:00
DESCRIPTION
<<iscntrl>> is a macro which classifies singlebyte charset values by table
2000-02-17 20:39:52 +01:00
lookup. It is a predicate returning non-zero for control characters, and 0
for other characters. It is defined only if <[c]> is representable as an
unsigned char or if <[c]> is EOF.
2000-02-17 20:39:52 +01:00
<<iscntrl_l>> is like <<iscntrl>> but performs the check based on the
locale specified by the locale object locale. If <[locale]> is
LC_GLOBAL_LOCALE or not a valid locale object, the behaviour is undefined.
2000-02-17 20:39:52 +01:00
You can use a compiled subroutine instead of the macro definition by
undefining the macro using `<<#undef iscntrl>>' or `<<#undef iscntrl_l>>'.
2000-02-17 20:39:52 +01:00
RETURNS
<<iscntrl>>, <<iscntrl_l>> return non-zero if <[c]> is a delete character
or ordinary control character.
2000-02-17 20:39:52 +01:00
PORTABILITY
<<iscntrl>> is ANSI C.
<<iscntrl_l>> is POSIX-1.2008.
2000-02-17 20:39:52 +01:00
No supporting OS subroutines are required.
*/
#include <_ansi.h>
#include <ctype.h>
#undef iscntrl
int
iscntrl (int c)
2000-02-17 20:39:52 +01:00
{
return(__CTYPE_PTR[c+1] & _C);
2000-02-17 20:39:52 +01:00
}