Debian Codegraph @

Objects/clinic/dictobject.c.h

raw
1 /*[clinic input]
2 preserve
3 [clinic start generated code]*/
4
5 #include "pycore_critical_section.h"// Py_BEGIN_CRITICAL_SECTION()
6 #include "pycore_modsupport.h" // _PyArg_CheckPositional()
7
8 PyDoc_STRVAR(dict_fromkeys__doc__,
9 "fromkeys($type, iterable, value=None, /)\n"
10 "--\n"
11 "\n"
12 "Create a new dictionary with keys from iterable and values set to value.");
13
14 #define DICT_FROMKEYS_METHODDEF \
15 {"fromkeys", _PyCFunction_CAST(dict_fromkeys), METH_FASTCALL|METH_CLASS, dict_fromkeys__doc__},
16
17 static PyObject *
18 dict_fromkeys_impl(PyTypeObject *type, PyObject *iterable, PyObject *value);
19
20 static PyObject *
21 dict_fromkeys(PyObject *type, PyObject *const *args, Py_ssize_t nargs)
22 {
23 PyObject *return_value = NULL;
24 PyObject *iterable;
25 PyObject *value = Py_None;
26
27 if (!_PyArg_CheckPositional("fromkeys", nargs, 1, 2)) {
28 goto exit;
29 }
30 iterable = args[0];
31 if (nargs < 2) {
32 goto skip_optional;
33 }
34 value = args[1];
35 skip_optional:
36 return_value = dict_fromkeys_impl((PyTypeObject *)type, iterable, value);
37
38 exit:
39 return return_value;
40 }
41
42 PyDoc_STRVAR(dict_copy__doc__,
43 "copy($self, /)\n"
44 "--\n"
45 "\n"
46 "Return a shallow copy of the dict.");
47
48 #define DICT_COPY_METHODDEF \
49 {"copy", (PyCFunction)dict_copy, METH_NOARGS, dict_copy__doc__},
50
51 static PyObject *
52 dict_copy_impl(PyDictObject *self);
53
54 static PyObject *
55 dict_copy(PyObject *self, PyObject *Py_UNUSED(ignored))
56 {
57 return dict_copy_impl((PyDictObject *)self);
58 }
59
60 PyDoc_STRVAR(dict___contains____doc__,
61 "__contains__($self, key, /)\n"
62 "--\n"
63 "\n"
64 "True if the dictionary has the specified key, else False.");
65
66 #define DICT___CONTAINS___METHODDEF \
67 {"__contains__", (PyCFunction)dict___contains__, METH_O|METH_COEXIST, dict___contains____doc__},
68
69 static PyObject *
70 dict___contains___impl(PyDictObject *self, PyObject *key);
71
72 static PyObject *
73 dict___contains__(PyObject *self, PyObject *key)
74 {
75 PyObject *return_value = NULL;
76
77 return_value = dict___contains___impl((PyDictObject *)self, key);
78
79 return return_value;
80 }
81
82 PyDoc_STRVAR(dict_get__doc__,
83 "get($self, key, default=None, /)\n"
84 "--\n"
85 "\n"
86 "Return the value for key if key is in the dictionary, else default.");
87
88 #define DICT_GET_METHODDEF \
89 {"get", _PyCFunction_CAST(dict_get), METH_FASTCALL, dict_get__doc__},
90
91 static PyObject *
92 dict_get_impl(PyDictObject *self, PyObject *key, PyObject *default_value);
93
94 static PyObject *
95 dict_get(PyObject *self, PyObject *const *args, Py_ssize_t nargs)
96 {
97 PyObject *return_value = NULL;
98 PyObject *key;
99 PyObject *default_value = Py_None;
100
101 if (!_PyArg_CheckPositional("get", nargs, 1, 2)) {
102 goto exit;
103 }
104 key = args[0];
105 if (nargs < 2) {
106 goto skip_optional;
107 }
108 default_value = args[1];
109 skip_optional:
110 return_value = dict_get_impl((PyDictObject *)self, key, default_value);
111
112 exit:
113 return return_value;
114 }
115
116 PyDoc_STRVAR(dict_setdefault__doc__,
117 "setdefault($self, key, default=None, /)\n"
118 "--\n"
119 "\n"
120 "Insert key with a value of default if key is not in the dictionary.\n"
121 "\n"
122 "Return the value for key if key is in the dictionary, else default.");
123
124 #define DICT_SETDEFAULT_METHODDEF \
125 {"setdefault", _PyCFunction_CAST(dict_setdefault), METH_FASTCALL, dict_setdefault__doc__},
126
127 static PyObject *
128 dict_setdefault_impl(PyDictObject *self, PyObject *key,
129 PyObject *default_value);
130
131 static PyObject *
132 dict_setdefault(PyObject *self, PyObject *const *args, Py_ssize_t nargs)
133 {
134 PyObject *return_value = NULL;
135 PyObject *key;
136 PyObject *default_value = Py_None;
137
138 if (!_PyArg_CheckPositional("setdefault", nargs, 1, 2)) {
139 goto exit;
140 }
141 key = args[0];
142 if (nargs < 2) {
143 goto skip_optional;
144 }
145 default_value = args[1];
146 skip_optional:
147 Py_BEGIN_CRITICAL_SECTION(self);
148 return_value = dict_setdefault_impl((PyDictObject *)self, key, default_value);
149 Py_END_CRITICAL_SECTION();
150
151 exit:
152 return return_value;
153 }
154
155 PyDoc_STRVAR(dict_clear__doc__,
156 "clear($self, /)\n"
157 "--\n"
158 "\n"
159 "Remove all items from the dict.");
160
161 #define DICT_CLEAR_METHODDEF \
162 {"clear", (PyCFunction)dict_clear, METH_NOARGS, dict_clear__doc__},
163
164 static PyObject *
165 dict_clear_impl(PyDictObject *self);
166
167 static PyObject *
168 dict_clear(PyObject *self, PyObject *Py_UNUSED(ignored))
169 {
170 return dict_clear_impl((PyDictObject *)self);
171 }
172
173 PyDoc_STRVAR(dict_pop__doc__,
174 "pop($self, key, default=<unrepresentable>, /)\n"
175 "--\n"
176 "\n"
177 "D.pop(k[,d]) -> v, remove specified key and return the corresponding value.\n"
178 "\n"
179 "If the key is not found, return the default if given; otherwise,\n"
180 "raise a KeyError.");
181
182 #define DICT_POP_METHODDEF \
183 {"pop", _PyCFunction_CAST(dict_pop), METH_FASTCALL, dict_pop__doc__},
184
185 static PyObject *
186 dict_pop_impl(PyDictObject *self, PyObject *key, PyObject *default_value);
187
188 static PyObject *
189 dict_pop(PyObject *self, PyObject *const *args, Py_ssize_t nargs)
190 {
191 PyObject *return_value = NULL;
192 PyObject *key;
193 PyObject *default_value = NULL;
194
195 if (!_PyArg_CheckPositional("pop", nargs, 1, 2)) {
196 goto exit;
197 }
198 key = args[0];
199 if (nargs < 2) {
200 goto skip_optional;
201 }
202 default_value = args[1];
203 skip_optional:
204 return_value = dict_pop_impl((PyDictObject *)self, key, default_value);
205
206 exit:
207 return return_value;
208 }
209
210 PyDoc_STRVAR(dict_popitem__doc__,
211 "popitem($self, /)\n"
212 "--\n"
213 "\n"
214 "Remove and return a (key, value) pair as a 2-tuple.\n"
215 "\n"
216 "Pairs are returned in LIFO (last-in, first-out) order.\n"
217 "Raises KeyError if the dict is empty.");
218
219 #define DICT_POPITEM_METHODDEF \
220 {"popitem", (PyCFunction)dict_popitem, METH_NOARGS, dict_popitem__doc__},
221
222 static PyObject *
223 dict_popitem_impl(PyDictObject *self);
224
225 static PyObject *
226 dict_popitem(PyObject *self, PyObject *Py_UNUSED(ignored))
227 {
228 PyObject *return_value = NULL;
229
230 Py_BEGIN_CRITICAL_SECTION(self);
231 return_value = dict_popitem_impl((PyDictObject *)self);
232 Py_END_CRITICAL_SECTION();
233
234 return return_value;
235 }
236
237 PyDoc_STRVAR(dict___sizeof____doc__,
238 "__sizeof__($self, /)\n"
239 "--\n"
240 "\n"
241 "Return the size of the dict in memory, in bytes.");
242
243 #define DICT___SIZEOF___METHODDEF \
244 {"__sizeof__", (PyCFunction)dict___sizeof__, METH_NOARGS, dict___sizeof____doc__},
245
246 static PyObject *
247 dict___sizeof___impl(PyDictObject *self);
248
249 static PyObject *
250 dict___sizeof__(PyObject *self, PyObject *Py_UNUSED(ignored))
251 {
252 return dict___sizeof___impl((PyDictObject *)self);
253 }
254
255 PyDoc_STRVAR(dict___reversed____doc__,
256 "__reversed__($self, /)\n"
257 "--\n"
258 "\n"
259 "Return a reverse iterator over the dict keys.");
260
261 #define DICT___REVERSED___METHODDEF \
262 {"__reversed__", (PyCFunction)dict___reversed__, METH_NOARGS, dict___reversed____doc__},
263
264 static PyObject *
265 dict___reversed___impl(PyDictObject *self);
266
267 static PyObject *
268 dict___reversed__(PyObject *self, PyObject *Py_UNUSED(ignored))
269 {
270 return dict___reversed___impl((PyDictObject *)self);
271 }
272
273 PyDoc_STRVAR(dict_keys__doc__,
274 "keys($self, /)\n"
275 "--\n"
276 "\n"
277 "Return a set-like object providing a view on the dict\'s keys.");
278
279 #define DICT_KEYS_METHODDEF \
280 {"keys", (PyCFunction)dict_keys, METH_NOARGS, dict_keys__doc__},
281
282 static PyObject *
283 dict_keys_impl(PyDictObject *self);
284
285 static PyObject *
286 dict_keys(PyObject *self, PyObject *Py_UNUSED(ignored))
287 {
288 return dict_keys_impl((PyDictObject *)self);
289 }
290
291 PyDoc_STRVAR(dict_items__doc__,
292 "items($self, /)\n"
293 "--\n"
294 "\n"
295 "Return a set-like object providing a view on the dict\'s items.");
296
297 #define DICT_ITEMS_METHODDEF \
298 {"items", (PyCFunction)dict_items, METH_NOARGS, dict_items__doc__},
299
300 static PyObject *
301 dict_items_impl(PyDictObject *self);
302
303 static PyObject *
304 dict_items(PyObject *self, PyObject *Py_UNUSED(ignored))
305 {
306 return dict_items_impl((PyDictObject *)self);
307 }
308
309 PyDoc_STRVAR(dict_values__doc__,
310 "values($self, /)\n"
311 "--\n"
312 "\n"
313 "Return an object providing a view on the dict\'s values.");
314
315 #define DICT_VALUES_METHODDEF \
316 {"values", (PyCFunction)dict_values, METH_NOARGS, dict_values__doc__},
317
318 static PyObject *
319 dict_values_impl(PyDictObject *self);
320
321 static PyObject *
322 dict_values(PyObject *self, PyObject *Py_UNUSED(ignored))
323 {
324 return dict_values_impl((PyDictObject *)self);
325 }
326 /*[clinic end generated code: output=9007b74432217017 input=a9049054013a1b77]*/