2 WCharacter.h - Character utility functions for Wiring & Arduino
3 Copyright (c) 2010 Hernando Barragan. All right reserved.
5 This library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 This library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with this library; if not, write to the Free Software
17 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
25 // WCharacter.h prototypes
26 inline boolean isAlphaNumeric(int c) __attribute__((always_inline));
27 inline boolean isAlpha(int c) __attribute__((always_inline));
28 inline boolean isAscii(int c) __attribute__((always_inline));
29 inline boolean isWhitespace(int c) __attribute__((always_inline));
30 inline boolean isControl(int c) __attribute__((always_inline));
31 inline boolean isDigit(int c) __attribute__((always_inline));
32 inline boolean isGraph(int c) __attribute__((always_inline));
33 inline boolean isLowerCase(int c) __attribute__((always_inline));
34 inline boolean isPrintable(int c) __attribute__((always_inline));
35 inline boolean isPunct(int c) __attribute__((always_inline));
36 inline boolean isSpace(int c) __attribute__((always_inline));
37 inline boolean isUpperCase(int c) __attribute__((always_inline));
38 inline boolean isHexadecimalDigit(int c) __attribute__((always_inline));
39 inline int toAscii(int c) __attribute__((always_inline));
40 inline int toLowerCase(int c) __attribute__((always_inline));
41 inline int toUpperCase(int c)__attribute__((always_inline));
44 // Checks for an alphanumeric character.
45 // It is equivalent to (isalpha(c) || isdigit(c)).
46 inline boolean isAlphaNumeric(int c)
48 return ( isalnum(c) == 0 ? false : true);
52 // Checks for an alphabetic character.
53 // It is equivalent to (isupper(c) || islower(c)).
54 inline boolean isAlpha(int c)
56 return ( isalpha(c) == 0 ? false : true);
60 // Checks whether c is a 7-bit unsigned char value
61 // that fits into the ASCII character set.
62 inline boolean isAscii(int c)
64 return ( isascii (c) == 0 ? false : true);
68 // Checks for a blank character, that is, a space or a tab.
69 inline boolean isWhitespace(int c)
71 return ( isblank (c) == 0 ? false : true);
75 // Checks for a control character.
76 inline boolean isControl(int c)
78 return ( iscntrl (c) == 0 ? false : true);
82 // Checks for a digit (0 through 9).
83 inline boolean isDigit(int c)
85 return ( isdigit (c) == 0 ? false : true);
89 // Checks for any printable character except space.
90 inline boolean isGraph(int c)
92 return ( isgraph (c) == 0 ? false : true);
96 // Checks for a lower-case character.
97 inline boolean isLowerCase(int c)
99 return (islower (c) == 0 ? false : true);
103 // Checks for any printable character including space.
104 inline boolean isPrintable(int c)
106 return ( isprint (c) == 0 ? false : true);
110 // Checks for any printable character which is not a space
111 // or an alphanumeric character.
112 inline boolean isPunct(int c)
114 return ( ispunct (c) == 0 ? false : true);
118 // Checks for white-space characters. For the avr-libc library,
119 // these are: space, formfeed ('\f'), newline ('\n'), carriage
120 // return ('\r'), horizontal tab ('\t'), and vertical tab ('\v').
121 inline boolean isSpace(int c)
123 return ( isspace (c) == 0 ? false : true);
127 // Checks for an uppercase letter.
128 inline boolean isUpperCase(int c)
130 return ( isupper (c) == 0 ? false : true);
134 // Checks for a hexadecimal digits, i.e. one of 0 1 2 3 4 5 6 7
135 // 8 9 a b c d e f A B C D E F.
136 inline boolean isHexadecimalDigit(int c)
138 return ( isxdigit (c) == 0 ? false : true);
142 // Converts c to a 7-bit unsigned char value that fits into the
143 // ASCII character set, by clearing the high-order bits.
144 inline int toAscii(int c)
151 // Many people will be unhappy if you use this function.
152 // This function will convert accented letters into random
155 // Converts the letter c to lower case, if possible.
156 inline int toLowerCase(int c)
162 // Converts the letter c to upper case, if possible.
163 inline int toUpperCase(int c)