ctype.h

Go to the documentation of this file.

/* Copyright (c) 2002,2007 Michael Stumpf
   All rights reserved.
 
   Redistribution and use in source and binary forms, with or without
   modification, are permitted provided that the following conditions are met:
 
   * Redistributions of source code must retain the above copyright
     notice, this list of conditions and the following disclaimer.
 
   * Redistributions in binary form must reproduce the above copyright
     notice, this list of conditions and the following disclaimer in
     the documentation and/or other materials provided with the
     distribution.
 
   * Neither the name of the copyright holders nor the names of
     contributors may be used to endorse or promote products derived
     from this software without specific prior written permission.
 
  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  POSSIBILITY OF SUCH DAMAGE. */
 
/*
   ctype.h - character conversion macros and ctype macros
 
  Author : Michael Stumpf
           Michael.Stumpf@t-online.de
*/
 
#ifndef __CTYPE_H_
#define __CTYPE_H_ 1
 
#include <bits/attribs.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/** \file */
/** \defgroup ctype <ctype.h>: Character Operations
    These functions perform various operations on characters.
 
    \code #include <ctype.h>\endcode
 
*/
 
/** \name Character classification routines
 
    These functions perform character classification. They return true or
    false status depending whether the character passed to the function falls
    into the function's classification (i.e. isdigit() returns true if its
    argument is any value '0' though '9', inclusive). If the input is not
    an unsigned char value, all of this function return false.  */
 
/**@{*/
 
/** \ingroup ctype
 
    Checks for an alphanumeric character. It is equivalent to <tt>(isalpha(c)
    || isdigit(c))</tt>. */
 
extern int isalnum(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isalnum(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isalnum ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for an alphabetic character. It is equivalent to <tt>(isupper(c) ||
    islower(c))</tt>. */
 
extern int isalpha(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isalpha(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isalpha ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks whether \c c is a 7-bit unsigned char value that fits into the
    ASCII character set. */
 
extern int isascii(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isascii(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isascii ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for a blank character, that is, a space or a tab. */
 
extern int isblank(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isblank(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isblank ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for a control character. */
 
extern int iscntrl(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int iscntrl(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call iscntrl ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for a digit (0 through 9). */
 
extern int isdigit(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isdigit(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isdigit ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for any printable character except space. */
 
extern int isgraph(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isgraph(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isgraph ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for a lower-case character. */
 
extern int islower(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int islower(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call islower ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for any printable character including space. */
 
extern int isprint(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isprint(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isprint ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for any printable character which is not a space or an alphanumeric
    character. */
 
extern int ispunct(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int ispunct(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call ispunct ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for white-space characters.  For the AVR-LibC library, these are:
    space, form-feed ('\\f'), newline ('\\n'), carriage return ('\\r'),
    horizontal tab ('\\t'), and vertical tab ('\\v'). */
 
extern int isspace(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isspace(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isspace ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for an uppercase letter. */
 
extern int isupper(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isupper(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isupper ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Checks for a hexadecimal digits, i.e. one of 0 1 2 3 4 5 6 7 8 9 a b c d e
    f A B C D E F. */
 
extern int isxdigit(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int isxdigit(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call isxdigit ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/**@}*/
 
/** \name Character conversion routines
 
    This realization permits all possible values of integer argument.
    The toascii() function clears all highest bits. The tolower() and
    toupper() functions return an input argument as is, if it is not an
    unsigned char value.    */
 
/**@{*/
 
/** \ingroup ctype
 
    Converts \c c to a 7-bit unsigned char value that fits into the ASCII
    character set, by clearing the high-order bits.
 
    \warning Many people will be unhappy if you use this function. This
    function will convert accented letters into random characters. */
 
extern int toascii(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int toascii(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call toascii ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Converts the letter \c c to lower case, if possible. */
 
extern int tolower(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int tolower(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call tolower ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/** \ingroup ctype
 
    Converts the letter \c c to upper case, if possible. */
 
extern int toupper(int __c);
 
#ifndef __DOXYGEN__
extern __ATTR_ALWAYS_INLINE__ __ATTR_GNU_INLINE__
int toupper(int __c)
{
  register int __r24 __asm("r24") = __c;
  __asm ("%~call toupper ; [[len=%~call]]" : "+r" (__r24));
  return __r24;
}
#endif
 
/**@}*/
 
#ifdef __cplusplus
}
#endif
 
#endif