:stmt: -> :keyword:
[python.git] / Objects / bytes_methods.c
blob4d255207c4817b4ab232ca52b22dab66257fa9e0
1 #include "Python.h"
2 #include "bytes_methods.h"
4 PyDoc_STRVAR_shared(_Py_isspace__doc__,
5 "B.isspace() -> bool\n\
6 \n\
7 Return True if all characters in B are whitespace\n\
8 and there is at least one character in B, False otherwise.");
10 PyObject*
11 _Py_bytes_isspace(const char *cptr, Py_ssize_t len)
13 register const unsigned char *p
14 = (unsigned char *) cptr;
15 register const unsigned char *e;
17 /* Shortcut for single character strings */
18 if (len == 1 && Py_ISSPACE(*p))
19 Py_RETURN_TRUE;
21 /* Special case for empty strings */
22 if (len == 0)
23 Py_RETURN_FALSE;
25 e = p + len;
26 for (; p < e; p++) {
27 if (!Py_ISSPACE(*p))
28 Py_RETURN_FALSE;
30 Py_RETURN_TRUE;
34 PyDoc_STRVAR_shared(_Py_isalpha__doc__,
35 "B.isalpha() -> bool\n\
36 \n\
37 Return True if all characters in B are alphabetic\n\
38 and there is at least one character in B, False otherwise.");
40 PyObject*
41 _Py_bytes_isalpha(const char *cptr, Py_ssize_t len)
43 register const unsigned char *p
44 = (unsigned char *) cptr;
45 register const unsigned char *e;
47 /* Shortcut for single character strings */
48 if (len == 1 && Py_ISALPHA(*p))
49 Py_RETURN_TRUE;
51 /* Special case for empty strings */
52 if (len == 0)
53 Py_RETURN_FALSE;
55 e = p + len;
56 for (; p < e; p++) {
57 if (!Py_ISALPHA(*p))
58 Py_RETURN_FALSE;
60 Py_RETURN_TRUE;
64 PyDoc_STRVAR_shared(_Py_isalnum__doc__,
65 "B.isalnum() -> bool\n\
66 \n\
67 Return True if all characters in B are alphanumeric\n\
68 and there is at least one character in B, False otherwise.");
70 PyObject*
71 _Py_bytes_isalnum(const char *cptr, Py_ssize_t len)
73 register const unsigned char *p
74 = (unsigned char *) cptr;
75 register const unsigned char *e;
77 /* Shortcut for single character strings */
78 if (len == 1 && Py_ISALNUM(*p))
79 Py_RETURN_TRUE;
81 /* Special case for empty strings */
82 if (len == 0)
83 Py_RETURN_FALSE;
85 e = p + len;
86 for (; p < e; p++) {
87 if (!Py_ISALNUM(*p))
88 Py_RETURN_FALSE;
90 Py_RETURN_TRUE;
94 PyDoc_STRVAR_shared(_Py_isdigit__doc__,
95 "B.isdigit() -> bool\n\
96 \n\
97 Return True if all characters in B are digits\n\
98 and there is at least one character in B, False otherwise.");
100 PyObject*
101 _Py_bytes_isdigit(const char *cptr, Py_ssize_t len)
103 register const unsigned char *p
104 = (unsigned char *) cptr;
105 register const unsigned char *e;
107 /* Shortcut for single character strings */
108 if (len == 1 && Py_ISDIGIT(*p))
109 Py_RETURN_TRUE;
111 /* Special case for empty strings */
112 if (len == 0)
113 Py_RETURN_FALSE;
115 e = p + len;
116 for (; p < e; p++) {
117 if (!Py_ISDIGIT(*p))
118 Py_RETURN_FALSE;
120 Py_RETURN_TRUE;
124 PyDoc_STRVAR_shared(_Py_islower__doc__,
125 "B.islower() -> bool\n\
127 Return True if all cased characters in B are lowercase and there is\n\
128 at least one cased character in B, False otherwise.");
130 PyObject*
131 _Py_bytes_islower(const char *cptr, Py_ssize_t len)
133 register const unsigned char *p
134 = (unsigned char *) cptr;
135 register const unsigned char *e;
136 int cased;
138 /* Shortcut for single character strings */
139 if (len == 1)
140 return PyBool_FromLong(Py_ISLOWER(*p));
142 /* Special case for empty strings */
143 if (len == 0)
144 Py_RETURN_FALSE;
146 e = p + len;
147 cased = 0;
148 for (; p < e; p++) {
149 if (Py_ISUPPER(*p))
150 Py_RETURN_FALSE;
151 else if (!cased && Py_ISLOWER(*p))
152 cased = 1;
154 return PyBool_FromLong(cased);
158 PyDoc_STRVAR_shared(_Py_isupper__doc__,
159 "B.isupper() -> bool\n\
161 Return True if all cased characters in B are uppercase and there is\n\
162 at least one cased character in B, False otherwise.");
164 PyObject*
165 _Py_bytes_isupper(const char *cptr, Py_ssize_t len)
167 register const unsigned char *p
168 = (unsigned char *) cptr;
169 register const unsigned char *e;
170 int cased;
172 /* Shortcut for single character strings */
173 if (len == 1)
174 return PyBool_FromLong(Py_ISUPPER(*p));
176 /* Special case for empty strings */
177 if (len == 0)
178 Py_RETURN_FALSE;
180 e = p + len;
181 cased = 0;
182 for (; p < e; p++) {
183 if (Py_ISLOWER(*p))
184 Py_RETURN_FALSE;
185 else if (!cased && Py_ISUPPER(*p))
186 cased = 1;
188 return PyBool_FromLong(cased);
192 PyDoc_STRVAR_shared(_Py_istitle__doc__,
193 "B.istitle() -> bool\n\
195 Return True if B is a titlecased string and there is at least one\n\
196 character in B, i.e. uppercase characters may only follow uncased\n\
197 characters and lowercase characters only cased ones. Return False\n\
198 otherwise.");
200 PyObject*
201 _Py_bytes_istitle(const char *cptr, Py_ssize_t len)
203 register const unsigned char *p
204 = (unsigned char *) cptr;
205 register const unsigned char *e;
206 int cased, previous_is_cased;
208 /* Shortcut for single character strings */
209 if (len == 1)
210 return PyBool_FromLong(Py_ISUPPER(*p));
212 /* Special case for empty strings */
213 if (len == 0)
214 Py_RETURN_FALSE;
216 e = p + len;
217 cased = 0;
218 previous_is_cased = 0;
219 for (; p < e; p++) {
220 register const unsigned char ch = *p;
222 if (Py_ISUPPER(ch)) {
223 if (previous_is_cased)
224 Py_RETURN_FALSE;
225 previous_is_cased = 1;
226 cased = 1;
228 else if (Py_ISLOWER(ch)) {
229 if (!previous_is_cased)
230 Py_RETURN_FALSE;
231 previous_is_cased = 1;
232 cased = 1;
234 else
235 previous_is_cased = 0;
237 return PyBool_FromLong(cased);
241 PyDoc_STRVAR_shared(_Py_lower__doc__,
242 "B.lower() -> copy of B\n\
244 Return a copy of B with all ASCII characters converted to lowercase.");
246 void
247 _Py_bytes_lower(char *result, const char *cptr, Py_ssize_t len)
249 Py_ssize_t i;
252 newobj = PyString_FromStringAndSize(NULL, len);
253 if (!newobj)
254 return NULL;
256 s = PyString_AS_STRING(newobj);
259 Py_MEMCPY(result, cptr, len);
261 for (i = 0; i < len; i++) {
262 int c = Py_CHARMASK(result[i]);
263 if (Py_ISUPPER(c))
264 result[i] = Py_TOLOWER(c);
269 PyDoc_STRVAR_shared(_Py_upper__doc__,
270 "B.upper() -> copy of B\n\
272 Return a copy of B with all ASCII characters converted to uppercase.");
274 void
275 _Py_bytes_upper(char *result, const char *cptr, Py_ssize_t len)
277 Py_ssize_t i;
280 newobj = PyString_FromStringAndSize(NULL, len);
281 if (!newobj)
282 return NULL;
284 s = PyString_AS_STRING(newobj);
287 Py_MEMCPY(result, cptr, len);
289 for (i = 0; i < len; i++) {
290 int c = Py_CHARMASK(result[i]);
291 if (Py_ISLOWER(c))
292 result[i] = Py_TOUPPER(c);
297 PyDoc_STRVAR_shared(_Py_title__doc__,
298 "B.title() -> copy of B\n\
300 Return a titlecased version of B, i.e. ASCII words start with uppercase\n\
301 characters, all remaining cased characters have lowercase.");
303 void
304 _Py_bytes_title(char *result, char *s, Py_ssize_t len)
306 Py_ssize_t i;
307 int previous_is_cased = 0;
310 newobj = PyString_FromStringAndSize(NULL, len);
311 if (newobj == NULL)
312 return NULL;
313 s_new = PyString_AsString(newobj);
315 for (i = 0; i < len; i++) {
316 int c = Py_CHARMASK(*s++);
317 if (Py_ISLOWER(c)) {
318 if (!previous_is_cased)
319 c = Py_TOUPPER(c);
320 previous_is_cased = 1;
321 } else if (Py_ISUPPER(c)) {
322 if (previous_is_cased)
323 c = Py_TOLOWER(c);
324 previous_is_cased = 1;
325 } else
326 previous_is_cased = 0;
327 *result++ = c;
332 PyDoc_STRVAR_shared(_Py_capitalize__doc__,
333 "B.capitalize() -> copy of B\n\
335 Return a copy of B with only its first character capitalized (ASCII).");
337 void
338 _Py_bytes_capitalize(char *result, char *s, Py_ssize_t len)
340 Py_ssize_t i;
343 newobj = PyString_FromStringAndSize(NULL, len);
344 if (newobj == NULL)
345 return NULL;
346 s_new = PyString_AsString(newobj);
348 if (0 < len) {
349 int c = Py_CHARMASK(*s++);
350 if (Py_ISLOWER(c))
351 *result = Py_TOUPPER(c);
352 else
353 *result = c;
354 result++;
356 for (i = 1; i < len; i++) {
357 int c = Py_CHARMASK(*s++);
358 if (Py_ISUPPER(c))
359 *result = Py_TOLOWER(c);
360 else
361 *result = c;
362 result++;
367 PyDoc_STRVAR_shared(_Py_swapcase__doc__,
368 "B.swapcase() -> copy of B\n\
370 Return a copy of B with uppercase ASCII characters converted\n\
371 to lowercase ASCII and vice versa.");
373 void
374 _Py_bytes_swapcase(char *result, char *s, Py_ssize_t len)
376 Py_ssize_t i;
379 newobj = PyString_FromStringAndSize(NULL, len);
380 if (newobj == NULL)
381 return NULL;
382 s_new = PyString_AsString(newobj);
384 for (i = 0; i < len; i++) {
385 int c = Py_CHARMASK(*s++);
386 if (Py_ISLOWER(c)) {
387 *result = Py_TOUPPER(c);
389 else if (Py_ISUPPER(c)) {
390 *result = Py_TOLOWER(c);
392 else
393 *result = c;
394 result++;