• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*	$OpenBSD: ctype.h,v 1.19 2005/12/13 00:35:22 millert Exp $	*/
2 /*	$NetBSD: ctype.h,v 1.14 1994/10/26 00:55:47 cgd Exp $	*/
3 
4 /*
5  * Copyright (c) 1989 The Regents of the University of California.
6  * All rights reserved.
7  * (c) UNIX System Laboratories, Inc.
8  * All or some portions of this file are derived from material licensed
9  * to the University of California by American Telephone and Telegraph
10  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
11  * the permission of UNIX System Laboratories, Inc.
12  *
13  * Redistribution and use in source and binary forms, with or without
14  * modification, are permitted provided that the following conditions
15  * are met:
16  * 1. Redistributions of source code must retain the above copyright
17  *    notice, this list of conditions and the following disclaimer.
18  * 2. Redistributions in binary form must reproduce the above copyright
19  *    notice, this list of conditions and the following disclaimer in the
20  *    documentation and/or other materials provided with the distribution.
21  * 3. Neither the name of the University nor the names of its contributors
22  *    may be used to endorse or promote products derived from this software
23  *    without specific prior written permission.
24  *
25  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
29  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
30  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
31  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
32  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
34  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35  * SUCH DAMAGE.
36  *
37  *	@(#)ctype.h	5.3 (Berkeley) 4/3/91
38  */
39 
40 #pragma once
41 
42 /**
43  * @file ctype.h
44  * @brief ASCII character classification.
45  */
46 
47 #include <sys/cdefs.h>
48 #include <xlocale.h>
49 
50 /** Internal implementation detail. Do not use. */
51 #define _CTYPE_U 0x01
52 /** Internal implementation detail. Do not use. */
53 #define _CTYPE_L 0x02
54 /** Internal implementation detail. Do not use. */
55 #define _CTYPE_D 0x04
56 /** Internal implementation detail. Do not use. */
57 #define _CTYPE_S 0x08
58 /** Internal implementation detail. Do not use. */
59 #define _CTYPE_P 0x10
60 /** Internal implementation detail. Do not use. */
61 #define _CTYPE_C 0x20
62 /** Internal implementation detail. Do not use. */
63 #define _CTYPE_X 0x40
64 /** Internal implementation detail. Do not use. */
65 #define _CTYPE_B 0x80
66 /** Internal implementation detail. Do not use. */
67 #define _CTYPE_R (_CTYPE_P|_CTYPE_U|_CTYPE_L|_CTYPE_D|_CTYPE_B)
68 /** Internal implementation detail. Do not use. */
69 #define _CTYPE_A (_CTYPE_L|_CTYPE_U)
70 /** Internal implementation detail. Do not use. */
71 #define _CTYPE_N _CTYPE_D
72 
73 __BEGIN_DECLS
74 
75 /** Internal implementation detail. Do not use. */
76 extern const char* _ctype_;
77 
78 /** Returns true if `ch` is in `[A-Za-z0-9]`. */
79 int isalnum(int __ch);
80 /** Returns true if `ch` is in `[A-Za-z]`. */
81 int isalpha(int __ch);
82 /** Returns true if `ch` is a space or tab. */
83 int isblank(int __ch);
84 /** Returns true if `ch` is a control character (any character before space, plus DEL). */
85 int iscntrl(int __ch);
86 /** Returns true if `ch` is in `[0-9]`. */
87 int isdigit(int __ch);
88 /** Returns true if `ch` is `[A-Za-z0-9]` or punctuation. */
89 int isgraph(int __ch);
90 /** Returns true if `ch` is in `[a-z]`. */
91 int islower(int __ch);
92 /** Returns true if `ch` is `[A-Za-z0-9]` or punctuation or space. */
93 int isprint(int __ch);
94 /** Returns true if `ch` is punctuation. */
95 int ispunct(int __ch);
96 /** Returns true if `ch` is in `[ \f\n\r\t\v]`. */
97 int isspace(int __ch);
98 /** Returns true if `ch` is in `[A-Z]`. */
99 int isupper(int __ch);
100 /** Returns true if `ch` is in `[0-9a-f]`. */
101 int isxdigit(int __ch);
102 
103 /** Returns the corresponding lower-case character if `ch` is upper-case, or `ch` otherwise. */
104 int tolower(int __ch);
105 
106 /**
107  * Returns the corresponding lower-case character if `ch` is upper-case, or undefined otherwise.
108  *
109  * Available since API level 21.
110  *
111  * Prefer tolower() instead.
112  */
113 int _tolower(int __ch) __INTRODUCED_IN(21);
114 
115 /** Returns the corresponding upper-case character if `ch` is lower-case, or `ch` otherwise. */
116 int toupper(int __ch);
117 
118 /**
119  * Returns the corresponding upper-case character if `ch` is lower-case, or undefined otherwise.
120  *
121  * Available since API level 21.
122  *
123  * Prefer toupper() instead.
124  */
125 int _toupper(int __ch) __INTRODUCED_IN(21);
126 
127 #if __ANDROID_API__ >= __ANDROID_API_L__
128 /** Like isalnum but with an ignored `locale_t`. */
129 int isalnum_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
130 /** Like isalpha but with an ignored `locale_t`. */
131 int isalpha_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
132 /** Like isblank but with an ignored `locale_t`. */
133 int isblank_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
134 /** Like iscntrl but with an ignored `locale_t`. */
135 int iscntrl_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
136 /** Like isdigit but with an ignored `locale_t`. */
137 int isdigit_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
138 /** Like isgraph but with an ignored `locale_t`. */
139 int isgraph_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
140 /** Like islower but with an ignored `locale_t`. */
141 int islower_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
142 /** Like isprint but with an ignored `locale_t`. */
143 int isprint_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
144 /** Like ispunct but with an ignored `locale_t`. */
145 int ispunct_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
146 /** Like isspace but with an ignored `locale_t`. */
147 int isspace_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
148 /** Like isupper but with an ignored `locale_t`. */
149 int isupper_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
150 /** Like isxdigit but with an ignored `locale_t`. */
151 int isxdigit_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
152 /** Like tolower but with an ignored `locale_t`. */
153 int tolower_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
154 /** Like toupper but with an ignored `locale_t`. */
155 int toupper_l(int __ch, locale_t __l) __INTRODUCED_IN(21);
156 #else
157 // Implemented as static inlines before 21.
158 #endif
159 
160 /** Returns true if `ch` is less than 0x80. */
161 int isascii(int __ch);
162 /** Returns `ch & 0x7f`. */
163 int toascii(int __ch);
164 
165 __END_DECLS
166