blob: d94edce50b0a0fc1f9ddd026696ed82b73b498a8 [file] [log] [blame]
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001
2/* New getargs implementation */
3
Guido van Rossum79f25d91997-04-29 20:08:16 +00004#include "Python.h"
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00005
Guido van Rossumc1d50531996-08-21 23:38:24 +00006#include <ctype.h>
7
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00008
Anthony Baxter97300382006-04-12 04:38:54 +00009#ifdef __cplusplus
10extern "C" {
11#endif
Jeremy Hyltonaf68c872005-12-10 18:50:16 +000012int PyArg_Parse(PyObject *, const char *, ...);
13int PyArg_ParseTuple(PyObject *, const char *, ...);
14int PyArg_VaParse(PyObject *, const char *, va_list);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000015
Tim Petersdbd9ba62000-07-09 03:09:57 +000016int PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
Martin v. Löwis15e62742006-02-27 16:46:16 +000017 const char *, char **, ...);
Brett Cannon711e7d92004-07-10 22:20:32 +000018int PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
Martin v. Löwis15e62742006-02-27 16:46:16 +000019 const char *, char **, va_list);
Brett Cannon711e7d92004-07-10 22:20:32 +000020
Martin v. Löwis5cb69362006-04-14 09:08:42 +000021#ifdef HAVE_DECLSPEC_DLL
22/* Export functions */
23PyAPI_FUNC(int) _PyArg_Parse_SizeT(PyObject *, char *, ...);
24PyAPI_FUNC(int) _PyArg_ParseTuple_SizeT(PyObject *, char *, ...);
25PyAPI_FUNC(int) _PyArg_ParseTupleAndKeywords_SizeT(PyObject *, PyObject *,
26 const char *, char **, ...);
27PyAPI_FUNC(PyObject *) _Py_BuildValue_SizeT(const char *, ...);
28PyAPI_FUNC(int) _PyArg_VaParse_SizeT(PyObject *, char *, va_list);
29PyAPI_FUNC(int) _PyArg_VaParseTupleAndKeywords_SizeT(PyObject *, PyObject *,
30 const char *, char **, va_list);
31#endif
32
Martin v. Löwis18e16552006-02-15 17:27:45 +000033#define FLAG_COMPAT 1
34#define FLAG_SIZE_T 2
35
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000036
37/* Forward */
Jeremy Hyltonaf68c872005-12-10 18:50:16 +000038static int vgetargs1(PyObject *, const char *, va_list *, int);
39static void seterror(int, const char *, int *, const char *, const char *);
Martin v. Löwis18e16552006-02-15 17:27:45 +000040static char *convertitem(PyObject *, const char **, va_list *, int, int *,
41 char *, size_t, PyObject **);
42static char *converttuple(PyObject *, const char **, va_list *, int,
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +000043 int *, char *, size_t, int, PyObject **);
Martin v. Löwis18e16552006-02-15 17:27:45 +000044static char *convertsimple(PyObject *, const char **, va_list *, int, char *,
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +000045 size_t, PyObject **);
Martin v. Löwis18e16552006-02-15 17:27:45 +000046static Py_ssize_t convertbuffer(PyObject *, void **p, char **);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000047
Tim Petersdbd9ba62000-07-09 03:09:57 +000048static int vgetargskeywords(PyObject *, PyObject *,
Martin v. Löwis15e62742006-02-27 16:46:16 +000049 const char *, char **, va_list *, int);
Martin v. Löwis18e16552006-02-15 17:27:45 +000050static char *skipitem(const char **, va_list *, int);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000051
Fred Drake563dfc22001-10-23 14:41:08 +000052int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +000053PyArg_Parse(PyObject *args, const char *format, ...)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000054{
55 int retval;
56 va_list va;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000057
58 va_start(va, format);
Martin v. Löwis18e16552006-02-15 17:27:45 +000059 retval = vgetargs1(args, format, &va, FLAG_COMPAT);
60 va_end(va);
61 return retval;
62}
63
64int
65_PyArg_Parse_SizeT(PyObject *args, char *format, ...)
66{
67 int retval;
68 va_list va;
69
70 va_start(va, format);
71 retval = vgetargs1(args, format, &va, FLAG_COMPAT|FLAG_SIZE_T);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000072 va_end(va);
73 return retval;
74}
75
76
Fred Drake563dfc22001-10-23 14:41:08 +000077int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +000078PyArg_ParseTuple(PyObject *args, const char *format, ...)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000079{
80 int retval;
81 va_list va;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000082
83 va_start(va, format);
Guido van Rossum1ae940a1995-01-02 19:04:15 +000084 retval = vgetargs1(args, format, &va, 0);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000085 va_end(va);
86 return retval;
87}
88
Martin v. Löwis18e16552006-02-15 17:27:45 +000089int
90_PyArg_ParseTuple_SizeT(PyObject *args, char *format, ...)
91{
92 int retval;
93 va_list va;
94
95 va_start(va, format);
96 retval = vgetargs1(args, format, &va, FLAG_SIZE_T);
97 va_end(va);
98 return retval;
99}
100
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000101
102int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000103PyArg_VaParse(PyObject *args, const char *format, va_list va)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000104{
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000105 va_list lva;
106
107#ifdef VA_LIST_IS_ARRAY
108 memcpy(lva, va, sizeof(va_list));
109#else
Martin v. Löwis75d2d942002-07-28 10:23:27 +0000110#ifdef __va_copy
111 __va_copy(lva, va);
112#else
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000113 lva = va;
114#endif
Martin v. Löwis75d2d942002-07-28 10:23:27 +0000115#endif
Guido van Rossum1ae940a1995-01-02 19:04:15 +0000116
117 return vgetargs1(args, format, &lva, 0);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000118}
119
Martin v. Löwis18e16552006-02-15 17:27:45 +0000120int
121_PyArg_VaParse_SizeT(PyObject *args, char *format, va_list va)
122{
123 va_list lva;
124
125#ifdef VA_LIST_IS_ARRAY
126 memcpy(lva, va, sizeof(va_list));
127#else
128#ifdef __va_copy
129 __va_copy(lva, va);
130#else
131 lva = va;
132#endif
133#endif
134
135 return vgetargs1(args, format, &lva, FLAG_SIZE_T);
136}
137
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000138
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000139/* Handle cleanup of allocated memory in case of exception */
140
141static int
142addcleanup(void *ptr, PyObject **freelist)
143{
144 PyObject *cobj;
145 if (!*freelist) {
146 *freelist = PyList_New(0);
147 if (!*freelist) {
148 PyMem_FREE(ptr);
149 return -1;
150 }
151 }
152 cobj = PyCObject_FromVoidPtr(ptr, NULL);
153 if (!cobj) {
154 PyMem_FREE(ptr);
155 return -1;
156 }
157 if(PyList_Append(*freelist, cobj)) {
158 PyMem_FREE(ptr);
159 Py_DECREF(cobj);
160 return -1;
161 }
162 Py_DECREF(cobj);
163 return 0;
164}
165
166static int
167cleanreturn(int retval, PyObject *freelist)
168{
169 if(freelist) {
170 if((retval) == 0) {
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000171 Py_ssize_t len = PyList_GET_SIZE(freelist), i;
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000172 for (i = 0; i < len; i++)
173 PyMem_FREE(PyCObject_AsVoidPtr(
174 PyList_GET_ITEM(freelist, i)));
175 }
176 Py_DECREF(freelist);
177 }
178 return retval;
179}
180
181
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000182static int
Martin v. Löwis18e16552006-02-15 17:27:45 +0000183vgetargs1(PyObject *args, const char *format, va_list *p_va, int flags)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000184{
185 char msgbuf[256];
186 int levels[32];
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000187 const char *fname = NULL;
188 const char *message = NULL;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000189 int min = -1;
190 int max = 0;
191 int level = 0;
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000192 int endfmt = 0;
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000193 const char *formatsave = format;
Martin v. Löwisd96ee902006-02-16 14:37:16 +0000194 Py_ssize_t i, len;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000195 char *msg;
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000196 PyObject *freelist = NULL;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000197 int compat = flags & FLAG_COMPAT;
198
Tim Peters5c4d5bf2001-02-12 22:13:26 +0000199 assert(compat || (args != (PyObject*)NULL));
Martin v. Löwis18e16552006-02-15 17:27:45 +0000200 flags = flags & ~FLAG_COMPAT;
Tim Peters5c4d5bf2001-02-12 22:13:26 +0000201
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000202 while (endfmt == 0) {
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000203 int c = *format++;
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000204 switch (c) {
205 case '(':
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000206 if (level == 0)
207 max++;
208 level++;
Georg Brandl209307e2006-08-09 07:03:22 +0000209 if (level >= 30)
210 Py_FatalError("too many tuple nesting levels "
211 "in argument format string");
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000212 break;
213 case ')':
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000214 if (level == 0)
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000215 Py_FatalError("excess ')' in getargs format");
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000216 else
217 level--;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000218 break;
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000219 case '\0':
220 endfmt = 1;
221 break;
222 case ':':
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000223 fname = format;
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000224 endfmt = 1;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000225 break;
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000226 case ';':
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000227 message = format;
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000228 endfmt = 1;
229 break;
230 default:
231 if (level == 0) {
232 if (c == 'O')
233 max++;
Neal Norwitz30b5c5d2005-12-19 06:05:18 +0000234 else if (isalpha(Py_CHARMASK(c))) {
Jeremy Hylton25916bd2001-05-29 17:46:19 +0000235 if (c != 'e') /* skip encoded */
236 max++;
237 } else if (c == '|')
238 min = max;
239 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000240 break;
241 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000242 }
243
244 if (level != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000245 Py_FatalError(/* '(' */ "missing ')' in getargs format");
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000246
247 if (min < 0)
248 min = max;
249
250 format = formatsave;
251
252 if (compat) {
253 if (max == 0) {
254 if (args == NULL)
255 return 1;
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000256 PyOS_snprintf(msgbuf, sizeof(msgbuf),
257 "%.200s%s takes no arguments",
258 fname==NULL ? "function" : fname,
259 fname==NULL ? "" : "()");
Guido van Rossum79f25d91997-04-29 20:08:16 +0000260 PyErr_SetString(PyExc_TypeError, msgbuf);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000261 return 0;
262 }
263 else if (min == 1 && max == 1) {
Guido van Rossum13d0ed11994-11-10 22:35:48 +0000264 if (args == NULL) {
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000265 PyOS_snprintf(msgbuf, sizeof(msgbuf),
266 "%.200s%s takes at least one argument",
267 fname==NULL ? "function" : fname,
268 fname==NULL ? "" : "()");
Guido van Rossum79f25d91997-04-29 20:08:16 +0000269 PyErr_SetString(PyExc_TypeError, msgbuf);
Guido van Rossum13d0ed11994-11-10 22:35:48 +0000270 return 0;
271 }
Martin v. Löwis18e16552006-02-15 17:27:45 +0000272 msg = convertitem(args, &format, p_va, flags, levels,
273 msgbuf, sizeof(msgbuf), &freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000274 if (msg == NULL)
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000275 return cleanreturn(1, freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000276 seterror(levels[0], msg, levels+1, fname, message);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000277 return cleanreturn(0, freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000278 }
279 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +0000280 PyErr_SetString(PyExc_SystemError,
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000281 "old style getargs format uses new features");
282 return 0;
283 }
284 }
285
Guido van Rossum79f25d91997-04-29 20:08:16 +0000286 if (!PyTuple_Check(args)) {
287 PyErr_SetString(PyExc_SystemError,
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000288 "new style getargs format but argument is not a tuple");
289 return 0;
290 }
291
Jeremy Hylton0f8117f2001-05-18 20:57:38 +0000292 len = PyTuple_GET_SIZE(args);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000293
294 if (len < min || max < len) {
295 if (message == NULL) {
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000296 PyOS_snprintf(msgbuf, sizeof(msgbuf),
297 "%.150s%s takes %s %d argument%s "
Neal Norwitz20dd93f2006-02-19 19:34:15 +0000298 "(%ld given)",
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000299 fname==NULL ? "function" : fname,
300 fname==NULL ? "" : "()",
301 min==max ? "exactly"
302 : len < min ? "at least" : "at most",
303 len < min ? min : max,
304 (len < min ? min : max) == 1 ? "" : "s",
Neal Norwitz9a276172006-02-20 18:57:39 +0000305 Py_SAFE_DOWNCAST(len, Py_ssize_t, long));
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000306 message = msgbuf;
307 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000308 PyErr_SetString(PyExc_TypeError, message);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000309 return 0;
310 }
311
312 for (i = 0; i < len; i++) {
313 if (*format == '|')
314 format++;
Jeremy Hylton0f8117f2001-05-18 20:57:38 +0000315 msg = convertitem(PyTuple_GET_ITEM(args, i), &format, p_va,
Martin v. Löwis18e16552006-02-15 17:27:45 +0000316 flags, levels, msgbuf,
317 sizeof(msgbuf), &freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000318 if (msg) {
319 seterror(i+1, msg, levels, fname, message);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000320 return cleanreturn(0, freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000321 }
322 }
Guido van Rossum231a41e1997-12-09 20:36:39 +0000323
Neal Norwitz4ac13df2005-12-19 06:10:07 +0000324 if (*format != '\0' && !isalpha(Py_CHARMASK(*format)) &&
Guido van Rossum7d4f68c1997-12-19 04:25:23 +0000325 *format != '(' &&
Guido van Rossum231a41e1997-12-09 20:36:39 +0000326 *format != '|' && *format != ':' && *format != ';') {
327 PyErr_Format(PyExc_SystemError,
Guido van Rossum0d6b49e1998-01-19 22:22:44 +0000328 "bad format string: %.200s", formatsave);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000329 return cleanreturn(0, freelist);
Guido van Rossum231a41e1997-12-09 20:36:39 +0000330 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000331
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000332 return cleanreturn(1, freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000333}
334
335
336
337static void
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000338seterror(int iarg, const char *msg, int *levels, const char *fname,
339 const char *message)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000340{
Marc-André Lemburgd4c0a9c2001-11-28 11:47:00 +0000341 char buf[512];
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000342 int i;
343 char *p = buf;
344
Guido van Rossum79f25d91997-04-29 20:08:16 +0000345 if (PyErr_Occurred())
Guido van Rossum64fc6491995-01-21 14:09:37 +0000346 return;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000347 else if (message == NULL) {
348 if (fname != NULL) {
Jeremy Hyltonf16e05e2001-11-28 21:46:59 +0000349 PyOS_snprintf(p, sizeof(buf), "%.200s() ", fname);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000350 p += strlen(p);
351 }
Ka-Ping Yee20579702001-01-15 22:14:16 +0000352 if (iarg != 0) {
Tim Petersfaad5ad2001-12-03 00:43:33 +0000353 PyOS_snprintf(p, sizeof(buf) - (p - buf),
Jeremy Hyltonf16e05e2001-11-28 21:46:59 +0000354 "argument %d", iarg);
Ka-Ping Yee20579702001-01-15 22:14:16 +0000355 i = 0;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000356 p += strlen(p);
Georg Brandl5f135782006-07-26 08:03:10 +0000357 while (levels[i] > 0 && i < 32 && (int)(p-buf) < 220) {
358 PyOS_snprintf(p, sizeof(buf) - (p - buf),
Jeremy Hyltonf16e05e2001-11-28 21:46:59 +0000359 ", item %d", levels[i]-1);
Ka-Ping Yee20579702001-01-15 22:14:16 +0000360 p += strlen(p);
361 i++;
362 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000363 }
Ka-Ping Yee20579702001-01-15 22:14:16 +0000364 else {
Tim Petersfaad5ad2001-12-03 00:43:33 +0000365 PyOS_snprintf(p, sizeof(buf) - (p - buf), "argument");
Ka-Ping Yee20579702001-01-15 22:14:16 +0000366 p += strlen(p);
367 }
Tim Petersfaad5ad2001-12-03 00:43:33 +0000368 PyOS_snprintf(p, sizeof(buf) - (p - buf), " %.256s", msg);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000369 message = buf;
370 }
Guido van Rossum79f25d91997-04-29 20:08:16 +0000371 PyErr_SetString(PyExc_TypeError, message);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000372}
373
374
375/* Convert a tuple argument.
376 On entry, *p_format points to the character _after_ the opening '('.
377 On successful exit, *p_format points to the closing ')'.
378 If successful:
379 *p_format and *p_va are updated,
380 *levels and *msgbuf are untouched,
381 and NULL is returned.
382 If the argument is invalid:
383 *p_format is unchanged,
384 *p_va is undefined,
385 *levels is a 0-terminated list of item numbers,
386 *msgbuf contains an error message, whose format is:
Ka-Ping Yee20579702001-01-15 22:14:16 +0000387 "must be <typename1>, not <typename2>", where:
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000388 <typename1> is the name of the expected type, and
389 <typename2> is the name of the actual type,
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000390 and msgbuf is returned.
391*/
392
393static char *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000394converttuple(PyObject *arg, const char **p_format, va_list *p_va, int flags,
395 int *levels, char *msgbuf, size_t bufsize, int toplevel,
396 PyObject **freelist)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000397{
398 int level = 0;
399 int n = 0;
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000400 const char *format = *p_format;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000401 int i;
402
403 for (;;) {
404 int c = *format++;
405 if (c == '(') {
406 if (level == 0)
407 n++;
408 level++;
409 }
410 else if (c == ')') {
411 if (level == 0)
412 break;
413 level--;
414 }
415 else if (c == ':' || c == ';' || c == '\0')
416 break;
Neal Norwitz30b5c5d2005-12-19 06:05:18 +0000417 else if (level == 0 && isalpha(Py_CHARMASK(c)))
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000418 n++;
419 }
420
Ka-Ping Yee20579702001-01-15 22:14:16 +0000421 if (!PySequence_Check(arg) || PyString_Check(arg)) {
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000422 levels[0] = 0;
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000423 PyOS_snprintf(msgbuf, bufsize,
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000424 toplevel ? "expected %d arguments, not %.50s" :
425 "must be %d-item sequence, not %.50s",
426 n,
427 arg == Py_None ? "None" : arg->ob_type->tp_name);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000428 return msgbuf;
429 }
430
Jeremy Hylton03657cf2000-07-12 13:05:33 +0000431 if ((i = PySequence_Size(arg)) != n) {
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000432 levels[0] = 0;
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000433 PyOS_snprintf(msgbuf, bufsize,
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000434 toplevel ? "expected %d arguments, not %d" :
435 "must be sequence of length %d, not %d",
436 n, i);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000437 return msgbuf;
438 }
Ka-Ping Yee20579702001-01-15 22:14:16 +0000439
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000440 format = *p_format;
441 for (i = 0; i < n; i++) {
442 char *msg;
Guido van Rossum66368cc1999-02-17 23:16:43 +0000443 PyObject *item;
444 item = PySequence_GetItem(arg, i);
Georg Brandl5f135782006-07-26 08:03:10 +0000445 if (item == NULL) {
446 PyErr_Clear();
447 levels[0] = i+1;
448 levels[1] = 0;
449 strncpy(msgbuf, "is not retrievable", bufsize);
450 return msgbuf;
451 }
Martin v. Löwis18e16552006-02-15 17:27:45 +0000452 msg = convertitem(item, &format, p_va, flags, levels+1,
453 msgbuf, bufsize, freelist);
Guido van Rossum66368cc1999-02-17 23:16:43 +0000454 /* PySequence_GetItem calls tp->sq_item, which INCREFs */
455 Py_XDECREF(item);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000456 if (msg != NULL) {
457 levels[0] = i+1;
458 return msg;
459 }
460 }
Ka-Ping Yee20579702001-01-15 22:14:16 +0000461
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000462 *p_format = format;
463 return NULL;
464}
465
466
467/* Convert a single item. */
468
469static char *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000470convertitem(PyObject *arg, const char **p_format, va_list *p_va, int flags,
471 int *levels, char *msgbuf, size_t bufsize, PyObject **freelist)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000472{
473 char *msg;
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000474 const char *format = *p_format;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000475
476 if (*format == '(' /* ')' */) {
477 format++;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000478 msg = converttuple(arg, &format, p_va, flags, levels, msgbuf,
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000479 bufsize, 0, freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000480 if (msg == NULL)
481 format++;
482 }
483 else {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000484 msg = convertsimple(arg, &format, p_va, flags,
485 msgbuf, bufsize, freelist);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000486 if (msg != NULL)
487 levels[0] = 0;
488 }
489 if (msg == NULL)
490 *p_format = format;
491 return msg;
492}
493
494
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000495
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000496#define UNICODE_DEFAULT_ENCODING(arg) \
497 _PyUnicode_AsDefaultEncodedString(arg, NULL)
498
499/* Format an error message generated by convertsimple(). */
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000500
501static char *
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000502converterr(const char *expected, PyObject *arg, char *msgbuf, size_t bufsize)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000503{
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000504 assert(expected != NULL);
505 assert(arg != NULL);
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000506 PyOS_snprintf(msgbuf, bufsize,
507 "must be %.50s, not %.50s", expected,
508 arg == Py_None ? "None" : arg->ob_type->tp_name);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000509 return msgbuf;
510}
511
512#define CONV_UNICODE "(unicode conversion error)"
513
Neil Schemenauer5042da62003-02-04 20:59:40 +0000514/* explicitly check for float arguments when integers are expected. For now
515 * signal a warning. Returns true if an exception was raised. */
516static int
517float_argument_error(PyObject *arg)
518{
519 if (PyFloat_Check(arg) &&
520 PyErr_Warn(PyExc_DeprecationWarning,
521 "integer argument expected, got float" ))
522 return 1;
523 else
524 return 0;
525}
526
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000527/* Convert a non-tuple argument. Return NULL if conversion went OK,
528 or a string with a message describing the failure. The message is
529 formatted as "must be <desired type>, not <actual type>".
530 When failing, an exception may or may not have been raised.
Georg Brandl6dd14612005-09-14 19:29:53 +0000531 Don't call if a tuple is expected.
532
533 When you add new format codes, please don't forget poor skipitem() below.
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000534*/
535
536static char *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000537convertsimple(PyObject *arg, const char **p_format, va_list *p_va, int flags,
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000538 char *msgbuf, size_t bufsize, PyObject **freelist)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000539{
Martin v. Löwis18e16552006-02-15 17:27:45 +0000540 /* For # codes */
541#define FETCH_SIZE int *q=NULL;Py_ssize_t *q2=NULL;\
542 if (flags & FLAG_SIZE_T) q2=va_arg(*p_va, Py_ssize_t*); \
543 else q=va_arg(*p_va, int*);
544#define STORE_SIZE(s) if (flags & FLAG_SIZE_T) *q2=s; else *q=s;
545#define BUFFER_LEN ((flags & FLAG_SIZE_T) ? *q2:*q)
546
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000547 const char *format = *p_format;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000548 char c = *format++;
Walter Dörwalddffda2e2002-11-21 20:23:11 +0000549#ifdef Py_USING_UNICODE
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000550 PyObject *uarg;
Walter Dörwalddffda2e2002-11-21 20:23:11 +0000551#endif
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000552
553 switch (c) {
554
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000555 case 'b': { /* unsigned byte -- very short int */
556 char *p = va_arg(*p_va, char *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000557 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000558 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000559 return converterr("integer<b>", arg, msgbuf, bufsize);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000560 ival = PyInt_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000561 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000562 return converterr("integer<b>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000563 else if (ival < 0) {
564 PyErr_SetString(PyExc_OverflowError,
565 "unsigned byte integer is less than minimum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000566 return converterr("integer<b>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000567 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000568 else if (ival > UCHAR_MAX) {
569 PyErr_SetString(PyExc_OverflowError,
570 "unsigned byte integer is greater than maximum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000571 return converterr("integer<b>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000572 }
573 else
574 *p = (unsigned char) ival;
575 break;
576 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000577
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000578 case 'B': {/* byte sized bitfield - both signed and unsigned
579 values allowed */
580 char *p = va_arg(*p_va, char *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000581 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000582 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000583 return converterr("integer<B>", arg, msgbuf, bufsize);
Thomas Hellera4ea6032003-04-17 18:55:45 +0000584 ival = PyInt_AsUnsignedLongMask(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000585 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000586 return converterr("integer<B>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000587 else
588 *p = (unsigned char) ival;
589 break;
590 }
Jack Jansencc22fbe2000-08-05 21:29:58 +0000591
Guido van Rossumfce26e72003-04-18 00:12:30 +0000592 case 'h': {/* signed short int */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000593 short *p = va_arg(*p_va, short *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000594 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000595 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000596 return converterr("integer<h>", arg, msgbuf, bufsize);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000597 ival = PyInt_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000598 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000599 return converterr("integer<h>", arg, msgbuf, bufsize);
Guido van Rossumfce26e72003-04-18 00:12:30 +0000600 else if (ival < SHRT_MIN) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000601 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumfce26e72003-04-18 00:12:30 +0000602 "signed short integer is less than minimum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000603 return converterr("integer<h>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000604 }
Guido van Rossumfce26e72003-04-18 00:12:30 +0000605 else if (ival > SHRT_MAX) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000606 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumfce26e72003-04-18 00:12:30 +0000607 "signed short integer is greater than maximum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000608 return converterr("integer<h>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000609 }
610 else
611 *p = (short) ival;
612 break;
613 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000614
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000615 case 'H': { /* short int sized bitfield, both signed and
616 unsigned allowed */
617 unsigned short *p = va_arg(*p_va, unsigned short *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000618 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000619 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000620 return converterr("integer<H>", arg, msgbuf, bufsize);
Thomas Hellera4ea6032003-04-17 18:55:45 +0000621 ival = PyInt_AsUnsignedLongMask(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000622 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000623 return converterr("integer<H>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000624 else
625 *p = (unsigned short) ival;
626 break;
627 }
Martin v. Löwis18e16552006-02-15 17:27:45 +0000628
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000629 case 'i': {/* signed int */
630 int *p = va_arg(*p_va, int *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000631 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000632 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000633 return converterr("integer<i>", arg, msgbuf, bufsize);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000634 ival = PyInt_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000635 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000636 return converterr("integer<i>", arg, msgbuf, bufsize);
Georg Brandl98251f82006-06-08 13:31:07 +0000637 else if (ival > INT_MAX) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000638 PyErr_SetString(PyExc_OverflowError,
639 "signed integer is greater than maximum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000640 return converterr("integer<i>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000641 }
Georg Brandl98251f82006-06-08 13:31:07 +0000642 else if (ival < INT_MIN) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000643 PyErr_SetString(PyExc_OverflowError,
644 "signed integer is less than minimum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000645 return converterr("integer<i>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000646 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000647 else
648 *p = ival;
649 break;
650 }
651
Thomas Hellera4ea6032003-04-17 18:55:45 +0000652 case 'I': { /* int sized bitfield, both signed and
653 unsigned allowed */
654 unsigned int *p = va_arg(*p_va, unsigned int *);
655 unsigned int ival;
656 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000657 return converterr("integer<I>", arg, msgbuf, bufsize);
Skip Montanarob5079722006-04-18 00:57:15 +0000658 ival = (unsigned int)PyInt_AsUnsignedLongMask(arg);
659 if (ival == (unsigned int)-1 && PyErr_Occurred())
Thomas Hellera4ea6032003-04-17 18:55:45 +0000660 return converterr("integer<I>", arg, msgbuf, bufsize);
661 else
662 *p = ival;
663 break;
664 }
665
Martin v. Löwis18e16552006-02-15 17:27:45 +0000666 case 'n': /* Py_ssize_t */
667#if SIZEOF_SIZE_T != SIZEOF_LONG
668 {
669 Py_ssize_t *p = va_arg(*p_va, Py_ssize_t *);
670 Py_ssize_t ival;
671 if (float_argument_error(arg))
Georg Brandl7f573f72006-04-13 07:59:30 +0000672 return converterr("integer<n>", arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000673 ival = PyInt_AsSsize_t(arg);
674 if (ival == -1 && PyErr_Occurred())
Georg Brandl7f573f72006-04-13 07:59:30 +0000675 return converterr("integer<n>", arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000676 *p = ival;
677 break;
678 }
679#endif
680 /* Fall through from 'n' to 'l' if Py_ssize_t is int */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000681 case 'l': {/* long int */
682 long *p = va_arg(*p_va, long *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000683 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000684 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000685 return converterr("integer<l>", arg, msgbuf, bufsize);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000686 ival = PyInt_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000687 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000688 return converterr("integer<l>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000689 else
690 *p = ival;
691 break;
692 }
Thomas Hellera4ea6032003-04-17 18:55:45 +0000693
694 case 'k': { /* long sized bitfield */
695 unsigned long *p = va_arg(*p_va, unsigned long *);
696 unsigned long ival;
697 if (PyInt_Check(arg))
698 ival = PyInt_AsUnsignedLongMask(arg);
699 else if (PyLong_Check(arg))
700 ival = PyLong_AsUnsignedLongMask(arg);
701 else
702 return converterr("integer<k>", arg, msgbuf, bufsize);
703 *p = ival;
704 break;
705 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000706
Guido van Rossum3dbba6e1999-01-25 21:48:56 +0000707#ifdef HAVE_LONG_LONG
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000708 case 'L': {/* PY_LONG_LONG */
709 PY_LONG_LONG *p = va_arg( *p_va, PY_LONG_LONG * );
710 PY_LONG_LONG ival = PyLong_AsLongLong( arg );
711 if( ival == (PY_LONG_LONG)-1 && PyErr_Occurred() ) {
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000712 return converterr("long<L>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000713 } else {
714 *p = ival;
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000715 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000716 break;
717 }
Thomas Hellera4ea6032003-04-17 18:55:45 +0000718
719 case 'K': { /* long long sized bitfield */
720 unsigned PY_LONG_LONG *p = va_arg(*p_va, unsigned PY_LONG_LONG *);
721 unsigned PY_LONG_LONG ival;
Thomas Hellera4ea6032003-04-17 18:55:45 +0000722 if (PyInt_Check(arg))
723 ival = PyInt_AsUnsignedLongMask(arg);
724 else if (PyLong_Check(arg))
725 ival = PyLong_AsUnsignedLongLongMask(arg);
726 else
727 return converterr("integer<K>", arg, msgbuf, bufsize);
728 *p = ival;
729 break;
730 }
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000731#endif
732
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000733 case 'f': {/* float */
734 float *p = va_arg(*p_va, float *);
735 double dval = PyFloat_AsDouble(arg);
736 if (PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000737 return converterr("float<f>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000738 else
739 *p = (float) dval;
740 break;
741 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000742
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000743 case 'd': {/* double */
744 double *p = va_arg(*p_va, double *);
745 double dval = PyFloat_AsDouble(arg);
746 if (PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000747 return converterr("float<d>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000748 else
749 *p = dval;
750 break;
751 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000752
Guido van Rossum530956d1996-07-21 02:27:43 +0000753#ifndef WITHOUT_COMPLEX
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000754 case 'D': {/* complex double */
755 Py_complex *p = va_arg(*p_va, Py_complex *);
756 Py_complex cval;
757 cval = PyComplex_AsCComplex(arg);
758 if (PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000759 return converterr("complex<D>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000760 else
761 *p = cval;
762 break;
763 }
Guido van Rossum530956d1996-07-21 02:27:43 +0000764#endif /* WITHOUT_COMPLEX */
Guido van Rossum8a5c5d21996-01-12 01:09:56 +0000765
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000766 case 'c': {/* char */
767 char *p = va_arg(*p_va, char *);
768 if (PyString_Check(arg) && PyString_Size(arg) == 1)
Jeremy Hylton0407aea2001-10-10 02:51:57 +0000769 *p = PyString_AS_STRING(arg)[0];
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000770 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000771 return converterr("char", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000772 break;
773 }
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000774
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000775 case 's': {/* string */
776 if (*format == '#') {
777 void **p = (void **)va_arg(*p_va, char **);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000778 FETCH_SIZE;
Guido van Rossumfdf95dd1997-05-05 22:15:02 +0000779
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000780 if (PyString_Check(arg)) {
781 *p = PyString_AS_STRING(arg);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000782 STORE_SIZE(PyString_GET_SIZE(arg));
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000783 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000784#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000785 else if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000786 uarg = UNICODE_DEFAULT_ENCODING(arg);
787 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000788 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000789 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000790 *p = PyString_AS_STRING(uarg);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000791 STORE_SIZE(PyString_GET_SIZE(uarg));
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000792 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000793#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000794 else { /* any buffer-like object */
795 char *buf;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000796 Py_ssize_t count = convertbuffer(arg, p, &buf);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000797 if (count < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000798 return converterr(buf, arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000799 STORE_SIZE(count);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000800 }
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000801 format++;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000802 } else {
803 char **p = va_arg(*p_va, char **);
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000804
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000805 if (PyString_Check(arg))
806 *p = PyString_AS_STRING(arg);
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000807#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000808 else if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000809 uarg = UNICODE_DEFAULT_ENCODING(arg);
810 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000811 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000812 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000813 *p = PyString_AS_STRING(uarg);
Marc-André Lemburg6f15e572001-05-02 17:16:16 +0000814 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000815#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000816 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000817 return converterr("string", arg, msgbuf, bufsize);
Armin Rigo4b63c212006-10-04 11:44:06 +0000818 if ((Py_ssize_t)strlen(*p) != PyString_Size(arg))
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000819 return converterr("string without null bytes",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000820 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000821 }
822 break;
823 }
824
825 case 'z': {/* string, may be NULL (None) */
826 if (*format == '#') { /* any buffer-like object */
827 void **p = (void **)va_arg(*p_va, char **);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000828 FETCH_SIZE;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000829
830 if (arg == Py_None) {
831 *p = 0;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000832 STORE_SIZE(0);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000833 }
834 else if (PyString_Check(arg)) {
835 *p = PyString_AS_STRING(arg);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000836 STORE_SIZE(PyString_GET_SIZE(arg));
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000837 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000838#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000839 else if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000840 uarg = UNICODE_DEFAULT_ENCODING(arg);
841 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000842 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000843 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000844 *p = PyString_AS_STRING(uarg);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000845 STORE_SIZE(PyString_GET_SIZE(uarg));
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000846 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000847#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000848 else { /* any buffer-like object */
849 char *buf;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000850 Py_ssize_t count = convertbuffer(arg, p, &buf);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000851 if (count < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000852 return converterr(buf, arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000853 STORE_SIZE(count);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000854 }
855 format++;
856 } else {
857 char **p = va_arg(*p_va, char **);
858
859 if (arg == Py_None)
860 *p = 0;
861 else if (PyString_Check(arg))
Jeremy Hyltona4c8cd72001-10-10 02:51:08 +0000862 *p = PyString_AS_STRING(arg);
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000863#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000864 else if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000865 uarg = UNICODE_DEFAULT_ENCODING(arg);
866 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000867 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000868 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000869 *p = PyString_AS_STRING(uarg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000870 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000871#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000872 else
873 return converterr("string or None",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000874 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000875 if (*format == '#') {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000876 FETCH_SIZE;
Thomas Woutersc3547a32006-03-01 21:31:21 +0000877 assert(0); /* XXX redundant with if-case */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000878 if (arg == Py_None)
879 *q = 0;
880 else
881 *q = PyString_Size(arg);
882 format++;
883 }
884 else if (*p != NULL &&
Armin Rigo4b63c212006-10-04 11:44:06 +0000885 (Py_ssize_t)strlen(*p) != PyString_Size(arg))
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000886 return converterr(
887 "string without null bytes or None",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000888 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000889 }
890 break;
891 }
892
893 case 'e': {/* encoded string */
894 char **buffer;
895 const char *encoding;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000896 PyObject *s;
Amaury Forgeot d'Arc8334a4f2007-11-30 21:53:17 +0000897 Py_ssize_t size;
898 int recode_strings;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000899
900 /* Get 'e' parameter: the encoding name */
901 encoding = (const char *)va_arg(*p_va, const char *);
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000902#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000903 if (encoding == NULL)
904 encoding = PyUnicode_GetDefaultEncoding();
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000905#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000906
907 /* Get output buffer parameter:
908 's' (recode all objects via Unicode) or
909 't' (only recode non-string objects)
910 */
911 if (*format == 's')
912 recode_strings = 1;
913 else if (*format == 't')
914 recode_strings = 0;
915 else
916 return converterr(
917 "(unknown parser marker combination)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000918 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000919 buffer = (char **)va_arg(*p_va, char **);
920 format++;
921 if (buffer == NULL)
922 return converterr("(buffer is NULL)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000923 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000924
925 /* Encode object */
926 if (!recode_strings && PyString_Check(arg)) {
927 s = arg;
928 Py_INCREF(s);
929 }
930 else {
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000931#ifdef Py_USING_UNICODE
932 PyObject *u;
933
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000934 /* Convert object to Unicode */
935 u = PyUnicode_FromObject(arg);
936 if (u == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000937 return converterr(
938 "string or unicode or text buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000939 arg, msgbuf, bufsize);
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000940
941 /* Encode object; use default error handling */
942 s = PyUnicode_AsEncodedString(u,
943 encoding,
944 NULL);
945 Py_DECREF(u);
946 if (s == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000947 return converterr("(encoding failed)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000948 arg, msgbuf, bufsize);
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000949 if (!PyString_Check(s)) {
950 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000951 return converterr(
952 "(encoder failed to return a string)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000953 arg, msgbuf, bufsize);
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000954 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000955#else
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000956 return converterr("string<e>", arg, msgbuf, bufsize);
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000957#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000958 }
959 size = PyString_GET_SIZE(s);
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000960
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000961 /* Write output; output is guaranteed to be 0-terminated */
962 if (*format == '#') {
963 /* Using buffer length parameter '#':
964
965 - if *buffer is NULL, a new buffer of the
966 needed size is allocated and the data
967 copied into it; *buffer is updated to point
968 to the new buffer; the caller is
969 responsible for PyMem_Free()ing it after
970 usage
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000971
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000972 - if *buffer is not NULL, the data is
973 copied to *buffer; *buffer_len has to be
974 set to the size of the buffer on input;
975 buffer overflow is signalled with an error;
976 buffer has to provide enough room for the
977 encoded string plus the trailing 0-byte
978
979 - in both cases, *buffer_len is updated to
980 the size of the buffer /excluding/ the
981 trailing 0-byte
982
983 */
Martin v. Löwis18e16552006-02-15 17:27:45 +0000984 FETCH_SIZE;
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000985
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000986 format++;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000987 if (q == NULL && q2 == NULL) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000988 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000989 return converterr(
990 "(buffer_len is NULL)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000991 arg, msgbuf, bufsize);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000992 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000993 if (*buffer == NULL) {
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000994 *buffer = PyMem_NEW(char, size + 1);
995 if (*buffer == NULL) {
996 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000997 return converterr(
998 "(memory error)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000999 arg, msgbuf, bufsize);
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001000 }
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001001 if(addcleanup(*buffer, freelist)) {
1002 Py_DECREF(s);
1003 return converterr(
1004 "(cleanup problem)",
1005 arg, msgbuf, bufsize);
1006 }
Fred Drake25871c02000-05-03 15:17:02 +00001007 } else {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001008 if (size + 1 > BUFFER_LEN) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001009 Py_DECREF(s);
1010 return converterr(
1011 "(buffer overflow)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001012 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001013 }
Fred Drake25871c02000-05-03 15:17:02 +00001014 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001015 memcpy(*buffer,
1016 PyString_AS_STRING(s),
1017 size + 1);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001018 STORE_SIZE(size);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001019 } else {
1020 /* Using a 0-terminated buffer:
1021
1022 - the encoded string has to be 0-terminated
1023 for this variant to work; if it is not, an
1024 error raised
Fred Drake25871c02000-05-03 15:17:02 +00001025
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001026 - a new buffer of the needed size is
1027 allocated and the data copied into it;
1028 *buffer is updated to point to the new
1029 buffer; the caller is responsible for
1030 PyMem_Free()ing it after usage
1031
1032 */
Armin Rigo4b63c212006-10-04 11:44:06 +00001033 if ((Py_ssize_t)strlen(PyString_AS_STRING(s))
1034 != size) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001035 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001036 return converterr(
1037 "(encoded string without NULL bytes)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001038 arg, msgbuf, bufsize);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001039 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001040 *buffer = PyMem_NEW(char, size + 1);
1041 if (*buffer == NULL) {
1042 Py_DECREF(s);
1043 return converterr("(memory error)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001044 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001045 }
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001046 if(addcleanup(*buffer, freelist)) {
1047 Py_DECREF(s);
1048 return converterr("(cleanup problem)",
1049 arg, msgbuf, bufsize);
1050 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001051 memcpy(*buffer,
1052 PyString_AS_STRING(s),
1053 size + 1);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001054 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001055 Py_DECREF(s);
1056 break;
1057 }
1058
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001059#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001060 case 'u': {/* raw unicode buffer (Py_UNICODE *) */
1061 if (*format == '#') { /* any buffer-like object */
1062 void **p = (void **)va_arg(*p_va, char **);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001063 FETCH_SIZE;
Marc-André Lemburg3e3eacb2002-01-09 16:21:27 +00001064 if (PyUnicode_Check(arg)) {
1065 *p = PyUnicode_AS_UNICODE(arg);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001066 STORE_SIZE(PyUnicode_GET_SIZE(arg));
Marc-André Lemburg3e3eacb2002-01-09 16:21:27 +00001067 }
1068 else {
Neal Norwitz61546162006-04-14 05:20:28 +00001069 return converterr("cannot convert raw buffers",
1070 arg, msgbuf, bufsize);
Marc-André Lemburg3e3eacb2002-01-09 16:21:27 +00001071 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001072 format++;
1073 } else {
1074 Py_UNICODE **p = va_arg(*p_va, Py_UNICODE **);
Guido van Rossume826ef02000-03-10 23:02:17 +00001075 if (PyUnicode_Check(arg))
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001076 *p = PyUnicode_AS_UNICODE(arg);
1077 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001078 return converterr("unicode", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001079 }
1080 break;
1081 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001082#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001083
1084 case 'S': { /* string object */
1085 PyObject **p = va_arg(*p_va, PyObject **);
1086 if (PyString_Check(arg))
1087 *p = arg;
1088 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001089 return converterr("string", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001090 break;
1091 }
1092
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001093#ifdef Py_USING_UNICODE
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001094 case 'U': { /* Unicode object */
1095 PyObject **p = va_arg(*p_va, PyObject **);
1096 if (PyUnicode_Check(arg))
1097 *p = arg;
1098 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001099 return converterr("unicode", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001100 break;
1101 }
Martin v. Löwis339d0f72001-08-17 18:39:25 +00001102#endif
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001103
1104 case 'O': { /* object */
1105 PyTypeObject *type;
1106 PyObject **p;
1107 if (*format == '!') {
1108 type = va_arg(*p_va, PyTypeObject*);
1109 p = va_arg(*p_va, PyObject **);
1110 format++;
Guido van Rossumcbfc8552001-08-28 16:37:51 +00001111 if (PyType_IsSubtype(arg->ob_type, type))
Guido van Rossume826ef02000-03-10 23:02:17 +00001112 *p = arg;
1113 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001114 return converterr(type->tp_name, arg, msgbuf, bufsize);
Guido van Rossumfccfe891998-05-15 22:04:07 +00001115
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001116 }
1117 else if (*format == '?') {
1118 inquiry pred = va_arg(*p_va, inquiry);
1119 p = va_arg(*p_va, PyObject **);
1120 format++;
1121 if ((*pred)(arg))
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001122 *p = arg;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001123 else
1124 return converterr("(unspecified)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001125 arg, msgbuf, bufsize);
Guido van Rossumfdf95dd1997-05-05 22:15:02 +00001126
Guido van Rossumfdf95dd1997-05-05 22:15:02 +00001127 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001128 else if (*format == '&') {
1129 typedef int (*converter)(PyObject *, void *);
1130 converter convert = va_arg(*p_va, converter);
1131 void *addr = va_arg(*p_va, void *);
1132 format++;
1133 if (! (*convert)(arg, addr))
1134 return converterr("(unspecified)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001135 arg, msgbuf, bufsize);
Guido van Rossumb317f8a1998-10-08 02:21:21 +00001136 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001137 else {
1138 p = va_arg(*p_va, PyObject **);
1139 *p = arg;
1140 }
1141 break;
1142 }
Guido van Rossumb317f8a1998-10-08 02:21:21 +00001143
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001144
1145 case 'w': { /* memory buffer, read-write access */
1146 void **p = va_arg(*p_va, void **);
1147 PyBufferProcs *pb = arg->ob_type->tp_as_buffer;
Amaury Forgeot d'Arc8334a4f2007-11-30 21:53:17 +00001148 Py_ssize_t count;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001149
1150 if (pb == NULL ||
1151 pb->bf_getwritebuffer == NULL ||
1152 pb->bf_getsegcount == NULL)
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001153 return converterr("read-write buffer", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001154 if ((*pb->bf_getsegcount)(arg, NULL) != 1)
1155 return converterr("single-segment read-write buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001156 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001157 if ((count = pb->bf_getwritebuffer(arg, 0, p)) < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001158 return converterr("(unspecified)", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001159 if (*format == '#') {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001160 FETCH_SIZE;
1161 STORE_SIZE(count);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001162 format++;
1163 }
1164 break;
1165 }
1166
1167 case 't': { /* 8-bit character buffer, read-only access */
Martin v. Löwis15e62742006-02-27 16:46:16 +00001168 char **p = va_arg(*p_va, char **);
Jeremy Hylton4819e972001-10-11 14:40:37 +00001169 PyBufferProcs *pb = arg->ob_type->tp_as_buffer;
Amaury Forgeot d'Arc8334a4f2007-11-30 21:53:17 +00001170 Py_ssize_t count;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001171
1172 if (*format++ != '#')
1173 return converterr(
1174 "invalid use of 't' format character",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001175 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001176 if (!PyType_HasFeature(arg->ob_type,
Jeremy Hylton4819e972001-10-11 14:40:37 +00001177 Py_TPFLAGS_HAVE_GETCHARBUFFER) ||
1178 pb == NULL || pb->bf_getcharbuffer == NULL ||
1179 pb->bf_getsegcount == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001180 return converterr(
1181 "string or read-only character buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001182 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001183
Jeremy Hylton4819e972001-10-11 14:40:37 +00001184 if (pb->bf_getsegcount(arg, NULL) != 1)
1185 return converterr(
1186 "string or single-segment read-only buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001187 arg, msgbuf, bufsize);
Jeremy Hylton4819e972001-10-11 14:40:37 +00001188
1189 count = pb->bf_getcharbuffer(arg, 0, p);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001190 if (count < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001191 return converterr("(unspecified)", arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001192 {
1193 FETCH_SIZE;
1194 STORE_SIZE(count);
1195 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001196 break;
1197 }
1198
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001199 default:
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001200 return converterr("impossible<bad format char>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001201
1202 }
1203
1204 *p_format = format;
1205 return NULL;
1206}
Guido van Rossumaa354651996-08-19 19:32:04 +00001207
Martin v. Löwis18e16552006-02-15 17:27:45 +00001208static Py_ssize_t
Fred Drake563dfc22001-10-23 14:41:08 +00001209convertbuffer(PyObject *arg, void **p, char **errmsg)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001210{
1211 PyBufferProcs *pb = arg->ob_type->tp_as_buffer;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001212 Py_ssize_t count;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001213 if (pb == NULL ||
1214 pb->bf_getreadbuffer == NULL ||
1215 pb->bf_getsegcount == NULL) {
1216 *errmsg = "string or read-only buffer";
1217 return -1;
1218 }
1219 if ((*pb->bf_getsegcount)(arg, NULL) != 1) {
1220 *errmsg = "string or single-segment read-only buffer";
1221 return -1;
1222 }
1223 if ((count = (*pb->bf_getreadbuffer)(arg, 0, p)) < 0) {
1224 *errmsg = "(unspecified)";
1225 }
1226 return count;
1227}
Guido van Rossumaa354651996-08-19 19:32:04 +00001228
1229/* Support for keyword arguments donated by
1230 Geoff Philbrick <philbric@delphi.hks.com> */
1231
Tim Petersf8cd3e82001-10-27 04:26:57 +00001232/* Return false (0) for error, else true. */
Fred Drake563dfc22001-10-23 14:41:08 +00001233int
1234PyArg_ParseTupleAndKeywords(PyObject *args,
1235 PyObject *keywords,
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001236 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001237 char **kwlist, ...)
Guido van Rossumaa354651996-08-19 19:32:04 +00001238{
1239 int retval;
1240 va_list va;
Tim Peters45772cd2001-10-27 03:58:40 +00001241
1242 if ((args == NULL || !PyTuple_Check(args)) ||
1243 (keywords != NULL && !PyDict_Check(keywords)) ||
1244 format == NULL ||
1245 kwlist == NULL)
1246 {
1247 PyErr_BadInternalCall();
Tim Petersf8cd3e82001-10-27 04:26:57 +00001248 return 0;
Tim Peters45772cd2001-10-27 03:58:40 +00001249 }
1250
Guido van Rossumaa354651996-08-19 19:32:04 +00001251 va_start(va, kwlist);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001252 retval = vgetargskeywords(args, keywords, format, kwlist, &va, 0);
1253 va_end(va);
1254 return retval;
1255}
1256
1257int
1258_PyArg_ParseTupleAndKeywords_SizeT(PyObject *args,
1259 PyObject *keywords,
1260 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001261 char **kwlist, ...)
Martin v. Löwis18e16552006-02-15 17:27:45 +00001262{
1263 int retval;
1264 va_list va;
1265
1266 if ((args == NULL || !PyTuple_Check(args)) ||
1267 (keywords != NULL && !PyDict_Check(keywords)) ||
1268 format == NULL ||
1269 kwlist == NULL)
1270 {
1271 PyErr_BadInternalCall();
1272 return 0;
1273 }
1274
1275 va_start(va, kwlist);
1276 retval = vgetargskeywords(args, keywords, format,
1277 kwlist, &va, FLAG_SIZE_T);
Guido van Rossumaa354651996-08-19 19:32:04 +00001278 va_end(va);
1279 return retval;
1280}
1281
1282
Brett Cannon711e7d92004-07-10 22:20:32 +00001283int
1284PyArg_VaParseTupleAndKeywords(PyObject *args,
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001285 PyObject *keywords,
1286 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001287 char **kwlist, va_list va)
Brett Cannon711e7d92004-07-10 22:20:32 +00001288{
1289 int retval;
1290 va_list lva;
1291
1292 if ((args == NULL || !PyTuple_Check(args)) ||
1293 (keywords != NULL && !PyDict_Check(keywords)) ||
1294 format == NULL ||
1295 kwlist == NULL)
1296 {
1297 PyErr_BadInternalCall();
1298 return 0;
1299 }
1300
1301#ifdef VA_LIST_IS_ARRAY
1302 memcpy(lva, va, sizeof(va_list));
1303#else
1304#ifdef __va_copy
1305 __va_copy(lva, va);
1306#else
1307 lva = va;
1308#endif
1309#endif
1310
Martin v. Löwis18e16552006-02-15 17:27:45 +00001311 retval = vgetargskeywords(args, keywords, format, kwlist, &lva, 0);
1312 return retval;
1313}
1314
1315int
1316_PyArg_VaParseTupleAndKeywords_SizeT(PyObject *args,
1317 PyObject *keywords,
1318 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001319 char **kwlist, va_list va)
Martin v. Löwis18e16552006-02-15 17:27:45 +00001320{
1321 int retval;
1322 va_list lva;
1323
1324 if ((args == NULL || !PyTuple_Check(args)) ||
1325 (keywords != NULL && !PyDict_Check(keywords)) ||
1326 format == NULL ||
1327 kwlist == NULL)
1328 {
1329 PyErr_BadInternalCall();
1330 return 0;
1331 }
1332
1333#ifdef VA_LIST_IS_ARRAY
1334 memcpy(lva, va, sizeof(va_list));
1335#else
1336#ifdef __va_copy
1337 __va_copy(lva, va);
1338#else
1339 lva = va;
1340#endif
1341#endif
1342
1343 retval = vgetargskeywords(args, keywords, format,
1344 kwlist, &lva, FLAG_SIZE_T);
Brett Cannon711e7d92004-07-10 22:20:32 +00001345 return retval;
1346}
1347
1348
Guido van Rossumaa354651996-08-19 19:32:04 +00001349static int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001350vgetargskeywords(PyObject *args, PyObject *keywords, const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001351 char **kwlist, va_list *p_va, int flags)
Guido van Rossumaa354651996-08-19 19:32:04 +00001352{
Tim Petersdc5eff92001-10-27 06:53:00 +00001353 char msgbuf[512];
Guido van Rossumaa354651996-08-19 19:32:04 +00001354 int levels[32];
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001355 const char *fname, *message;
Tim Petersf8cd3e82001-10-27 04:26:57 +00001356 int min, max;
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001357 const char *formatsave;
Tim Petersb639d492001-10-27 07:00:56 +00001358 int i, len, nargs, nkeywords;
Martin v. Löwis15e62742006-02-27 16:46:16 +00001359 const char *msg;
1360 char **p;
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001361 PyObject *freelist = NULL;
Tim Petersf4331c12001-10-27 00:17:34 +00001362
Tim Peters45772cd2001-10-27 03:58:40 +00001363 assert(args != NULL && PyTuple_Check(args));
1364 assert(keywords == NULL || PyDict_Check(keywords));
1365 assert(format != NULL);
1366 assert(kwlist != NULL);
1367 assert(p_va != NULL);
1368
Tim Petersf8cd3e82001-10-27 04:26:57 +00001369 /* Search the format:
1370 message <- error msg, if any (else NULL).
Tim Peterscffed4b2001-11-29 03:26:37 +00001371 fname <- routine name, if any (else NULL).
Tim Petersf8cd3e82001-10-27 04:26:57 +00001372 min <- # of required arguments, or -1 if all are required.
1373 max <- most arguments (required + optional).
Tim Peters62d48e12001-10-27 06:42:16 +00001374 Check that kwlist has a non-NULL entry for each arg.
Tim Petersf8cd3e82001-10-27 04:26:57 +00001375 Raise error if a tuple arg spec is found.
1376 */
1377 fname = message = NULL;
Tim Peters6fb26352001-10-27 04:38:11 +00001378 formatsave = format;
Tim Peters62d48e12001-10-27 06:42:16 +00001379 p = kwlist;
Tim Petersf8cd3e82001-10-27 04:26:57 +00001380 min = -1;
1381 max = 0;
1382 while ((i = *format++) != '\0') {
Neal Norwitz30b5c5d2005-12-19 06:05:18 +00001383 if (isalpha(Py_CHARMASK(i)) && i != 'e') {
Tim Petersf8cd3e82001-10-27 04:26:57 +00001384 max++;
Tim Peters62d48e12001-10-27 06:42:16 +00001385 if (*p == NULL) {
Tim Peterscffed4b2001-11-29 03:26:37 +00001386 PyErr_SetString(PyExc_RuntimeError,
1387 "more argument specifiers than "
1388 "keyword list entries");
Tim Peters62d48e12001-10-27 06:42:16 +00001389 return 0;
1390 }
1391 p++;
1392 }
Tim Petersf8cd3e82001-10-27 04:26:57 +00001393 else if (i == '|')
1394 min = max;
1395 else if (i == ':') {
1396 fname = format;
1397 break;
1398 }
1399 else if (i == ';') {
1400 message = format;
1401 break;
1402 }
1403 else if (i == '(') {
Tim Peterscffed4b2001-11-29 03:26:37 +00001404 PyErr_SetString(PyExc_RuntimeError,
1405 "tuple found in format when using keyword "
1406 "arguments");
Guido van Rossumaa354651996-08-19 19:32:04 +00001407 return 0;
1408 }
Tim Peters62d48e12001-10-27 06:42:16 +00001409 }
1410 format = formatsave;
1411 if (*p != NULL) {
Tim Peterscffed4b2001-11-29 03:26:37 +00001412 PyErr_SetString(PyExc_RuntimeError,
1413 "more keyword list entries than "
1414 "argument specifiers");
Tim Peters62d48e12001-10-27 06:42:16 +00001415 return 0;
1416 }
Tim Petersf8cd3e82001-10-27 04:26:57 +00001417 if (min < 0) {
1418 /* All arguments are required. */
Guido van Rossumaa354651996-08-19 19:32:04 +00001419 min = max;
Tim Petersf8cd3e82001-10-27 04:26:57 +00001420 }
Tim Petersf8cd3e82001-10-27 04:26:57 +00001421
Tim Peters6fb26352001-10-27 04:38:11 +00001422 nargs = PyTuple_GET_SIZE(args);
Tim Petersb0872fc2001-10-27 04:45:34 +00001423 nkeywords = keywords == NULL ? 0 : PyDict_Size(keywords);
Tim Petersf8cd3e82001-10-27 04:26:57 +00001424
Guido van Rossumaa354651996-08-19 19:32:04 +00001425 /* make sure there are no duplicate values for an argument;
1426 its not clear when to use the term "keyword argument vs.
1427 keyword parameter in messages */
Tim Petersb054be42001-10-27 05:07:41 +00001428 if (nkeywords > 0) {
Tim Peters6fb26352001-10-27 04:38:11 +00001429 for (i = 0; i < nargs; i++) {
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001430 const char *thiskw = kwlist[i];
Tim Petersa9f47392001-10-27 00:46:09 +00001431 if (thiskw == NULL)
1432 break;
Tim Peters077f5742001-10-27 05:50:39 +00001433 if (PyDict_GetItemString(keywords, thiskw)) {
Tim Petersb054be42001-10-27 05:07:41 +00001434 PyErr_Format(PyExc_TypeError,
1435 "keyword parameter '%s' was given "
1436 "by position and by name",
Tim Petersa9f47392001-10-27 00:46:09 +00001437 thiskw);
Guido van Rossumaa354651996-08-19 19:32:04 +00001438 return 0;
1439 }
Tim Peters0af49162001-10-27 06:14:32 +00001440 else if (PyErr_Occurred())
1441 return 0;
Guido van Rossumaa354651996-08-19 19:32:04 +00001442 }
1443 }
Tim Peters61dde632001-10-27 05:30:17 +00001444
Guido van Rossumaa354651996-08-19 19:32:04 +00001445 /* required arguments missing from args can be supplied by keyword
Georg Brandld7048172006-01-20 17:53:27 +00001446 arguments; set len to the number of positional arguments, and,
Tim Peters62d48e12001-10-27 06:42:16 +00001447 if that's less than the minimum required, add in the number of
1448 required arguments that are supplied by keywords */
Tim Peters6fb26352001-10-27 04:38:11 +00001449 len = nargs;
Tim Peters62d48e12001-10-27 06:42:16 +00001450 if (nkeywords > 0 && nargs < min) {
Tim Peters6fb26352001-10-27 04:38:11 +00001451 for (i = nargs; i < min; i++) {
Tim Peters077f5742001-10-27 05:50:39 +00001452 if (PyDict_GetItemString(keywords, kwlist[i]))
Guido van Rossumaa354651996-08-19 19:32:04 +00001453 len++;
Tim Peters0af49162001-10-27 06:14:32 +00001454 else if (PyErr_Occurred())
1455 return 0;
Guido van Rossumaa354651996-08-19 19:32:04 +00001456 }
1457 }
Tim Peters0af49162001-10-27 06:14:32 +00001458
Guido van Rossumaa354651996-08-19 19:32:04 +00001459 /* make sure we got an acceptable number of arguments; the message
1460 is a little confusing with keywords since keyword arguments
1461 which are supplied, but don't match the required arguments
Michael W. Hudson5253c302005-03-30 16:41:55 +00001462 are not included in the "%d given" part of the message
1463 XXX and this isn't a bug!? */
Guido van Rossumaa354651996-08-19 19:32:04 +00001464 if (len < min || max < len) {
1465 if (message == NULL) {
Jeremy Hylton23ae9872001-11-28 20:29:22 +00001466 PyOS_snprintf(msgbuf, sizeof(msgbuf),
1467 "%.200s%s takes %s %d argument%s "
1468 "(%d given)",
1469 fname==NULL ? "function" : fname,
1470 fname==NULL ? "" : "()",
1471 min==max ? "exactly"
1472 : len < min ? "at least" : "at most",
1473 len < min ? min : max,
1474 (len < min ? min : max) == 1 ? "" : "s",
1475 len);
Guido van Rossumaa354651996-08-19 19:32:04 +00001476 message = msgbuf;
1477 }
1478 PyErr_SetString(PyExc_TypeError, message);
1479 return 0;
1480 }
Tim Petersc2f01122001-10-27 07:25:06 +00001481
1482 /* convert the positional arguments */
Tim Peters6fb26352001-10-27 04:38:11 +00001483 for (i = 0; i < nargs; i++) {
Guido van Rossumaa354651996-08-19 19:32:04 +00001484 if (*format == '|')
1485 format++;
Jeremy Hylton0f8117f2001-05-18 20:57:38 +00001486 msg = convertitem(PyTuple_GET_ITEM(args, i), &format, p_va,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001487 flags, levels, msgbuf, sizeof(msgbuf),
1488 &freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001489 if (msg) {
1490 seterror(i+1, msg, levels, fname, message);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001491 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001492 }
1493 }
1494
Tim Petersc2f01122001-10-27 07:25:06 +00001495 /* handle no keyword parameters in call */
Tim Petersb054be42001-10-27 05:07:41 +00001496 if (nkeywords == 0)
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001497 return cleanreturn(1, freelist);
Tim Petersb054be42001-10-27 05:07:41 +00001498
Guido van Rossumaa354651996-08-19 19:32:04 +00001499 /* convert the keyword arguments; this uses the format
1500 string where it was left after processing args */
Tim Petersb639d492001-10-27 07:00:56 +00001501 for (i = nargs; i < max; i++) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001502 PyObject *item;
Guido van Rossumaa354651996-08-19 19:32:04 +00001503 if (*format == '|')
1504 format++;
Tim Peters077f5742001-10-27 05:50:39 +00001505 item = PyDict_GetItemString(keywords, kwlist[i]);
Guido van Rossum80bb9651996-12-05 23:27:02 +00001506 if (item != NULL) {
Tim Peters077f5742001-10-27 05:50:39 +00001507 Py_INCREF(item);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001508 msg = convertitem(item, &format, p_va, flags, levels,
1509 msgbuf, sizeof(msgbuf), &freelist);
Tim Peters077f5742001-10-27 05:50:39 +00001510 Py_DECREF(item);
Guido van Rossumaa354651996-08-19 19:32:04 +00001511 if (msg) {
1512 seterror(i+1, msg, levels, fname, message);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001513 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001514 }
Tim Petersc2f01122001-10-27 07:25:06 +00001515 --nkeywords;
1516 if (nkeywords == 0)
1517 break;
Guido van Rossumaa354651996-08-19 19:32:04 +00001518 }
Tim Peters0af49162001-10-27 06:14:32 +00001519 else if (PyErr_Occurred())
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001520 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001521 else {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001522 msg = skipitem(&format, p_va, flags);
Guido van Rossumaa354651996-08-19 19:32:04 +00001523 if (msg) {
Georg Brandl5f135782006-07-26 08:03:10 +00001524 levels[0] = 0;
Guido van Rossumaa354651996-08-19 19:32:04 +00001525 seterror(i+1, msg, levels, fname, message);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001526 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001527 }
1528 }
1529 }
Tim Petersb054be42001-10-27 05:07:41 +00001530
Guido van Rossumaa354651996-08-19 19:32:04 +00001531 /* make sure there are no extraneous keyword arguments */
Tim Petersc2f01122001-10-27 07:25:06 +00001532 if (nkeywords > 0) {
1533 PyObject *key, *value;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001534 Py_ssize_t pos = 0;
Guido van Rossumaa354651996-08-19 19:32:04 +00001535 while (PyDict_Next(keywords, &pos, &key, &value)) {
Tim Petersc2f01122001-10-27 07:25:06 +00001536 int match = 0;
Guido van Rossum55474762002-04-04 16:22:30 +00001537 char *ks;
1538 if (!PyString_Check(key)) {
1539 PyErr_SetString(PyExc_TypeError,
1540 "keywords must be strings");
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001541 return cleanreturn(0, freelist);
Guido van Rossum55474762002-04-04 16:22:30 +00001542 }
1543 ks = PyString_AsString(key);
Tim Petersb639d492001-10-27 07:00:56 +00001544 for (i = 0; i < max; i++) {
Guido van Rossumaa354651996-08-19 19:32:04 +00001545 if (!strcmp(ks, kwlist[i])) {
1546 match = 1;
1547 break;
1548 }
1549 }
1550 if (!match) {
Tim Petersc2f01122001-10-27 07:25:06 +00001551 PyErr_Format(PyExc_TypeError,
1552 "'%s' is an invalid keyword "
1553 "argument for this function",
1554 ks);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001555 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001556 }
1557 }
1558 }
Tim Petersc2f01122001-10-27 07:25:06 +00001559
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001560 return cleanreturn(1, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001561}
1562
1563
1564static char *
Martin v. Löwis18e16552006-02-15 17:27:45 +00001565skipitem(const char **p_format, va_list *p_va, int flags)
Guido van Rossumaa354651996-08-19 19:32:04 +00001566{
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001567 const char *format = *p_format;
Guido van Rossumaa354651996-08-19 19:32:04 +00001568 char c = *format++;
1569
1570 switch (c) {
Georg Brandl6dd14612005-09-14 19:29:53 +00001571
1572 /* simple codes
1573 * The individual types (second arg of va_arg) are irrelevant */
1574
Guido van Rossumaa354651996-08-19 19:32:04 +00001575 case 'b': /* byte -- very short int */
Jack Jansencc22fbe2000-08-05 21:29:58 +00001576 case 'B': /* byte as bitfield */
Guido van Rossumaa354651996-08-19 19:32:04 +00001577 case 'h': /* short int */
Jack Jansencc22fbe2000-08-05 21:29:58 +00001578 case 'H': /* short int as bitfield */
Guido van Rossumaa354651996-08-19 19:32:04 +00001579 case 'i': /* int */
Georg Brandl6dd14612005-09-14 19:29:53 +00001580 case 'I': /* int sized bitfield */
Guido van Rossumaa354651996-08-19 19:32:04 +00001581 case 'l': /* long int */
Georg Brandl6dd14612005-09-14 19:29:53 +00001582 case 'k': /* long int sized bitfield */
Guido van Rossum3dbba6e1999-01-25 21:48:56 +00001583#ifdef HAVE_LONG_LONG
Georg Brandl6dd14612005-09-14 19:29:53 +00001584 case 'L': /* PY_LONG_LONG */
1585 case 'K': /* PY_LONG_LONG sized bitfield */
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001586#endif
Guido van Rossumaa354651996-08-19 19:32:04 +00001587 case 'f': /* float */
Guido van Rossumaa354651996-08-19 19:32:04 +00001588 case 'd': /* double */
Guido van Rossumaa354651996-08-19 19:32:04 +00001589#ifndef WITHOUT_COMPLEX
1590 case 'D': /* complex double */
Georg Brandl6dd14612005-09-14 19:29:53 +00001591#endif
Guido van Rossumaa354651996-08-19 19:32:04 +00001592 case 'c': /* char */
1593 {
Georg Brandl6dd14612005-09-14 19:29:53 +00001594 (void) va_arg(*p_va, void *);
Guido van Rossumaa354651996-08-19 19:32:04 +00001595 break;
1596 }
Martin v. Löwis18e16552006-02-15 17:27:45 +00001597
1598 case 'n': /* Py_ssize_t */
1599 {
1600 (void) va_arg(*p_va, Py_ssize_t *);
1601 break;
1602 }
Guido van Rossumaa354651996-08-19 19:32:04 +00001603
Georg Brandl6dd14612005-09-14 19:29:53 +00001604 /* string codes */
1605
1606 case 'e': /* string with encoding */
1607 {
1608 (void) va_arg(*p_va, const char *);
1609 if (!(*format == 's' || *format == 't'))
1610 /* after 'e', only 's' and 't' is allowed */
1611 goto err;
1612 format++;
1613 /* explicit fallthrough to string cases */
1614 }
1615
Guido van Rossumaa354651996-08-19 19:32:04 +00001616 case 's': /* string */
Georg Brandl6dd14612005-09-14 19:29:53 +00001617 case 'z': /* string or None */
1618#ifdef Py_USING_UNICODE
1619 case 'u': /* unicode string */
1620#endif
1621 case 't': /* buffer, read-only */
1622 case 'w': /* buffer, read-write */
Guido van Rossumaa354651996-08-19 19:32:04 +00001623 {
Guido van Rossum80bb9651996-12-05 23:27:02 +00001624 (void) va_arg(*p_va, char **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001625 if (*format == '#') {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001626 if (flags & FLAG_SIZE_T)
1627 (void) va_arg(*p_va, Py_ssize_t *);
1628 else
1629 (void) va_arg(*p_va, int *);
Guido van Rossumaa354651996-08-19 19:32:04 +00001630 format++;
1631 }
1632 break;
1633 }
Georg Brandl6dd14612005-09-14 19:29:53 +00001634
1635 /* object codes */
1636
Guido van Rossumaa354651996-08-19 19:32:04 +00001637 case 'S': /* string object */
Georg Brandl6dd14612005-09-14 19:29:53 +00001638#ifdef Py_USING_UNICODE
1639 case 'U': /* unicode string object */
1640#endif
Guido van Rossumaa354651996-08-19 19:32:04 +00001641 {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001642 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001643 break;
1644 }
1645
1646 case 'O': /* object */
1647 {
Guido van Rossumaa354651996-08-19 19:32:04 +00001648 if (*format == '!') {
1649 format++;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001650 (void) va_arg(*p_va, PyTypeObject*);
1651 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001652 }
1653#if 0
1654/* I don't know what this is for */
1655 else if (*format == '?') {
1656 inquiry pred = va_arg(*p_va, inquiry);
1657 format++;
1658 if ((*pred)(arg)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001659 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001660 }
1661 }
1662#endif
1663 else if (*format == '&') {
Tim Petersdbd9ba62000-07-09 03:09:57 +00001664 typedef int (*converter)(PyObject *, void *);
Guido van Rossum80bb9651996-12-05 23:27:02 +00001665 (void) va_arg(*p_va, converter);
1666 (void) va_arg(*p_va, void *);
Guido van Rossumaa354651996-08-19 19:32:04 +00001667 format++;
1668 }
1669 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001670 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001671 }
1672 break;
1673 }
1674
1675 default:
Georg Brandl6dd14612005-09-14 19:29:53 +00001676err:
Guido van Rossumaa354651996-08-19 19:32:04 +00001677 return "impossible<bad format char>";
1678
1679 }
Georg Brandl6dd14612005-09-14 19:29:53 +00001680
1681 /* The "(...)" format code for tuples is not handled here because
1682 * it is not allowed with keyword args. */
Guido van Rossumaa354651996-08-19 19:32:04 +00001683
1684 *p_format = format;
1685 return NULL;
1686}
Fred Drakee4616e62001-10-23 21:09:29 +00001687
1688
1689int
Martin v. Löwis76246742006-03-01 04:06:10 +00001690PyArg_UnpackTuple(PyObject *args, const char *name, Py_ssize_t min, Py_ssize_t max, ...)
Fred Drakee4616e62001-10-23 21:09:29 +00001691{
Martin v. Löwis76246742006-03-01 04:06:10 +00001692 Py_ssize_t i, l;
Fred Drakee4616e62001-10-23 21:09:29 +00001693 PyObject **o;
1694 va_list vargs;
1695
1696#ifdef HAVE_STDARG_PROTOTYPES
1697 va_start(vargs, max);
1698#else
1699 va_start(vargs);
1700#endif
1701
1702 assert(min >= 0);
1703 assert(min <= max);
1704 if (!PyTuple_Check(args)) {
1705 PyErr_SetString(PyExc_SystemError,
1706 "PyArg_UnpackTuple() argument list is not a tuple");
1707 return 0;
1708 }
1709 l = PyTuple_GET_SIZE(args);
1710 if (l < min) {
1711 if (name != NULL)
1712 PyErr_Format(
1713 PyExc_TypeError,
Thomas Wouters572a9f32006-03-01 05:38:39 +00001714 "%s expected %s%zd arguments, got %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001715 name, (min == max ? "" : "at least "), min, l);
1716 else
1717 PyErr_Format(
1718 PyExc_TypeError,
Thomas Wouters572a9f32006-03-01 05:38:39 +00001719 "unpacked tuple should have %s%zd elements,"
1720 " but has %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001721 (min == max ? "" : "at least "), min, l);
1722 va_end(vargs);
1723 return 0;
1724 }
1725 if (l > max) {
1726 if (name != NULL)
1727 PyErr_Format(
1728 PyExc_TypeError,
Thomas Wouters572a9f32006-03-01 05:38:39 +00001729 "%s expected %s%zd arguments, got %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001730 name, (min == max ? "" : "at most "), max, l);
1731 else
1732 PyErr_Format(
1733 PyExc_TypeError,
Thomas Wouters572a9f32006-03-01 05:38:39 +00001734 "unpacked tuple should have %s%zd elements,"
1735 " but has %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001736 (min == max ? "" : "at most "), max, l);
1737 va_end(vargs);
1738 return 0;
1739 }
1740 for (i = 0; i < l; i++) {
1741 o = va_arg(vargs, PyObject **);
1742 *o = PyTuple_GET_ITEM(args, i);
1743 }
1744 va_end(vargs);
1745 return 1;
1746}
Georg Brandl02c42872005-08-26 06:42:30 +00001747
1748
1749/* For type constructors that don't take keyword args
1750 *
1751 * Sets a TypeError and returns 0 if the kwds dict is
1752 * not emtpy, returns 1 otherwise
1753 */
1754int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001755_PyArg_NoKeywords(const char *funcname, PyObject *kw)
Georg Brandl02c42872005-08-26 06:42:30 +00001756{
1757 if (kw == NULL)
1758 return 1;
1759 if (!PyDict_CheckExact(kw)) {
1760 PyErr_BadInternalCall();
1761 return 0;
1762 }
1763 if (PyDict_Size(kw) == 0)
1764 return 1;
1765
1766 PyErr_Format(PyExc_TypeError, "%s does not take keyword arguments",
1767 funcname);
1768 return 0;
1769}
Anthony Baxter97300382006-04-12 04:38:54 +00001770#ifdef __cplusplus
1771};
1772#endif