newlib/libc/ctype/ispunct.c

   1 /*
   2 FUNCTION
   3         <<ispunct>>, <<ispunct_l>>---punctuation character predicate
   4
   5 INDEX
   6         ispunct
   7
   8 INDEX
   9         ispunct_l
  10
  11 SYNOPSIS
  12         #include <ctype.h>
  13         int ispunct(int <[c]>);
  14
  15         #include <ctype.h>
  16         int ispunct_l(int <[c]>, locale_t <[locale]>);
  17
  18 DESCRIPTION
  19 <<ispunct>> is a macro which classifies singlebyte charset values by table
  20 lookup.  It is a predicate returning non-zero for printable
  21 punctuation characters, and 0 for other characters.  It is defined only
  22 if <[c]> is representable as an unsigned char or if <[c]> is EOF.
  23
  24 <<ispunct_l>> is like <<ispunct>> but performs the check based on the
  25 locale specified by the locale object locale.  If <[locale]> is
  26 LC_GLOBAL_LOCALE or not a valid locale object, the behaviour is undefined.
  27
  28 You can use a compiled subroutine instead of the macro definition by
  29 undefining the macro using `<<#undef ispunct>>' or `<<#undef ispunct_l>>'.
  30
  31 RETURNS
  32 <<ispunct>>, <<ispunct_l>> return non-zero if <[c]> is a printable
  33 punctuation character.
  34
  35 PORTABILITY
  36 <<ispunct>> is ANSI C.
  37 <<ispunct_l>> is POSIX-1.2008.
  38
  39 No supporting OS subroutines are required.
  40 */
  41
  42 #include <_ansi.h>
  43 #include <ctype.h>
  44
  45
  46 #undef ispunct
  47 int
  48 ispunct (int c)
  49 {
  50         return(__CTYPE_PTR[c+1] & _P);
  51 }