blob: 6a50ef672ce1622d841569bdabb1a0cb60e5fe1f [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
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00009#ifdef __cplusplus
Guido van Rossum98297ee2007-11-06 21:34:58 +000010extern "C" {
Thomas Wouters49fd7fa2006-04-21 10:40:58 +000011#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
Thomas Wouters49fd7fa2006-04-21 10:40:58 +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 *);
Guido van Rossum98297ee2007-11-06 21:34:58 +000040static char *convertitem(PyObject *, const char **, va_list *, int, int *,
Martin v. Löwis18e16552006-02-15 17:27:45 +000041 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 Rossum98297ee2007-11-06 21:34:58 +000057
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000058 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;
Guido van Rossum98297ee2007-11-06 21:34:58 +000069
Martin v. Löwis18e16552006-02-15 17:27:45 +000070 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 Rossum98297ee2007-11-06 21:34:58 +000082
Guido van Rossumfe3f1a21994-09-29 09:42:55 +000083 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;
Guido van Rossum98297ee2007-11-06 21:34:58 +000094
Martin v. Löwis18e16552006-02-15 17:27:45 +000095 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 }
Christian Heimes836baa52008-02-26 08:18:30 +0000157 if (PyList_Append(*freelist, cobj)) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +0000158 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{
Christian Heimes836baa52008-02-26 08:18:30 +0000169 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++;
Thomas Wouters0e3f5912006-08-11 14:57:12 +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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000243
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000244 if (level != 0)
Guido van Rossum79f25d91997-04-29 20:08:16 +0000245 Py_FatalError(/* '(' */ "missing ')' in getargs format");
Guido van Rossum98297ee2007-11-06 21:34:58 +0000246
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000247 if (min < 0)
248 min = max;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000249
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000250 format = formatsave;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000251
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000252 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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000272 msg = convertitem(args, &format, p_va, flags, levels,
Martin v. Löwis18e16552006-02-15 17:27:45 +0000273 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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000285
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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000291
Jeremy Hylton0f8117f2001-05-18 20:57:38 +0000292 len = PyTuple_GET_SIZE(args);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000293
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000294 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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000311
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000312 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,
Guido van Rossum98297ee2007-11-06 21:34:58 +0000316 flags, levels, msgbuf,
Martin v. Löwis18e16552006-02-15 17:27:45 +0000317 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 Rossum98297ee2007-11-06 21:34:58 +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);
Thomas Wouters0e3f5912006-08-11 14:57:12 +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,
Guido van Rossum98297ee2007-11-06 21:34:58 +0000395 int *levels, char *msgbuf, size_t bufsize, int toplevel,
Martin v. Löwis18e16552006-02-15 17:27:45 +0000396 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;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000402
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000403 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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000420
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",
Guido van Rossum98297ee2007-11-06 21:34:58 +0000426 n,
Jeremy Hylton23ae9872001-11-28 20:29:22 +0000427 arg == Py_None ? "None" : arg->ob_type->tp_name);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000428 return msgbuf;
429 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000430
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);
Thomas Wouters0e3f5912006-08-11 14:57:12 +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 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000452 msg = convertitem(item, &format, p_va, flags, levels+1,
Martin v. Löwis18e16552006-02-15 17:27:45 +0000453 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 Rossum98297ee2007-11-06 21:34:58 +0000475
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000476 if (*format == '(' /* ')' */) {
477 format++;
Guido van Rossum98297ee2007-11-06 21:34:58 +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 {
Guido van Rossum98297ee2007-11-06 21:34:58 +0000484 msg = convertsimple(arg, &format, p_va, flags,
Martin v. Löwis18e16552006-02-15 17:27:45 +0000485 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);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000505 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
Guido van Rossum45aecf42006-03-15 04:58:47 +0000514/* Explicitly check for float arguments when integers are expected.
515 Return 1 for error, 0 if ok. */
Neil Schemenauer5042da62003-02-04 20:59:40 +0000516static int
517float_argument_error(PyObject *arg)
518{
Guido van Rossum45aecf42006-03-15 04:58:47 +0000519 if (PyFloat_Check(arg)) {
520 PyErr_SetString(PyExc_TypeError,
521 "integer argument expected, got float" );
Neil Schemenauer5042da62003-02-04 20:59:40 +0000522 return 1;
Guido van Rossum45aecf42006-03-15 04:58:47 +0000523 }
Neil Schemenauer5042da62003-02-04 20:59:40 +0000524 else
525 return 0;
526}
527
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000528/* Convert a non-tuple argument. Return NULL if conversion went OK,
529 or a string with a message describing the failure. The message is
530 formatted as "must be <desired type>, not <actual type>".
531 When failing, an exception may or may not have been raised.
Georg Brandl6dd14612005-09-14 19:29:53 +0000532 Don't call if a tuple is expected.
533
534 When you add new format codes, please don't forget poor skipitem() below.
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000535*/
536
537static char *
Martin v. Löwis18e16552006-02-15 17:27:45 +0000538convertsimple(PyObject *arg, const char **p_format, va_list *p_va, int flags,
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000539 char *msgbuf, size_t bufsize, PyObject **freelist)
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000540{
Martin v. Löwis18e16552006-02-15 17:27:45 +0000541 /* For # codes */
542#define FETCH_SIZE int *q=NULL;Py_ssize_t *q2=NULL;\
543 if (flags & FLAG_SIZE_T) q2=va_arg(*p_va, Py_ssize_t*); \
544 else q=va_arg(*p_va, int*);
545#define STORE_SIZE(s) if (flags & FLAG_SIZE_T) *q2=s; else *q=s;
546#define BUFFER_LEN ((flags & FLAG_SIZE_T) ? *q2:*q)
547
Jeremy Hyltonaf68c872005-12-10 18:50:16 +0000548 const char *format = *p_format;
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000549 char c = *format++;
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000550 PyObject *uarg;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000551
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000552 switch (c) {
Guido van Rossum98297ee2007-11-06 21:34:58 +0000553
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000554 case 'b': { /* unsigned byte -- very short int */
555 char *p = va_arg(*p_va, char *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000556 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000557 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000558 return converterr("integer<b>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000559 ival = PyLong_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000560 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000561 return converterr("integer<b>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000562 else if (ival < 0) {
563 PyErr_SetString(PyExc_OverflowError,
564 "unsigned byte integer is less than minimum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000565 return converterr("integer<b>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000566 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000567 else if (ival > UCHAR_MAX) {
568 PyErr_SetString(PyExc_OverflowError,
569 "unsigned byte integer is greater than maximum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000570 return converterr("integer<b>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000571 }
572 else
573 *p = (unsigned char) ival;
574 break;
575 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000576
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000577 case 'B': {/* byte sized bitfield - both signed and unsigned
Guido van Rossum98297ee2007-11-06 21:34:58 +0000578 values allowed */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000579 char *p = va_arg(*p_va, char *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000580 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000581 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000582 return converterr("integer<B>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000583 ival = PyLong_AsUnsignedLongMask(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000584 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000585 return converterr("integer<B>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000586 else
587 *p = (unsigned char) ival;
588 break;
589 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000590
Guido van Rossumfce26e72003-04-18 00:12:30 +0000591 case 'h': {/* signed short int */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000592 short *p = va_arg(*p_va, short *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000593 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000594 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000595 return converterr("integer<h>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000596 ival = PyLong_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000597 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000598 return converterr("integer<h>", arg, msgbuf, bufsize);
Guido van Rossumfce26e72003-04-18 00:12:30 +0000599 else if (ival < SHRT_MIN) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000600 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumfce26e72003-04-18 00:12:30 +0000601 "signed short integer is less than minimum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000602 return converterr("integer<h>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000603 }
Guido van Rossumfce26e72003-04-18 00:12:30 +0000604 else if (ival > SHRT_MAX) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000605 PyErr_SetString(PyExc_OverflowError,
Guido van Rossumfce26e72003-04-18 00:12:30 +0000606 "signed short integer is greater than maximum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000607 return converterr("integer<h>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000608 }
609 else
610 *p = (short) ival;
611 break;
612 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000613
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000614 case 'H': { /* short int sized bitfield, both signed and
Guido van Rossum98297ee2007-11-06 21:34:58 +0000615 unsigned allowed */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000616 unsigned short *p = va_arg(*p_va, unsigned short *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000617 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000618 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000619 return converterr("integer<H>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000620 ival = PyLong_AsUnsignedLongMask(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000621 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000622 return converterr("integer<H>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000623 else
624 *p = (unsigned short) ival;
625 break;
626 }
Martin v. Löwis18e16552006-02-15 17:27:45 +0000627
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000628 case 'i': {/* signed int */
629 int *p = va_arg(*p_va, int *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000630 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000631 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000632 return converterr("integer<i>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000633 ival = PyLong_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000634 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000635 return converterr("integer<i>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000636 else if (ival > INT_MAX) {
637 PyErr_SetString(PyExc_OverflowError,
638 "signed integer is greater than maximum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000639 return converterr("integer<i>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000640 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000641 else if (ival < INT_MIN) {
642 PyErr_SetString(PyExc_OverflowError,
643 "signed integer is less than minimum");
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000644 return converterr("integer<i>", arg, msgbuf, bufsize);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000645 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000646 else
647 *p = ival;
648 break;
649 }
650
Thomas Hellera4ea6032003-04-17 18:55:45 +0000651 case 'I': { /* int sized bitfield, both signed and
Guido van Rossum98297ee2007-11-06 21:34:58 +0000652 unsigned allowed */
Thomas Hellera4ea6032003-04-17 18:55:45 +0000653 unsigned int *p = va_arg(*p_va, unsigned int *);
654 unsigned int ival;
655 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000656 return converterr("integer<I>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000657 ival = (unsigned int)PyLong_AsUnsignedLongMask(arg);
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000658 if (ival == (unsigned int)-1 && PyErr_Occurred())
Thomas Hellera4ea6032003-04-17 18:55:45 +0000659 return converterr("integer<I>", arg, msgbuf, bufsize);
660 else
661 *p = ival;
662 break;
663 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000664
Martin v. Löwis18e16552006-02-15 17:27:45 +0000665 case 'n': /* Py_ssize_t */
Martin v. Löwis18e16552006-02-15 17:27:45 +0000666 {
Neal Norwitzb879f572007-08-31 05:20:36 +0000667 PyObject *iobj;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000668 Py_ssize_t *p = va_arg(*p_va, Py_ssize_t *);
Neal Norwitzb879f572007-08-31 05:20:36 +0000669 Py_ssize_t ival = -1;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000670 if (float_argument_error(arg))
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000671 return converterr("integer<n>", arg, msgbuf, bufsize);
Neal Norwitzb879f572007-08-31 05:20:36 +0000672 iobj = PyNumber_Index(arg);
673 if (iobj != NULL)
Trent Nelson35133582008-04-22 19:02:40 +0000674 ival = PyLong_AsSsize_t(iobj);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000675 if (ival == -1 && PyErr_Occurred())
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000676 return converterr("integer<n>", arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000677 *p = ival;
678 break;
679 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000680 case 'l': {/* long int */
681 long *p = va_arg(*p_va, long *);
Neil Schemenauerb808e992003-01-24 22:15:21 +0000682 long ival;
Neil Schemenauer5042da62003-02-04 20:59:40 +0000683 if (float_argument_error(arg))
Michael W. Hudson34553382004-08-07 17:57:16 +0000684 return converterr("integer<l>", arg, msgbuf, bufsize);
Christian Heimes217cfd12007-12-02 14:31:20 +0000685 ival = PyLong_AsLong(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000686 if (ival == -1 && PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000687 return converterr("integer<l>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000688 else
689 *p = ival;
690 break;
691 }
Thomas Hellera4ea6032003-04-17 18:55:45 +0000692
693 case 'k': { /* long sized bitfield */
694 unsigned long *p = va_arg(*p_va, unsigned long *);
695 unsigned long ival;
Georg Brandle1a0d112007-10-23 19:24:22 +0000696 if (PyLong_Check(arg))
Thomas Hellera4ea6032003-04-17 18:55:45 +0000697 ival = PyLong_AsUnsignedLongMask(arg);
698 else
699 return converterr("integer<k>", arg, msgbuf, bufsize);
700 *p = ival;
701 break;
702 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000703
Guido van Rossum3dbba6e1999-01-25 21:48:56 +0000704#ifdef HAVE_LONG_LONG
Martin v. Löwisb9a0f912003-03-29 10:06:18 +0000705 case 'L': {/* PY_LONG_LONG */
706 PY_LONG_LONG *p = va_arg( *p_va, PY_LONG_LONG * );
707 PY_LONG_LONG ival = PyLong_AsLongLong( arg );
Christian Heimes836baa52008-02-26 08:18:30 +0000708 if (ival == (PY_LONG_LONG)-1 && PyErr_Occurred() ) {
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000709 return converterr("long<L>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000710 } else {
711 *p = ival;
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000712 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000713 break;
714 }
Thomas Hellera4ea6032003-04-17 18:55:45 +0000715
716 case 'K': { /* long long sized bitfield */
717 unsigned PY_LONG_LONG *p = va_arg(*p_va, unsigned PY_LONG_LONG *);
718 unsigned PY_LONG_LONG ival;
Guido van Rossumddefaf32007-01-14 03:31:43 +0000719 if (PyLong_Check(arg))
Thomas Hellera4ea6032003-04-17 18:55:45 +0000720 ival = PyLong_AsUnsignedLongLongMask(arg);
721 else
722 return converterr("integer<K>", arg, msgbuf, bufsize);
723 *p = ival;
724 break;
725 }
Guido van Rossum1a8791e1998-08-04 22:46:29 +0000726#endif
Guido van Rossum98297ee2007-11-06 21:34:58 +0000727
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000728 case 'f': {/* float */
729 float *p = va_arg(*p_va, float *);
730 double dval = PyFloat_AsDouble(arg);
731 if (PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000732 return converterr("float<f>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000733 else
734 *p = (float) dval;
735 break;
736 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000737
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000738 case 'd': {/* double */
739 double *p = va_arg(*p_va, double *);
740 double dval = PyFloat_AsDouble(arg);
741 if (PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000742 return converterr("float<d>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000743 else
744 *p = dval;
745 break;
746 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000747
Guido van Rossum530956d1996-07-21 02:27:43 +0000748#ifndef WITHOUT_COMPLEX
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000749 case 'D': {/* complex double */
750 Py_complex *p = va_arg(*p_va, Py_complex *);
751 Py_complex cval;
752 cval = PyComplex_AsCComplex(arg);
753 if (PyErr_Occurred())
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000754 return converterr("complex<D>", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000755 else
756 *p = cval;
757 break;
758 }
Guido van Rossum530956d1996-07-21 02:27:43 +0000759#endif /* WITHOUT_COMPLEX */
Guido van Rossum98297ee2007-11-06 21:34:58 +0000760
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000761 case 'c': {/* char */
Walter Dörwaldd0941302007-07-01 21:58:22 +0000762 char *p = va_arg(*p_va, char *);
763 if (PyString_Check(arg) && PyString_Size(arg) == 1)
764 *p = PyString_AS_STRING(arg)[0];
765 else if (PyUnicode_Check(arg) &&
766 PyUnicode_GET_SIZE(arg) == 1 &&
767 PyUnicode_AS_UNICODE(arg)[0] < 256)
Amaury Forgeot d'Arc39599dc2007-11-22 02:48:12 +0000768 *p = (char)PyUnicode_AS_UNICODE(arg)[0];
Walter Dörwaldd0941302007-07-01 21:58:22 +0000769 else
770 return converterr("char < 256", arg, msgbuf, bufsize);
771 break;
772 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000773
Walter Dörwaldd0941302007-07-01 21:58:22 +0000774 case 'C': {/* unicode char */
Walter Dörwaldbc1f8862007-06-20 11:02:38 +0000775 int *p = va_arg(*p_va, int *);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000776 if (PyString_Check(arg) && PyString_Size(arg) == 1)
Jeremy Hylton0407aea2001-10-10 02:51:57 +0000777 *p = PyString_AS_STRING(arg)[0];
Guido van Rossum09dc34f2007-05-04 04:17:33 +0000778 else if (PyUnicode_Check(arg) &&
Walter Dörwaldbc1f8862007-06-20 11:02:38 +0000779 PyUnicode_GET_SIZE(arg) == 1)
Guido van Rossum09dc34f2007-05-04 04:17:33 +0000780 *p = PyUnicode_AS_UNICODE(arg)[0];
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000781 else
Walter Dörwaldbc1f8862007-06-20 11:02:38 +0000782 return converterr("char", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000783 break;
784 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000785
786 /* XXX WAAAAH! 's', 'y', 'z', 'u', 'Z', 'e', 'w', 't' codes all
787 need to be cleaned up! */
788
789 case 's': {/* text string */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000790 if (*format == '#') {
791 void **p = (void **)va_arg(*p_va, char **);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000792 FETCH_SIZE;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000793
794 if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000795 uarg = UNICODE_DEFAULT_ENCODING(arg);
796 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000797 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000798 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000799 *p = PyString_AS_STRING(uarg);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000800 STORE_SIZE(PyString_GET_SIZE(uarg));
Guido van Rossumfe3f1a21994-09-29 09:42:55 +0000801 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000802 else { /* any buffer-like object */
Guido van Rossum98297ee2007-11-06 21:34:58 +0000803 /* XXX Really? */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000804 char *buf;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000805 Py_ssize_t count = convertbuffer(arg, p, &buf);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000806 if (count < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000807 return converterr(buf, arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000808 STORE_SIZE(count);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000809 }
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000810 format++;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000811 } else {
812 char **p = va_arg(*p_va, char **);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000813
814 if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000815 uarg = UNICODE_DEFAULT_ENCODING(arg);
816 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000817 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000818 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000819 *p = PyString_AS_STRING(uarg);
Marc-André Lemburg6f15e572001-05-02 17:16:16 +0000820 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000821 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000822 return converterr("string", arg, msgbuf, bufsize);
Georg Brandl896c3172008-03-21 20:46:11 +0000823 /* XXX(gb): this test is completely wrong -- p is a
824 * byte string while arg is a Unicode. I *think* it should
825 * check against the size of uarg... */
Amaury Forgeot d'Arc39599dc2007-11-22 02:48:12 +0000826 if ((Py_ssize_t)strlen(*p) != PyUnicode_GetSize(arg))
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000827 return converterr("string without null bytes",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000828 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000829 }
830 break;
831 }
832
Guido van Rossum98297ee2007-11-06 21:34:58 +0000833 case 'y': {/* any buffer-like object, but not PyUnicode */
834 void **p = (void **)va_arg(*p_va, char **);
835 char *buf;
836 Py_ssize_t count = convertbuffer(arg, p, &buf);
837 if (count < 0)
838 return converterr(buf, arg, msgbuf, bufsize);
Walter Dörwald612344f2007-05-04 19:28:21 +0000839 if (*format == '#') {
Walter Dörwald612344f2007-05-04 19:28:21 +0000840 FETCH_SIZE;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000841 STORE_SIZE(count);
Walter Dörwald612344f2007-05-04 19:28:21 +0000842 format++;
Walter Dörwald612344f2007-05-04 19:28:21 +0000843 }
844 break;
845 }
846
Guido van Rossum98297ee2007-11-06 21:34:58 +0000847 case 'z': {/* like 's' or 's#', but None is okay, stored as NULL */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000848 if (*format == '#') { /* any buffer-like object */
849 void **p = (void **)va_arg(*p_va, char **);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000850 FETCH_SIZE;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000851
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000852 if (arg == Py_None) {
853 *p = 0;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000854 STORE_SIZE(0);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000855 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000856 else if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000857 uarg = UNICODE_DEFAULT_ENCODING(arg);
858 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000859 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000860 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000861 *p = PyString_AS_STRING(uarg);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000862 STORE_SIZE(PyString_GET_SIZE(uarg));
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000863 }
864 else { /* any buffer-like object */
Guido van Rossum98297ee2007-11-06 21:34:58 +0000865 /* XXX Really? */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000866 char *buf;
Martin v. Löwis18e16552006-02-15 17:27:45 +0000867 Py_ssize_t count = convertbuffer(arg, p, &buf);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000868 if (count < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000869 return converterr(buf, arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +0000870 STORE_SIZE(count);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000871 }
872 format++;
873 } else {
874 char **p = va_arg(*p_va, char **);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000875
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000876 if (arg == Py_None)
877 *p = 0;
878 else if (PyString_Check(arg))
Jeremy Hyltona4c8cd72001-10-10 02:51:08 +0000879 *p = PyString_AS_STRING(arg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000880 else if (PyUnicode_Check(arg)) {
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000881 uarg = UNICODE_DEFAULT_ENCODING(arg);
882 if (uarg == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000883 return converterr(CONV_UNICODE,
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000884 arg, msgbuf, bufsize);
Jeremy Hylton77b8b672001-09-10 01:54:43 +0000885 *p = PyString_AS_STRING(uarg);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000886 }
887 else
Guido van Rossum98297ee2007-11-06 21:34:58 +0000888 return converterr("string or None",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000889 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000890 if (*format == '#') {
Martin v. Löwis18e16552006-02-15 17:27:45 +0000891 FETCH_SIZE;
Thomas Woutersc3547a32006-03-01 21:31:21 +0000892 assert(0); /* XXX redundant with if-case */
Guido van Rossum98297ee2007-11-06 21:34:58 +0000893 if (arg == Py_None) {
894 STORE_SIZE(0);
895 }
896 else {
897 STORE_SIZE(PyString_Size(arg));
898 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000899 format++;
900 }
Georg Brandl896c3172008-03-21 20:46:11 +0000901 /* XXX(gb): same comment as for 's' applies here... */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000902 else if (*p != NULL &&
Amaury Forgeot d'Arc39599dc2007-11-22 02:48:12 +0000903 (Py_ssize_t)strlen(*p) != PyUnicode_GetSize(arg))
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000904 return converterr(
Guido van Rossum98297ee2007-11-06 21:34:58 +0000905 "string without null bytes or None",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000906 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000907 }
908 break;
909 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000910
Guido van Rossumfb67be22007-08-29 18:38:11 +0000911 case 'Z': {/* unicode, may be NULL (None) */
912 if (*format == '#') { /* any buffer-like object */
913 Py_UNICODE **p = va_arg(*p_va, Py_UNICODE **);
914 FETCH_SIZE;
Guido van Rossum98297ee2007-11-06 21:34:58 +0000915
Guido van Rossumfb67be22007-08-29 18:38:11 +0000916 if (arg == Py_None) {
917 *p = 0;
918 STORE_SIZE(0);
919 }
920 else if (PyUnicode_Check(arg)) {
921 *p = PyUnicode_AS_UNICODE(arg);
922 STORE_SIZE(PyUnicode_GET_SIZE(arg));
923 }
924 format++;
925 } else {
926 Py_UNICODE **p = va_arg(*p_va, Py_UNICODE **);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000927
Guido van Rossumfb67be22007-08-29 18:38:11 +0000928 if (arg == Py_None)
929 *p = 0;
930 else if (PyUnicode_Check(arg))
931 *p = PyUnicode_AS_UNICODE(arg);
932 else
Guido van Rossum98297ee2007-11-06 21:34:58 +0000933 return converterr("string or None",
Guido van Rossumfb67be22007-08-29 18:38:11 +0000934 arg, msgbuf, bufsize);
935 }
936 break;
937 }
Guido van Rossum98297ee2007-11-06 21:34:58 +0000938
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000939 case 'e': {/* encoded string */
940 char **buffer;
941 const char *encoding;
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000942 PyObject *s;
Guido van Rossumf15a29f2007-05-04 00:41:39 +0000943 int recode_strings;
944 Py_ssize_t size;
Guido van Rossumd70539a2007-05-09 23:35:09 +0000945 const char *ptr;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000946
947 /* Get 'e' parameter: the encoding name */
948 encoding = (const char *)va_arg(*p_va, const char *);
949 if (encoding == NULL)
950 encoding = PyUnicode_GetDefaultEncoding();
Guido van Rossum98297ee2007-11-06 21:34:58 +0000951
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000952 /* Get output buffer parameter:
953 's' (recode all objects via Unicode) or
Guido van Rossum98297ee2007-11-06 21:34:58 +0000954 't' (only recode non-string objects)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000955 */
956 if (*format == 's')
957 recode_strings = 1;
958 else if (*format == 't')
959 recode_strings = 0;
960 else
961 return converterr(
962 "(unknown parser marker combination)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000963 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000964 buffer = (char **)va_arg(*p_va, char **);
965 format++;
966 if (buffer == NULL)
Guido van Rossum98297ee2007-11-06 21:34:58 +0000967 return converterr("(buffer is NULL)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000968 arg, msgbuf, bufsize);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000969
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000970 /* Encode object */
Guido van Rossumd70539a2007-05-09 23:35:09 +0000971 if (!recode_strings &&
972 (PyString_Check(arg) || PyBytes_Check(arg))) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000973 s = arg;
974 Py_INCREF(s);
Guido van Rossumd70539a2007-05-09 23:35:09 +0000975 if (PyObject_AsCharBuffer(s, &ptr, &size) < 0)
976 return converterr("(AsCharBuffer failed)",
977 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000978 }
979 else {
Martin v. Löwis339d0f72001-08-17 18:39:25 +0000980 PyObject *u;
981
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000982 /* Convert object to Unicode */
983 u = PyUnicode_FromObject(arg);
984 if (u == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000985 return converterr(
Guido van Rossum98297ee2007-11-06 21:34:58 +0000986 "string or unicode or text buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000987 arg, msgbuf, bufsize);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000988
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000989 /* Encode object; use default error handling */
990 s = PyUnicode_AsEncodedString(u,
991 encoding,
992 NULL);
993 Py_DECREF(u);
994 if (s == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000995 return converterr("(encoding failed)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +0000996 arg, msgbuf, bufsize);
Guido van Rossum98297ee2007-11-06 21:34:58 +0000997 if (!PyString_Check(s)) {
Guido van Rossumd8855fd2000-03-24 22:14:19 +0000998 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +0000999 return converterr(
Guido van Rossumf15a29f2007-05-04 00:41:39 +00001000 "(encoder failed to return bytes)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001001 arg, msgbuf, bufsize);
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001002 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001003 size = PyString_GET_SIZE(s);
1004 ptr = PyString_AS_STRING(s);
Guido van Rossumd70539a2007-05-09 23:35:09 +00001005 if (ptr == NULL)
1006 ptr = "";
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001007 }
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001008
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001009 /* Write output; output is guaranteed to be 0-terminated */
Guido van Rossum98297ee2007-11-06 21:34:58 +00001010 if (*format == '#') {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001011 /* Using buffer length parameter '#':
Guido van Rossum98297ee2007-11-06 21:34:58 +00001012
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001013 - if *buffer is NULL, a new buffer of the
1014 needed size is allocated and the data
1015 copied into it; *buffer is updated to point
1016 to the new buffer; the caller is
1017 responsible for PyMem_Free()ing it after
Guido van Rossum98297ee2007-11-06 21:34:58 +00001018 usage
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001019
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001020 - if *buffer is not NULL, the data is
1021 copied to *buffer; *buffer_len has to be
1022 set to the size of the buffer on input;
1023 buffer overflow is signalled with an error;
1024 buffer has to provide enough room for the
1025 encoded string plus the trailing 0-byte
Guido van Rossum98297ee2007-11-06 21:34:58 +00001026
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001027 - in both cases, *buffer_len is updated to
1028 the size of the buffer /excluding/ the
Guido van Rossum98297ee2007-11-06 21:34:58 +00001029 trailing 0-byte
1030
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001031 */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001032 FETCH_SIZE;
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001033
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001034 format++;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001035 if (q == NULL && q2 == NULL) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001036 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001037 return converterr(
1038 "(buffer_len is NULL)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001039 arg, msgbuf, bufsize);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001040 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001041 if (*buffer == NULL) {
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001042 *buffer = PyMem_NEW(char, size + 1);
1043 if (*buffer == NULL) {
1044 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001045 return converterr(
1046 "(memory error)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001047 arg, msgbuf, bufsize);
Guido van Rossumd8855fd2000-03-24 22:14:19 +00001048 }
Christian Heimes836baa52008-02-26 08:18:30 +00001049 if (addcleanup(*buffer, freelist)) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001050 Py_DECREF(s);
1051 return converterr(
1052 "(cleanup problem)",
1053 arg, msgbuf, bufsize);
1054 }
Fred Drake25871c02000-05-03 15:17:02 +00001055 } else {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001056 if (size + 1 > BUFFER_LEN) {
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001057 Py_DECREF(s);
1058 return converterr(
Guido van Rossum98297ee2007-11-06 21:34:58 +00001059 "(buffer overflow)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001060 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001061 }
Fred Drake25871c02000-05-03 15:17:02 +00001062 }
Guido van Rossumf15a29f2007-05-04 00:41:39 +00001063 memcpy(*buffer, ptr, size+1);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001064 STORE_SIZE(size);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001065 } else {
1066 /* Using a 0-terminated buffer:
Guido van Rossum98297ee2007-11-06 21:34:58 +00001067
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001068 - the encoded string has to be 0-terminated
1069 for this variant to work; if it is not, an
Guido van Rossum98297ee2007-11-06 21:34:58 +00001070 error raised
Fred Drake25871c02000-05-03 15:17:02 +00001071
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001072 - a new buffer of the needed size is
1073 allocated and the data copied into it;
1074 *buffer is updated to point to the new
1075 buffer; the caller is responsible for
1076 PyMem_Free()ing it after usage
1077
1078 */
Guido van Rossumf15a29f2007-05-04 00:41:39 +00001079 if ((Py_ssize_t)strlen(ptr) != size) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001080 Py_DECREF(s);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001081 return converterr(
1082 "(encoded string without NULL bytes)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001083 arg, msgbuf, bufsize);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001084 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001085 *buffer = PyMem_NEW(char, size + 1);
1086 if (*buffer == NULL) {
1087 Py_DECREF(s);
1088 return converterr("(memory error)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001089 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001090 }
Christian Heimes836baa52008-02-26 08:18:30 +00001091 if (addcleanup(*buffer, freelist)) {
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001092 Py_DECREF(s);
1093 return converterr("(cleanup problem)",
1094 arg, msgbuf, bufsize);
1095 }
Guido van Rossumf15a29f2007-05-04 00:41:39 +00001096 memcpy(*buffer, ptr, size+1);
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001097 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001098 Py_DECREF(s);
1099 break;
1100 }
1101
1102 case 'u': {/* raw unicode buffer (Py_UNICODE *) */
Guido van Rossum98297ee2007-11-06 21:34:58 +00001103 Py_UNICODE **p = va_arg(*p_va, Py_UNICODE **);
1104 if (!PyUnicode_Check(arg))
1105 return converterr("str", arg, msgbuf, bufsize);
1106 *p = PyUnicode_AS_UNICODE(arg);
1107 if (*format == '#') { /* store pointer and size */
Martin v. Löwis18e16552006-02-15 17:27:45 +00001108 FETCH_SIZE;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001109 STORE_SIZE(PyUnicode_GET_SIZE(arg));
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001110 format++;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001111 }
1112 break;
1113 }
1114
Guido van Rossum98297ee2007-11-06 21:34:58 +00001115 case 'S': { /* PyString object */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001116 PyObject **p = va_arg(*p_va, PyObject **);
Guido van Rossum98297ee2007-11-06 21:34:58 +00001117 if (PyString_Check(arg))
Guido van Rossum617dbc42007-05-07 23:57:08 +00001118 *p = arg;
1119 else
1120 return converterr("bytes", arg, msgbuf, bufsize);
1121 break;
1122 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001123
1124 case 'Y': { /* PyBytes object */
1125 PyObject **p = va_arg(*p_va, PyObject **);
1126 if (PyBytes_Check(arg))
1127 *p = arg;
1128 else
1129 return converterr("buffer", arg, msgbuf, bufsize);
1130 break;
1131 }
1132
1133 case 'U': { /* PyUnicode object */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001134 PyObject **p = va_arg(*p_va, PyObject **);
1135 if (PyUnicode_Check(arg))
1136 *p = arg;
1137 else
Guido van Rossum98297ee2007-11-06 21:34:58 +00001138 return converterr("str", arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001139 break;
1140 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001141
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001142 case 'O': { /* object */
1143 PyTypeObject *type;
1144 PyObject **p;
1145 if (*format == '!') {
1146 type = va_arg(*p_va, PyTypeObject*);
1147 p = va_arg(*p_va, PyObject **);
1148 format++;
Guido van Rossumcbfc8552001-08-28 16:37:51 +00001149 if (PyType_IsSubtype(arg->ob_type, type))
Guido van Rossume826ef02000-03-10 23:02:17 +00001150 *p = arg;
1151 else
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001152 return converterr(type->tp_name, arg, msgbuf, bufsize);
Guido van Rossumfccfe891998-05-15 22:04:07 +00001153
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001154 }
1155 else if (*format == '?') {
1156 inquiry pred = va_arg(*p_va, inquiry);
1157 p = va_arg(*p_va, PyObject **);
1158 format++;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001159 if ((*pred)(arg))
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001160 *p = arg;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001161 else
Guido van Rossum98297ee2007-11-06 21:34:58 +00001162 return converterr("(unspecified)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001163 arg, msgbuf, bufsize);
Guido van Rossum98297ee2007-11-06 21:34:58 +00001164
Guido van Rossumfdf95dd1997-05-05 22:15:02 +00001165 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001166 else if (*format == '&') {
1167 typedef int (*converter)(PyObject *, void *);
1168 converter convert = va_arg(*p_va, converter);
1169 void *addr = va_arg(*p_va, void *);
1170 format++;
1171 if (! (*convert)(arg, addr))
Guido van Rossum98297ee2007-11-06 21:34:58 +00001172 return converterr("(unspecified)",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001173 arg, msgbuf, bufsize);
Guido van Rossumb317f8a1998-10-08 02:21:21 +00001174 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001175 else {
1176 p = va_arg(*p_va, PyObject **);
1177 *p = arg;
1178 }
1179 break;
1180 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001181
1182
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001183 case 'w': { /* memory buffer, read-write access */
1184 void **p = va_arg(*p_va, void **);
1185 PyBufferProcs *pb = arg->ob_type->tp_as_buffer;
Christian Heimes4e30a842007-11-30 22:12:06 +00001186 Py_ssize_t count;
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001187 int temp=-1;
Travis E. Oliphant8ae62b62007-09-23 02:00:13 +00001188 Py_buffer view;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001189
1190 if (pb == NULL ||
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001191 pb->bf_getbuffer == NULL ||
Guido van Rossum98297ee2007-11-06 21:34:58 +00001192 ((temp = (*pb->bf_getbuffer)(arg, &view,
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001193 PyBUF_SIMPLE)) != 0) ||
1194 view.readonly == 1) {
1195 if (temp==0 && pb->bf_releasebuffer != NULL) {
1196 (*pb->bf_releasebuffer)(arg, &view);
1197 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001198 return converterr("single-segment read-write buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001199 arg, msgbuf, bufsize);
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001200 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001201
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001202 if ((count = view.len) < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001203 return converterr("(unspecified)", arg, msgbuf, bufsize);
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001204 *p = view.buf;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001205 if (*format == '#') {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001206 FETCH_SIZE;
1207 STORE_SIZE(count);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001208 format++;
1209 }
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001210 if (pb->bf_releasebuffer != NULL)
1211 (*pb->bf_releasebuffer)(arg, &view);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001212 break;
1213 }
Travis E. Oliphantddacf962007-10-13 21:03:27 +00001214
1215 /*TEO: This can be eliminated --- here only for backward
1216 compatibility */
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001217 case 't': { /* 8-bit character buffer, read-only access */
Martin v. Löwis15e62742006-02-27 16:46:16 +00001218 char **p = va_arg(*p_va, char **);
Jeremy Hylton4819e972001-10-11 14:40:37 +00001219 PyBufferProcs *pb = arg->ob_type->tp_as_buffer;
Christian Heimes4e30a842007-11-30 22:12:06 +00001220 Py_ssize_t count;
Travis E. Oliphant8ae62b62007-09-23 02:00:13 +00001221 Py_buffer view;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001222
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001223 if (*format++ != '#')
1224 return converterr(
Guido van Rossum98297ee2007-11-06 21:34:58 +00001225 "invalid use of 't' format character",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001226 arg, msgbuf, bufsize);
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001227 if (pb == NULL || pb->bf_getbuffer == NULL)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001228 return converterr(
Alexandre Vassalotti70a23712007-10-14 02:05:51 +00001229 "bytes or read-only character buffer",
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001230 arg, msgbuf, bufsize);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001231
Guido van Rossum98297ee2007-11-06 21:34:58 +00001232 if ((*pb->bf_getbuffer)(arg, &view, PyBUF_SIMPLE) != 0)
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001233 return converterr("string or single-segment read-only buffer",
1234 arg, msgbuf, bufsize);
Jeremy Hylton4819e972001-10-11 14:40:37 +00001235
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001236 count = view.len;
1237 *p = view.buf;
1238 /* XXX : shouldn't really release buffer, but it should be O.K.
1239 */
Guido van Rossum98297ee2007-11-06 21:34:58 +00001240 if (pb->bf_releasebuffer != NULL)
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001241 (*pb->bf_releasebuffer)(arg, &view);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001242 if (count < 0)
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001243 return converterr("(unspecified)", arg, msgbuf, bufsize);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001244 {
1245 FETCH_SIZE;
1246 STORE_SIZE(count);
1247 }
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001248 break;
1249 }
1250
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001251 default:
Jeremy Hyltonb048b262001-11-28 22:14:37 +00001252 return converterr("impossible<bad format char>", arg, msgbuf, bufsize);
Guido van Rossum98297ee2007-11-06 21:34:58 +00001253
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001254 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001255
Guido van Rossumfe3f1a21994-09-29 09:42:55 +00001256 *p_format = format;
1257 return NULL;
1258}
Guido van Rossumaa354651996-08-19 19:32:04 +00001259
Martin v. Löwis18e16552006-02-15 17:27:45 +00001260static Py_ssize_t
Fred Drake563dfc22001-10-23 14:41:08 +00001261convertbuffer(PyObject *arg, void **p, char **errmsg)
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001262{
1263 PyBufferProcs *pb = arg->ob_type->tp_as_buffer;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001264 Py_ssize_t count;
Travis E. Oliphant8ae62b62007-09-23 02:00:13 +00001265 Py_buffer view;
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001266
1267 *errmsg = NULL;
1268 *p = NULL;
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001269 if (pb == NULL ||
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001270 pb->bf_getbuffer == NULL) {
Guido van Rossumb0834002007-11-21 21:53:51 +00001271 *errmsg = "bytes or read-only buffer";
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001272 return -1;
1273 }
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001274
1275 if ((*pb->bf_getbuffer)(arg, &view, PyBUF_SIMPLE) != 0) {
Guido van Rossumb0834002007-11-21 21:53:51 +00001276 *errmsg = "bytes or single-segment read-only buffer";
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001277 return -1;
1278 }
Travis E. Oliphantb99f7622007-08-18 11:21:56 +00001279 count = view.len;
1280 *p = view.buf;
1281 if (pb->bf_releasebuffer != NULL)
1282 (*pb->bf_releasebuffer)(arg, &view);
Jeremy Hylton1cb7aa32001-05-29 17:37:05 +00001283 return count;
1284}
Guido van Rossumaa354651996-08-19 19:32:04 +00001285
1286/* Support for keyword arguments donated by
1287 Geoff Philbrick <philbric@delphi.hks.com> */
1288
Tim Petersf8cd3e82001-10-27 04:26:57 +00001289/* Return false (0) for error, else true. */
Fred Drake563dfc22001-10-23 14:41:08 +00001290int
1291PyArg_ParseTupleAndKeywords(PyObject *args,
1292 PyObject *keywords,
Guido van Rossum98297ee2007-11-06 21:34:58 +00001293 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001294 char **kwlist, ...)
Guido van Rossumaa354651996-08-19 19:32:04 +00001295{
1296 int retval;
1297 va_list va;
Tim Peters45772cd2001-10-27 03:58:40 +00001298
1299 if ((args == NULL || !PyTuple_Check(args)) ||
1300 (keywords != NULL && !PyDict_Check(keywords)) ||
1301 format == NULL ||
1302 kwlist == NULL)
1303 {
1304 PyErr_BadInternalCall();
Tim Petersf8cd3e82001-10-27 04:26:57 +00001305 return 0;
Tim Peters45772cd2001-10-27 03:58:40 +00001306 }
1307
Guido van Rossumaa354651996-08-19 19:32:04 +00001308 va_start(va, kwlist);
Guido van Rossum98297ee2007-11-06 21:34:58 +00001309 retval = vgetargskeywords(args, keywords, format, kwlist, &va, 0);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001310 va_end(va);
1311 return retval;
1312}
1313
1314int
1315_PyArg_ParseTupleAndKeywords_SizeT(PyObject *args,
1316 PyObject *keywords,
Guido van Rossum98297ee2007-11-06 21:34:58 +00001317 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001318 char **kwlist, ...)
Martin v. Löwis18e16552006-02-15 17:27:45 +00001319{
1320 int retval;
1321 va_list va;
1322
1323 if ((args == NULL || !PyTuple_Check(args)) ||
1324 (keywords != NULL && !PyDict_Check(keywords)) ||
1325 format == NULL ||
1326 kwlist == NULL)
1327 {
1328 PyErr_BadInternalCall();
1329 return 0;
1330 }
1331
1332 va_start(va, kwlist);
Guido van Rossum98297ee2007-11-06 21:34:58 +00001333 retval = vgetargskeywords(args, keywords, format,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001334 kwlist, &va, FLAG_SIZE_T);
Guido van Rossumaa354651996-08-19 19:32:04 +00001335 va_end(va);
1336 return retval;
1337}
1338
1339
Brett Cannon711e7d92004-07-10 22:20:32 +00001340int
1341PyArg_VaParseTupleAndKeywords(PyObject *args,
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001342 PyObject *keywords,
Guido van Rossum98297ee2007-11-06 21:34:58 +00001343 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001344 char **kwlist, va_list va)
Brett Cannon711e7d92004-07-10 22:20:32 +00001345{
1346 int retval;
1347 va_list lva;
1348
1349 if ((args == NULL || !PyTuple_Check(args)) ||
1350 (keywords != NULL && !PyDict_Check(keywords)) ||
1351 format == NULL ||
1352 kwlist == NULL)
1353 {
1354 PyErr_BadInternalCall();
1355 return 0;
1356 }
1357
1358#ifdef VA_LIST_IS_ARRAY
1359 memcpy(lva, va, sizeof(va_list));
1360#else
1361#ifdef __va_copy
1362 __va_copy(lva, va);
1363#else
1364 lva = va;
1365#endif
1366#endif
1367
Guido van Rossum98297ee2007-11-06 21:34:58 +00001368 retval = vgetargskeywords(args, keywords, format, kwlist, &lva, 0);
Martin v. Löwis18e16552006-02-15 17:27:45 +00001369 return retval;
1370}
1371
1372int
1373_PyArg_VaParseTupleAndKeywords_SizeT(PyObject *args,
1374 PyObject *keywords,
Guido van Rossum98297ee2007-11-06 21:34:58 +00001375 const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001376 char **kwlist, va_list va)
Martin v. Löwis18e16552006-02-15 17:27:45 +00001377{
1378 int retval;
1379 va_list lva;
1380
1381 if ((args == NULL || !PyTuple_Check(args)) ||
1382 (keywords != NULL && !PyDict_Check(keywords)) ||
1383 format == NULL ||
1384 kwlist == NULL)
1385 {
1386 PyErr_BadInternalCall();
1387 return 0;
1388 }
1389
1390#ifdef VA_LIST_IS_ARRAY
1391 memcpy(lva, va, sizeof(va_list));
1392#else
1393#ifdef __va_copy
1394 __va_copy(lva, va);
1395#else
1396 lva = va;
1397#endif
1398#endif
1399
Guido van Rossum98297ee2007-11-06 21:34:58 +00001400 retval = vgetargskeywords(args, keywords, format,
Martin v. Löwis18e16552006-02-15 17:27:45 +00001401 kwlist, &lva, FLAG_SIZE_T);
Brett Cannon711e7d92004-07-10 22:20:32 +00001402 return retval;
1403}
1404
Christian Heimes380f7f22008-02-28 11:19:05 +00001405#define IS_END_OF_FORMAT(c) (c == '\0' || c == ';' || c == ':')
Brett Cannon711e7d92004-07-10 22:20:32 +00001406
Guido van Rossumaa354651996-08-19 19:32:04 +00001407static int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001408vgetargskeywords(PyObject *args, PyObject *keywords, const char *format,
Martin v. Löwis15e62742006-02-27 16:46:16 +00001409 char **kwlist, va_list *p_va, int flags)
Guido van Rossumaa354651996-08-19 19:32:04 +00001410{
Tim Petersdc5eff92001-10-27 06:53:00 +00001411 char msgbuf[512];
Guido van Rossumaa354651996-08-19 19:32:04 +00001412 int levels[32];
Christian Heimes380f7f22008-02-28 11:19:05 +00001413 const char *fname, *msg, *custom_msg, *keyword;
1414 int min = INT_MAX;
Tim Petersb639d492001-10-27 07:00:56 +00001415 int i, len, nargs, nkeywords;
Christian Heimes380f7f22008-02-28 11:19:05 +00001416 PyObject *freelist = NULL, *current_arg;
Tim Petersf4331c12001-10-27 00:17:34 +00001417
Tim Peters45772cd2001-10-27 03:58:40 +00001418 assert(args != NULL && PyTuple_Check(args));
1419 assert(keywords == NULL || PyDict_Check(keywords));
1420 assert(format != NULL);
1421 assert(kwlist != NULL);
1422 assert(p_va != NULL);
1423
Christian Heimes380f7f22008-02-28 11:19:05 +00001424 /* grab the function name or custom error msg first (mutually exclusive) */
1425 fname = strchr(format, ':');
1426 if (fname) {
1427 fname++;
1428 custom_msg = NULL;
Tim Peters62d48e12001-10-27 06:42:16 +00001429 }
Christian Heimes380f7f22008-02-28 11:19:05 +00001430 else {
1431 custom_msg = strchr(format,';');
1432 if (custom_msg)
1433 custom_msg++;
Tim Peters62d48e12001-10-27 06:42:16 +00001434 }
Christian Heimes380f7f22008-02-28 11:19:05 +00001435
1436 /* scan kwlist and get greatest possible nbr of args */
1437 for (len=0; kwlist[len]; len++)
1438 continue;
Tim Petersf8cd3e82001-10-27 04:26:57 +00001439
Tim Peters6fb26352001-10-27 04:38:11 +00001440 nargs = PyTuple_GET_SIZE(args);
Christian Heimes380f7f22008-02-28 11:19:05 +00001441 nkeywords = (keywords == NULL) ? 0 : PyDict_Size(keywords);
1442 if (nargs + nkeywords > len) {
1443 PyErr_Format(PyExc_TypeError, "%s%s takes at most %d "
1444 "argument%s (%d given)",
1445 (fname == NULL) ? "function" : fname,
1446 (fname == NULL) ? "" : "()",
1447 len,
1448 (len == 1) ? "" : "s",
1449 nargs + nkeywords);
Guido van Rossumaa354651996-08-19 19:32:04 +00001450 return 0;
1451 }
Tim Petersc2f01122001-10-27 07:25:06 +00001452
Christian Heimes380f7f22008-02-28 11:19:05 +00001453 /* convert tuple args and keyword args in same loop, using kwlist to drive process */
1454 for (i = 0; i < len; i++) {
1455 keyword = kwlist[i];
1456 if (*format == '|') {
1457 min = i;
Guido van Rossumaa354651996-08-19 19:32:04 +00001458 format++;
Christian Heimes380f7f22008-02-28 11:19:05 +00001459 }
1460 if (IS_END_OF_FORMAT(*format)) {
1461 PyErr_Format(PyExc_RuntimeError,
1462 "More keyword list entries (%d) than "
1463 "format specifiers (%d)", len, i);
1464 return cleanreturn(0, freelist);
1465 }
1466 current_arg = NULL;
1467 if (nkeywords) {
1468 current_arg = PyDict_GetItemString(keywords, keyword);
1469 }
1470 if (current_arg) {
1471 --nkeywords;
1472 if (i < nargs) {
1473 /* arg present in tuple and in dict */
1474 PyErr_Format(PyExc_TypeError,
1475 "Argument given by name ('%s') "
1476 "and position (%d)",
1477 keyword, i+1);
1478 return cleanreturn(0, freelist);
1479 }
1480 }
1481 else if (nkeywords && PyErr_Occurred())
1482 return cleanreturn(0, freelist);
1483 else if (i < nargs)
1484 current_arg = PyTuple_GET_ITEM(args, i);
1485
1486 if (current_arg) {
1487 msg = convertitem(current_arg, &format, p_va, flags,
1488 levels, msgbuf, sizeof(msgbuf), &freelist);
1489 if (msg) {
1490 seterror(i+1, msg, levels, fname, custom_msg);
1491 return cleanreturn(0, freelist);
1492 }
1493 continue;
1494 }
1495
1496 if (i < min) {
1497 PyErr_Format(PyExc_TypeError, "Required argument "
1498 "'%s' (pos %d) not found",
1499 keyword, i+1);
1500 return cleanreturn(0, freelist);
1501 }
1502 /* current code reports success when all required args
1503 * fulfilled and no keyword args left, with no further
1504 * validation. XXX Maybe skip this in debug build ?
1505 */
1506 if (!nkeywords)
1507 return cleanreturn(1, freelist);
1508
1509 /* We are into optional args, skip thru to any remaining
1510 * keyword args */
1511 msg = skipitem(&format, p_va, flags);
Guido van Rossumaa354651996-08-19 19:32:04 +00001512 if (msg) {
Christian Heimes380f7f22008-02-28 11:19:05 +00001513 PyErr_Format(PyExc_RuntimeError, "%s: '%s'", msg,
1514 format);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001515 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001516 }
1517 }
1518
Christian Heimes380f7f22008-02-28 11:19:05 +00001519 if (!IS_END_OF_FORMAT(*format)) {
1520 PyErr_Format(PyExc_RuntimeError,
1521 "more argument specifiers than keyword list entries "
1522 "(remaining format:'%s')", format);
1523 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001524 }
Tim Petersb054be42001-10-27 05:07:41 +00001525
Guido van Rossumaa354651996-08-19 19:32:04 +00001526 /* make sure there are no extraneous keyword arguments */
Tim Petersc2f01122001-10-27 07:25:06 +00001527 if (nkeywords > 0) {
1528 PyObject *key, *value;
Martin v. Löwis18e16552006-02-15 17:27:45 +00001529 Py_ssize_t pos = 0;
Guido van Rossumaa354651996-08-19 19:32:04 +00001530 while (PyDict_Next(keywords, &pos, &key, &value)) {
Tim Petersc2f01122001-10-27 07:25:06 +00001531 int match = 0;
Guido van Rossum55474762002-04-04 16:22:30 +00001532 char *ks;
Guido van Rossum572dbf82007-04-27 23:53:51 +00001533 if (!PyString_Check(key) && !PyUnicode_Check(key)) {
Guido van Rossum98297ee2007-11-06 21:34:58 +00001534 PyErr_SetString(PyExc_TypeError,
Guido van Rossum55474762002-04-04 16:22:30 +00001535 "keywords must be strings");
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001536 return cleanreturn(0, freelist);
Guido van Rossum55474762002-04-04 16:22:30 +00001537 }
Amaury Forgeot d'Arc39599dc2007-11-22 02:48:12 +00001538 ks = PyUnicode_AsString(key);
Christian Heimes380f7f22008-02-28 11:19:05 +00001539 for (i = 0; i < len; i++) {
Guido van Rossumaa354651996-08-19 19:32:04 +00001540 if (!strcmp(ks, kwlist[i])) {
1541 match = 1;
1542 break;
1543 }
1544 }
1545 if (!match) {
Tim Petersc2f01122001-10-27 07:25:06 +00001546 PyErr_Format(PyExc_TypeError,
1547 "'%s' is an invalid keyword "
1548 "argument for this function",
1549 ks);
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001550 return cleanreturn(0, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001551 }
1552 }
1553 }
Tim Petersc2f01122001-10-27 07:25:06 +00001554
Martin v. Löwise6bbb4d2003-05-03 10:00:22 +00001555 return cleanreturn(1, freelist);
Guido van Rossumaa354651996-08-19 19:32:04 +00001556}
1557
1558
1559static char *
Martin v. Löwis18e16552006-02-15 17:27:45 +00001560skipitem(const char **p_format, va_list *p_va, int flags)
Guido van Rossumaa354651996-08-19 19:32:04 +00001561{
Christian Heimes380f7f22008-02-28 11:19:05 +00001562 const char *format = *p_format;
Guido van Rossumaa354651996-08-19 19:32:04 +00001563 char c = *format++;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001564
Guido van Rossumaa354651996-08-19 19:32:04 +00001565 switch (c) {
Georg Brandl6dd14612005-09-14 19:29:53 +00001566
1567 /* simple codes
1568 * The individual types (second arg of va_arg) are irrelevant */
1569
Guido van Rossumaa354651996-08-19 19:32:04 +00001570 case 'b': /* byte -- very short int */
Jack Jansencc22fbe2000-08-05 21:29:58 +00001571 case 'B': /* byte as bitfield */
Guido van Rossumaa354651996-08-19 19:32:04 +00001572 case 'h': /* short int */
Jack Jansencc22fbe2000-08-05 21:29:58 +00001573 case 'H': /* short int as bitfield */
Guido van Rossumaa354651996-08-19 19:32:04 +00001574 case 'i': /* int */
Georg Brandl6dd14612005-09-14 19:29:53 +00001575 case 'I': /* int sized bitfield */
Guido van Rossumaa354651996-08-19 19:32:04 +00001576 case 'l': /* long int */
Georg Brandl6dd14612005-09-14 19:29:53 +00001577 case 'k': /* long int sized bitfield */
Guido van Rossum3dbba6e1999-01-25 21:48:56 +00001578#ifdef HAVE_LONG_LONG
Georg Brandl6dd14612005-09-14 19:29:53 +00001579 case 'L': /* PY_LONG_LONG */
1580 case 'K': /* PY_LONG_LONG sized bitfield */
Guido van Rossum1a8791e1998-08-04 22:46:29 +00001581#endif
Guido van Rossumaa354651996-08-19 19:32:04 +00001582 case 'f': /* float */
Guido van Rossumaa354651996-08-19 19:32:04 +00001583 case 'd': /* double */
Guido van Rossumaa354651996-08-19 19:32:04 +00001584#ifndef WITHOUT_COMPLEX
1585 case 'D': /* complex double */
Georg Brandl6dd14612005-09-14 19:29:53 +00001586#endif
Guido van Rossumaa354651996-08-19 19:32:04 +00001587 case 'c': /* char */
1588 {
Georg Brandl6dd14612005-09-14 19:29:53 +00001589 (void) va_arg(*p_va, void *);
Guido van Rossumaa354651996-08-19 19:32:04 +00001590 break;
1591 }
Martin v. Löwis18e16552006-02-15 17:27:45 +00001592
1593 case 'n': /* Py_ssize_t */
1594 {
1595 (void) va_arg(*p_va, Py_ssize_t *);
1596 break;
1597 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001598
Georg Brandl6dd14612005-09-14 19:29:53 +00001599 /* string codes */
Guido van Rossum98297ee2007-11-06 21:34:58 +00001600
Georg Brandl6dd14612005-09-14 19:29:53 +00001601 case 'e': /* string with encoding */
1602 {
1603 (void) va_arg(*p_va, const char *);
1604 if (!(*format == 's' || *format == 't'))
1605 /* after 'e', only 's' and 't' is allowed */
1606 goto err;
1607 format++;
1608 /* explicit fallthrough to string cases */
1609 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001610
Guido van Rossumaa354651996-08-19 19:32:04 +00001611 case 's': /* string */
Georg Brandl6dd14612005-09-14 19:29:53 +00001612 case 'z': /* string or None */
Walter Dörwald612344f2007-05-04 19:28:21 +00001613 case 'y': /* bytes */
Georg Brandl6dd14612005-09-14 19:29:53 +00001614 case 'u': /* unicode string */
Georg Brandl6dd14612005-09-14 19:29:53 +00001615 case 't': /* buffer, read-only */
1616 case 'w': /* buffer, read-write */
Guido van Rossumaa354651996-08-19 19:32:04 +00001617 {
Guido van Rossum80bb9651996-12-05 23:27:02 +00001618 (void) va_arg(*p_va, char **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001619 if (*format == '#') {
Martin v. Löwis18e16552006-02-15 17:27:45 +00001620 if (flags & FLAG_SIZE_T)
1621 (void) va_arg(*p_va, Py_ssize_t *);
1622 else
1623 (void) va_arg(*p_va, int *);
Guido van Rossumaa354651996-08-19 19:32:04 +00001624 format++;
1625 }
1626 break;
1627 }
Georg Brandl6dd14612005-09-14 19:29:53 +00001628
1629 /* object codes */
1630
Guido van Rossumaa354651996-08-19 19:32:04 +00001631 case 'S': /* string object */
Guido van Rossum617dbc42007-05-07 23:57:08 +00001632 case 'Y': /* string object */
Georg Brandl6dd14612005-09-14 19:29:53 +00001633 case 'U': /* unicode string object */
Guido van Rossumaa354651996-08-19 19:32:04 +00001634 {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001635 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001636 break;
1637 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001638
Guido van Rossumaa354651996-08-19 19:32:04 +00001639 case 'O': /* object */
1640 {
Guido van Rossumaa354651996-08-19 19:32:04 +00001641 if (*format == '!') {
1642 format++;
Guido van Rossum79f25d91997-04-29 20:08:16 +00001643 (void) va_arg(*p_va, PyTypeObject*);
1644 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001645 }
1646#if 0
1647/* I don't know what this is for */
1648 else if (*format == '?') {
1649 inquiry pred = va_arg(*p_va, inquiry);
1650 format++;
1651 if ((*pred)(arg)) {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001652 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001653 }
1654 }
1655#endif
1656 else if (*format == '&') {
Tim Petersdbd9ba62000-07-09 03:09:57 +00001657 typedef int (*converter)(PyObject *, void *);
Guido van Rossum80bb9651996-12-05 23:27:02 +00001658 (void) va_arg(*p_va, converter);
1659 (void) va_arg(*p_va, void *);
Guido van Rossumaa354651996-08-19 19:32:04 +00001660 format++;
1661 }
1662 else {
Guido van Rossum79f25d91997-04-29 20:08:16 +00001663 (void) va_arg(*p_va, PyObject **);
Guido van Rossumaa354651996-08-19 19:32:04 +00001664 }
1665 break;
1666 }
Guido van Rossum98297ee2007-11-06 21:34:58 +00001667
Christian Heimes380f7f22008-02-28 11:19:05 +00001668 case '(': /* bypass tuple, not handled at all previously */
1669 {
1670 char *msg;
1671 for (;;) {
1672 if (*format==')')
1673 break;
1674 if (IS_END_OF_FORMAT(*format))
1675 return "Unmatched left paren in format "
1676 "string";
1677 msg = skipitem(&format, p_va, flags);
1678 if (msg)
1679 return msg;
1680 }
1681 format++;
1682 break;
1683 }
1684
1685 case ')':
1686 return "Unmatched right paren in format string";
1687
Guido van Rossumaa354651996-08-19 19:32:04 +00001688 default:
Georg Brandl6dd14612005-09-14 19:29:53 +00001689err:
Guido van Rossumaa354651996-08-19 19:32:04 +00001690 return "impossible<bad format char>";
Guido van Rossum98297ee2007-11-06 21:34:58 +00001691
Guido van Rossumaa354651996-08-19 19:32:04 +00001692 }
Georg Brandl6dd14612005-09-14 19:29:53 +00001693
Guido van Rossumaa354651996-08-19 19:32:04 +00001694 *p_format = format;
1695 return NULL;
1696}
Fred Drakee4616e62001-10-23 21:09:29 +00001697
1698
1699int
Martin v. Löwis76246742006-03-01 04:06:10 +00001700PyArg_UnpackTuple(PyObject *args, const char *name, Py_ssize_t min, Py_ssize_t max, ...)
Fred Drakee4616e62001-10-23 21:09:29 +00001701{
Martin v. Löwis76246742006-03-01 04:06:10 +00001702 Py_ssize_t i, l;
Fred Drakee4616e62001-10-23 21:09:29 +00001703 PyObject **o;
1704 va_list vargs;
1705
1706#ifdef HAVE_STDARG_PROTOTYPES
1707 va_start(vargs, max);
1708#else
1709 va_start(vargs);
1710#endif
1711
1712 assert(min >= 0);
1713 assert(min <= max);
1714 if (!PyTuple_Check(args)) {
1715 PyErr_SetString(PyExc_SystemError,
1716 "PyArg_UnpackTuple() argument list is not a tuple");
1717 return 0;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001718 }
Fred Drakee4616e62001-10-23 21:09:29 +00001719 l = PyTuple_GET_SIZE(args);
1720 if (l < min) {
1721 if (name != NULL)
1722 PyErr_Format(
1723 PyExc_TypeError,
Guido van Rossum98297ee2007-11-06 21:34:58 +00001724 "%s expected %s%zd arguments, got %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001725 name, (min == max ? "" : "at least "), min, l);
1726 else
1727 PyErr_Format(
1728 PyExc_TypeError,
Thomas Wouters572a9f32006-03-01 05:38:39 +00001729 "unpacked tuple should have %s%zd elements,"
Guido van Rossum98297ee2007-11-06 21:34:58 +00001730 " but has %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001731 (min == max ? "" : "at least "), min, l);
1732 va_end(vargs);
1733 return 0;
1734 }
1735 if (l > max) {
1736 if (name != NULL)
1737 PyErr_Format(
1738 PyExc_TypeError,
Guido van Rossum98297ee2007-11-06 21:34:58 +00001739 "%s expected %s%zd arguments, got %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001740 name, (min == max ? "" : "at most "), max, l);
1741 else
1742 PyErr_Format(
1743 PyExc_TypeError,
Thomas Wouters572a9f32006-03-01 05:38:39 +00001744 "unpacked tuple should have %s%zd elements,"
Guido van Rossum98297ee2007-11-06 21:34:58 +00001745 " but has %zd",
Fred Drakee4616e62001-10-23 21:09:29 +00001746 (min == max ? "" : "at most "), max, l);
1747 va_end(vargs);
1748 return 0;
1749 }
1750 for (i = 0; i < l; i++) {
1751 o = va_arg(vargs, PyObject **);
1752 *o = PyTuple_GET_ITEM(args, i);
1753 }
1754 va_end(vargs);
1755 return 1;
1756}
Georg Brandl02c42872005-08-26 06:42:30 +00001757
1758
1759/* For type constructors that don't take keyword args
1760 *
Guido van Rossum98297ee2007-11-06 21:34:58 +00001761 * Sets a TypeError and returns 0 if the kwds dict is
Thomas Wouters89f507f2006-12-13 04:49:30 +00001762 * not empty, returns 1 otherwise
Georg Brandl02c42872005-08-26 06:42:30 +00001763 */
1764int
Jeremy Hyltonaf68c872005-12-10 18:50:16 +00001765_PyArg_NoKeywords(const char *funcname, PyObject *kw)
Georg Brandl02c42872005-08-26 06:42:30 +00001766{
1767 if (kw == NULL)
1768 return 1;
1769 if (!PyDict_CheckExact(kw)) {
1770 PyErr_BadInternalCall();
1771 return 0;
1772 }
1773 if (PyDict_Size(kw) == 0)
1774 return 1;
Guido van Rossum98297ee2007-11-06 21:34:58 +00001775
1776 PyErr_Format(PyExc_TypeError, "%s does not take keyword arguments",
Georg Brandl02c42872005-08-26 06:42:30 +00001777 funcname);
1778 return 0;
1779}
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001780#ifdef __cplusplus
1781};
1782#endif