Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1 | /* Ordered Dictionary object implementation. |
| 2 | |
| 3 | This implementation is necessarily explicitly equivalent to the pure Python |
| 4 | OrderedDict class in Lib/collections/__init__.py. The strategy there |
| 5 | involves using a doubly-linked-list to capture the order. We keep to that |
| 6 | strategy, using a lower-level linked-list. |
| 7 | |
| 8 | About the Linked-List |
| 9 | ===================== |
| 10 | |
| 11 | For the linked list we use a basic doubly-linked-list. Using a circularly- |
| 12 | linked-list does have some benefits, but they don't apply so much here |
| 13 | since OrderedDict is focused on the ends of the list (for the most part). |
| 14 | Furthermore, there are some features of generic linked-lists that we simply |
| 15 | don't need for OrderedDict. Thus a simple custom implementation meets our |
| 16 | needs. Alternatives to our simple approach include the QCIRCLE_* |
| 17 | macros from BSD's queue.h, and the linux's list.h. |
| 18 | |
| 19 | Getting O(1) Node Lookup |
| 20 | ------------------------ |
| 21 | |
| 22 | One invariant of Python's OrderedDict is that it preserves time complexity |
| 23 | of dict's methods, particularly the O(1) operations. Simply adding a |
| 24 | linked-list on top of dict is not sufficient here; operations for nodes in |
| 25 | the middle of the linked-list implicitly require finding the node first. |
| 26 | With a simple linked-list like we're using, that is an O(n) operation. |
| 27 | Consequently, methods like __delitem__() would change from O(1) to O(n), |
| 28 | which is unacceptable. |
| 29 | |
| 30 | In order to preserve O(1) performance for node removal (finding nodes), we |
| 31 | must do better than just looping through the linked-list. Here are options |
| 32 | we've considered: |
| 33 | |
| 34 | 1. use a second dict to map keys to nodes (a la the pure Python version). |
| 35 | 2. keep a simple hash table mirroring the order of dict's, mapping each key |
| 36 | to the corresponding node in the linked-list. |
| 37 | 3. use a version of shared keys (split dict) that allows non-unicode keys. |
| 38 | 4. have the value stored for each key be a (value, node) pair, and adjust |
| 39 | __getitem__(), get(), etc. accordingly. |
| 40 | |
| 41 | The approach with the least performance impact (time and space) is #2, |
Benjamin Peterson | ee178e6 | 2016-09-08 11:08:30 -0700 | [diff] [blame] | 42 | mirroring the key order of dict's dk_entries with an array of node pointers. |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 43 | While lookdict() and friends (dk_lookup) don't give us the index into the |
| 44 | array, we make use of pointer arithmetic to get that index. An alternative |
| 45 | would be to refactor lookdict() to provide the index, explicitly exposing |
| 46 | the implementation detail. We could even just use a custom lookup function |
| 47 | for OrderedDict that facilitates our need. However, both approaches are |
| 48 | significantly more complicated than just using pointer arithmetic. |
| 49 | |
| 50 | The catch with mirroring the hash table ordering is that we have to keep |
| 51 | the ordering in sync through any dict resizes. However, that order only |
| 52 | matters during node lookup. We can simply defer any potential resizing |
| 53 | until we need to do a lookup. |
| 54 | |
| 55 | Linked-List Nodes |
| 56 | ----------------- |
| 57 | |
| 58 | The current implementation stores a pointer to the associated key only. |
| 59 | One alternative would be to store a pointer to the PyDictKeyEntry instead. |
| 60 | This would save one pointer de-reference per item, which is nice during |
| 61 | calls to values() and items(). However, it adds unnecessary overhead |
| 62 | otherwise, so we stick with just the key. |
| 63 | |
| 64 | Linked-List API |
| 65 | --------------- |
| 66 | |
| 67 | As noted, the linked-list implemented here does not have all the bells and |
| 68 | whistles. However, we recognize that the implementation may need to |
| 69 | change to accommodate performance improvements or extra functionality. To |
Robert Krzyzanowski | 6f19fc6 | 2018-07-06 05:54:26 -0500 | [diff] [blame] | 70 | that end, we use a simple API to interact with the linked-list. Here's a |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 71 | summary of the methods/macros: |
| 72 | |
| 73 | Node info: |
| 74 | |
| 75 | * _odictnode_KEY(node) |
| 76 | * _odictnode_VALUE(od, node) |
| 77 | * _odictnode_PREV(node) |
| 78 | * _odictnode_NEXT(node) |
| 79 | |
| 80 | Linked-List info: |
| 81 | |
| 82 | * _odict_FIRST(od) |
| 83 | * _odict_LAST(od) |
| 84 | * _odict_EMPTY(od) |
| 85 | * _odict_FOREACH(od, node) - used in place of `for (node=...)` |
| 86 | |
| 87 | For adding nodes: |
| 88 | |
| 89 | * _odict_add_head(od, node) |
| 90 | * _odict_add_tail(od, node) |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 91 | * _odict_add_new_node(od, key, hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 92 | |
| 93 | For removing nodes: |
| 94 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 95 | * _odict_clear_node(od, node, key, hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 96 | * _odict_clear_nodes(od, clear_each) |
| 97 | |
| 98 | Others: |
| 99 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 100 | * _odict_find_node_hash(od, key, hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 101 | * _odict_find_node(od, key) |
| 102 | * _odict_keys_equal(od1, od2) |
| 103 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 104 | And here's a look at how the linked-list relates to the OrderedDict API: |
| 105 | |
| 106 | ============ === === ==== ==== ==== === ==== ===== ==== ==== === ==== === === |
| 107 | method key val prev next mem 1st last empty iter find add rmv clr keq |
| 108 | ============ === === ==== ==== ==== === ==== ===== ==== ==== === ==== === === |
| 109 | __del__ ~ X |
| 110 | __delitem__ free ~ node |
| 111 | __eq__ ~ X |
| 112 | __iter__ X X |
| 113 | __new__ X X |
| 114 | __reduce__ X ~ X |
| 115 | __repr__ X X X |
| 116 | __reversed__ X X |
| 117 | __setitem__ key |
| 118 | __sizeof__ size X |
| 119 | clear ~ ~ X |
| 120 | copy X X X |
| 121 | items X X X |
| 122 | keys X X |
| 123 | move_to_end X X X ~ h/t key |
| 124 | pop free key |
| 125 | popitem X X free X X node |
| 126 | setdefault ~ ? ~ |
| 127 | values X X |
| 128 | ============ === === ==== ==== ==== === ==== ===== ==== ==== === ==== === === |
| 129 | |
| 130 | __delitem__ is the only method that directly relies on finding an arbitrary |
| 131 | node in the linked-list. Everything else is iteration or relates to the |
| 132 | ends of the linked-list. |
| 133 | |
| 134 | Situation that Endangers Consistency |
| 135 | ------------------------------------ |
| 136 | Using a raw linked-list for OrderedDict exposes a key situation that can |
| 137 | cause problems. If a node is stored in a variable, there is a chance that |
| 138 | the node may have been deallocated before the variable gets used, thus |
| 139 | potentially leading to a segmentation fault. A key place where this shows |
| 140 | up is during iteration through the linked list (via _odict_FOREACH or |
| 141 | otherwise). |
| 142 | |
| 143 | A number of solutions are available to resolve this situation: |
| 144 | |
| 145 | * defer looking up the node until as late as possible and certainly after |
| 146 | any code that could possibly result in a deletion; |
| 147 | * if the node is needed both before and after a point where the node might |
| 148 | be removed, do a check before using the node at the "after" location to |
| 149 | see if the node is still valid; |
| 150 | * like the last one, but simply pull the node again to ensure it's right; |
| 151 | * keep the key in the variable instead of the node and then look up the |
| 152 | node using the key at the point where the node is needed (this is what |
| 153 | we do for the iterators). |
| 154 | |
| 155 | Another related problem, preserving consistent ordering during iteration, |
| 156 | is described below. That one is not exclusive to using linked-lists. |
| 157 | |
| 158 | |
| 159 | Challenges from Subclassing dict |
| 160 | ================================ |
| 161 | |
| 162 | OrderedDict subclasses dict, which is an unusual relationship between two |
| 163 | builtin types (other than the base object type). Doing so results in |
| 164 | some complication and deserves further explanation. There are two things |
| 165 | to consider here. First, in what circumstances or with what adjustments |
| 166 | can OrderedDict be used as a drop-in replacement for dict (at the C level)? |
| 167 | Second, how can the OrderedDict implementation leverage the dict |
| 168 | implementation effectively without introducing unnecessary coupling or |
| 169 | inefficiencies? |
| 170 | |
| 171 | This second point is reflected here and in the implementation, so the |
| 172 | further focus is on the first point. It is worth noting that for |
| 173 | overridden methods, the dict implementation is deferred to as much as |
| 174 | possible. Furthermore, coupling is limited to as little as is reasonable. |
| 175 | |
| 176 | Concrete API Compatibility |
| 177 | -------------------------- |
| 178 | |
| 179 | Use of the concrete C-API for dict (PyDict_*) with OrderedDict is |
| 180 | problematic. (See http://bugs.python.org/issue10977.) The concrete API |
| 181 | has a number of hard-coded assumptions tied to the dict implementation. |
| 182 | This is, in part, due to performance reasons, which is understandable |
| 183 | given the part dict plays in Python. |
| 184 | |
| 185 | Any attempt to replace dict with OrderedDict for any role in the |
| 186 | interpreter (e.g. **kwds) faces a challenge. Such any effort must |
| 187 | recognize that the instances in affected locations currently interact with |
| 188 | the concrete API. |
| 189 | |
| 190 | Here are some ways to address this challenge: |
| 191 | |
| 192 | 1. Change the relevant usage of the concrete API in CPython and add |
Martin Panter | 69332c1 | 2016-08-04 13:07:31 +0000 | [diff] [blame] | 193 | PyDict_CheckExact() calls to each of the concrete API functions. |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 194 | 2. Adjust the relevant concrete API functions to explicitly accommodate |
| 195 | OrderedDict. |
| 196 | 3. As with #1, add the checks, but improve the abstract API with smart fast |
| 197 | paths for dict and OrderedDict, and refactor CPython to use the abstract |
| 198 | API. Improvements to the abstract API would be valuable regardless. |
| 199 | |
| 200 | Adding the checks to the concrete API would help make any interpreter |
| 201 | switch to OrderedDict less painful for extension modules. However, this |
| 202 | won't work. The equivalent C API call to `dict.__setitem__(obj, k, v)` |
| 203 | is 'PyDict_SetItem(obj, k, v)`. This illustrates how subclasses in C call |
| 204 | the base class's methods, since there is no equivalent of super() in the |
| 205 | C API. Calling into Python for parent class API would work, but some |
| 206 | extension modules already rely on this feature of the concrete API. |
| 207 | |
| 208 | For reference, here is a breakdown of some of the dict concrete API: |
| 209 | |
| 210 | ========================== ============= ======================= |
| 211 | concrete API uses abstract API |
| 212 | ========================== ============= ======================= |
| 213 | PyDict_Check PyMapping_Check |
| 214 | (PyDict_CheckExact) - |
| 215 | (PyDict_New) - |
| 216 | (PyDictProxy_New) - |
| 217 | PyDict_Clear - |
| 218 | PyDict_Contains PySequence_Contains |
| 219 | PyDict_Copy - |
| 220 | PyDict_SetItem PyObject_SetItem |
| 221 | PyDict_SetItemString PyMapping_SetItemString |
| 222 | PyDict_DelItem PyMapping_DelItem |
| 223 | PyDict_DelItemString PyMapping_DelItemString |
| 224 | PyDict_GetItem - |
| 225 | PyDict_GetItemWithError PyObject_GetItem |
| 226 | _PyDict_GetItemIdWithError - |
| 227 | PyDict_GetItemString PyMapping_GetItemString |
| 228 | PyDict_Items PyMapping_Items |
| 229 | PyDict_Keys PyMapping_Keys |
| 230 | PyDict_Values PyMapping_Values |
| 231 | PyDict_Size PyMapping_Size |
| 232 | PyMapping_Length |
| 233 | PyDict_Next PyIter_Next |
| 234 | _PyDict_Next - |
| 235 | PyDict_Merge - |
| 236 | PyDict_Update - |
| 237 | PyDict_MergeFromSeq2 - |
| 238 | PyDict_ClearFreeList - |
| 239 | - PyMapping_HasKeyString |
| 240 | - PyMapping_HasKey |
| 241 | ========================== ============= ======================= |
| 242 | |
| 243 | |
| 244 | The dict Interface Relative to OrderedDict |
| 245 | ========================================== |
| 246 | |
| 247 | Since OrderedDict subclasses dict, understanding the various methods and |
| 248 | attributes of dict is important for implementing OrderedDict. |
| 249 | |
| 250 | Relevant Type Slots |
| 251 | ------------------- |
| 252 | |
| 253 | ================= ================ =================== ================ |
| 254 | slot attribute object dict |
| 255 | ================= ================ =================== ================ |
| 256 | tp_dealloc - object_dealloc dict_dealloc |
| 257 | tp_repr __repr__ object_repr dict_repr |
| 258 | sq_contains __contains__ - dict_contains |
| 259 | mp_length __len__ - dict_length |
| 260 | mp_subscript __getitem__ - dict_subscript |
| 261 | mp_ass_subscript __setitem__ - dict_ass_sub |
| 262 | __delitem__ |
| 263 | tp_hash __hash__ _Py_HashPointer ..._HashNotImpl |
| 264 | tp_str __str__ object_str - |
| 265 | tp_getattro __getattribute__ ..._GenericGetAttr (repeated) |
| 266 | __getattr__ |
| 267 | tp_setattro __setattr__ ..._GenericSetAttr (disabled) |
| 268 | tp_doc __doc__ (literal) dictionary_doc |
| 269 | tp_traverse - - dict_traverse |
| 270 | tp_clear - - dict_tp_clear |
| 271 | tp_richcompare __eq__ object_richcompare dict_richcompare |
| 272 | __ne__ |
| 273 | tp_weaklistoffset (__weakref__) - - |
| 274 | tp_iter __iter__ - dict_iter |
| 275 | tp_dictoffset (__dict__) - - |
| 276 | tp_init __init__ object_init dict_init |
| 277 | tp_alloc - PyType_GenericAlloc (repeated) |
| 278 | tp_new __new__ object_new dict_new |
| 279 | tp_free - PyObject_Del PyObject_GC_Del |
| 280 | ================= ================ =================== ================ |
| 281 | |
| 282 | Relevant Methods |
| 283 | ---------------- |
| 284 | |
| 285 | ================ =================== =============== |
| 286 | method object dict |
| 287 | ================ =================== =============== |
| 288 | __reduce__ object_reduce - |
| 289 | __sizeof__ object_sizeof dict_sizeof |
| 290 | clear - dict_clear |
| 291 | copy - dict_copy |
| 292 | fromkeys - dict_fromkeys |
| 293 | get - dict_get |
| 294 | items - dictitems_new |
| 295 | keys - dictkeys_new |
| 296 | pop - dict_pop |
| 297 | popitem - dict_popitem |
| 298 | setdefault - dict_setdefault |
| 299 | update - dict_update |
| 300 | values - dictvalues_new |
| 301 | ================ =================== =============== |
| 302 | |
| 303 | |
| 304 | Pure Python OrderedDict |
| 305 | ======================= |
| 306 | |
| 307 | As already noted, compatibility with the pure Python OrderedDict |
| 308 | implementation is a key goal of this C implementation. To further that |
| 309 | goal, here's a summary of how OrderedDict-specific methods are implemented |
| 310 | in collections/__init__.py. Also provided is an indication of which |
| 311 | methods directly mutate or iterate the object, as well as any relationship |
| 312 | with the underlying linked-list. |
| 313 | |
| 314 | ============= ============== == ================ === === ==== |
| 315 | method impl used ll uses inq mut iter |
| 316 | ============= ============== == ================ === === ==== |
| 317 | __contains__ dict - - X |
| 318 | __delitem__ OrderedDict Y dict.__delitem__ X |
| 319 | __eq__ OrderedDict N OrderedDict ~ |
| 320 | dict.__eq__ |
| 321 | __iter__ |
| 322 | __getitem__ dict - - X |
| 323 | __iter__ OrderedDict Y - X |
| 324 | __init__ OrderedDict N update |
| 325 | __len__ dict - - X |
| 326 | __ne__ MutableMapping - __eq__ ~ |
| 327 | __reduce__ OrderedDict N OrderedDict ~ |
| 328 | __iter__ |
| 329 | __getitem__ |
| 330 | __repr__ OrderedDict N __class__ ~ |
| 331 | items |
| 332 | __reversed__ OrderedDict Y - X |
| 333 | __setitem__ OrderedDict Y __contains__ X |
| 334 | dict.__setitem__ |
| 335 | __sizeof__ OrderedDict Y __len__ ~ |
| 336 | __dict__ |
| 337 | clear OrderedDict Y dict.clear X |
| 338 | copy OrderedDict N __class__ |
| 339 | __init__ |
| 340 | fromkeys OrderedDict N __setitem__ |
| 341 | get dict - - ~ |
| 342 | items MutableMapping - ItemsView X |
| 343 | keys MutableMapping - KeysView X |
| 344 | move_to_end OrderedDict Y - X |
| 345 | pop OrderedDict N __contains__ X |
| 346 | __getitem__ |
| 347 | __delitem__ |
| 348 | popitem OrderedDict Y dict.pop X |
| 349 | setdefault OrderedDict N __contains__ ~ |
| 350 | __getitem__ |
| 351 | __setitem__ |
| 352 | update MutableMapping - __setitem__ ~ |
| 353 | values MutableMapping - ValuesView X |
| 354 | ============= ============== == ================ === === ==== |
| 355 | |
| 356 | __reversed__ and move_to_end are both exclusive to OrderedDict. |
| 357 | |
| 358 | |
| 359 | C OrderedDict Implementation |
| 360 | ============================ |
| 361 | |
| 362 | ================= ================ |
| 363 | slot impl |
| 364 | ================= ================ |
| 365 | tp_dealloc odict_dealloc |
| 366 | tp_repr odict_repr |
| 367 | mp_ass_subscript odict_ass_sub |
| 368 | tp_doc odict_doc |
| 369 | tp_traverse odict_traverse |
| 370 | tp_clear odict_tp_clear |
| 371 | tp_richcompare odict_richcompare |
| 372 | tp_weaklistoffset (offset) |
| 373 | tp_iter odict_iter |
| 374 | tp_dictoffset (offset) |
| 375 | tp_init odict_init |
| 376 | tp_alloc (repeated) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 377 | ================= ================ |
| 378 | |
| 379 | ================= ================ |
| 380 | method impl |
| 381 | ================= ================ |
| 382 | __reduce__ odict_reduce |
| 383 | __sizeof__ odict_sizeof |
| 384 | clear odict_clear |
| 385 | copy odict_copy |
| 386 | fromkeys odict_fromkeys |
| 387 | items odictitems_new |
| 388 | keys odictkeys_new |
| 389 | pop odict_pop |
| 390 | popitem odict_popitem |
| 391 | setdefault odict_setdefault |
| 392 | update odict_update |
| 393 | values odictvalues_new |
| 394 | ================= ================ |
| 395 | |
| 396 | Inherited unchanged from object/dict: |
| 397 | |
| 398 | ================ ========================== |
| 399 | method type field |
| 400 | ================ ========================== |
| 401 | - tp_free |
| 402 | __contains__ tp_as_sequence.sq_contains |
| 403 | __getattr__ tp_getattro |
| 404 | __getattribute__ tp_getattro |
| 405 | __getitem__ tp_as_mapping.mp_subscript |
| 406 | __hash__ tp_hash |
| 407 | __len__ tp_as_mapping.mp_length |
| 408 | __setattr__ tp_setattro |
| 409 | __str__ tp_str |
| 410 | get - |
| 411 | ================ ========================== |
| 412 | |
| 413 | |
| 414 | Other Challenges |
| 415 | ================ |
| 416 | |
| 417 | Preserving Ordering During Iteration |
| 418 | ------------------------------------ |
| 419 | During iteration through an OrderedDict, it is possible that items could |
| 420 | get added, removed, or reordered. For a linked-list implementation, as |
| 421 | with some other implementations, that situation may lead to undefined |
| 422 | behavior. The documentation for dict mentions this in the `iter()` section |
| 423 | of http://docs.python.org/3.4/library/stdtypes.html#dictionary-view-objects. |
| 424 | In this implementation we follow dict's lead (as does the pure Python |
| 425 | implementation) for __iter__(), keys(), values(), and items(). |
| 426 | |
| 427 | For internal iteration (using _odict_FOREACH or not), there is still the |
| 428 | risk that not all nodes that we expect to be seen in the loop actually get |
| 429 | seen. Thus, we are careful in each of those places to ensure that they |
| 430 | are. This comes, of course, at a small price at each location. The |
| 431 | solutions are much the same as those detailed in the `Situation that |
| 432 | Endangers Consistency` section above. |
| 433 | |
| 434 | |
| 435 | Potential Optimizations |
| 436 | ======================= |
| 437 | |
| 438 | * Allocate the nodes as a block via od_fast_nodes instead of individually. |
| 439 | - Set node->key to NULL to indicate the node is not-in-use. |
| 440 | - Add _odict_EXISTS()? |
| 441 | - How to maintain consistency across resizes? Existing node pointers |
Robert Krzyzanowski | 6f19fc6 | 2018-07-06 05:54:26 -0500 | [diff] [blame] | 442 | would be invalidated after a resize, which is particularly problematic |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 443 | for the iterators. |
| 444 | * Use a more stream-lined implementation of update() and, likely indirectly, |
| 445 | __init__(). |
| 446 | |
| 447 | */ |
| 448 | |
| 449 | /* TODO |
| 450 | |
| 451 | sooner: |
| 452 | - reentrancy (make sure everything is at a thread-safe state when calling |
| 453 | into Python). I've already checked this multiple times, but want to |
| 454 | make one more pass. |
| 455 | - add unit tests for reentrancy? |
| 456 | |
| 457 | later: |
| 458 | - make the dict views support the full set API (the pure Python impl does) |
| 459 | - implement a fuller MutableMapping API in C? |
| 460 | - move the MutableMapping implementation to abstract.c? |
| 461 | - optimize mutablemapping_update |
| 462 | - use PyObject_MALLOC (small object allocator) for odict nodes? |
| 463 | - support subclasses better (e.g. in odict_richcompare) |
| 464 | |
| 465 | */ |
| 466 | |
| 467 | #include "Python.h" |
Victor Stinner | bcda8f1 | 2018-11-21 22:27:47 +0100 | [diff] [blame] | 468 | #include "pycore_object.h" |
Victor Stinner | 621cebe | 2018-11-12 16:53:38 +0100 | [diff] [blame] | 469 | #include "pycore_pystate.h" |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 470 | #include "structmember.h" |
| 471 | #include "dict-common.h" |
| 472 | #include <stddef.h> |
| 473 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 474 | #include "clinic/odictobject.c.h" |
| 475 | |
| 476 | /*[clinic input] |
| 477 | class OrderedDict "PyODictObject *" "&PyODict_Type" |
| 478 | [clinic start generated code]*/ |
| 479 | /*[clinic end generated code: output=da39a3ee5e6b4b0d input=ca0641cf6143d4af]*/ |
| 480 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 481 | |
| 482 | typedef struct _odictnode _ODictNode; |
| 483 | |
| 484 | /* PyODictObject */ |
| 485 | struct _odictobject { |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 486 | PyDictObject od_dict; /* the underlying dict */ |
| 487 | _ODictNode *od_first; /* first node in the linked list, if any */ |
| 488 | _ODictNode *od_last; /* last node in the linked list, if any */ |
Serhiy Storchaka | 97f46db | 2015-11-06 12:00:03 +0200 | [diff] [blame] | 489 | /* od_fast_nodes, od_fast_nodes_size and od_resize_sentinel are managed |
| 490 | * by _odict_resize(). |
Eric Snow | 8c7f955 | 2015-08-07 17:45:12 -0600 | [diff] [blame] | 491 | * Note that we rely on implementation details of dict for both. */ |
| 492 | _ODictNode **od_fast_nodes; /* hash table that mirrors the dict table */ |
Serhiy Storchaka | 97f46db | 2015-11-06 12:00:03 +0200 | [diff] [blame] | 493 | Py_ssize_t od_fast_nodes_size; |
| 494 | void *od_resize_sentinel; /* changes if odict should be resized */ |
Eric Snow | 8c7f955 | 2015-08-07 17:45:12 -0600 | [diff] [blame] | 495 | |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 496 | size_t od_state; /* incremented whenever the LL changes */ |
| 497 | PyObject *od_inst_dict; /* OrderedDict().__dict__ */ |
| 498 | PyObject *od_weakreflist; /* holds weakrefs to the odict */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 499 | }; |
| 500 | |
| 501 | |
| 502 | /* ---------------------------------------------- |
| 503 | * odict keys (a simple doubly-linked list) |
| 504 | */ |
| 505 | |
| 506 | struct _odictnode { |
| 507 | PyObject *key; |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 508 | Py_hash_t hash; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 509 | _ODictNode *next; |
| 510 | _ODictNode *prev; |
| 511 | }; |
| 512 | |
| 513 | #define _odictnode_KEY(node) \ |
| 514 | (node->key) |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 515 | #define _odictnode_HASH(node) \ |
| 516 | (node->hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 517 | /* borrowed reference */ |
| 518 | #define _odictnode_VALUE(node, od) \ |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 519 | PyODict_GetItemWithError((PyObject *)od, _odictnode_KEY(node)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 520 | #define _odictnode_PREV(node) (node->prev) |
| 521 | #define _odictnode_NEXT(node) (node->next) |
| 522 | |
| 523 | #define _odict_FIRST(od) (((PyODictObject *)od)->od_first) |
| 524 | #define _odict_LAST(od) (((PyODictObject *)od)->od_last) |
| 525 | #define _odict_EMPTY(od) (_odict_FIRST(od) == NULL) |
| 526 | #define _odict_FOREACH(od, node) \ |
| 527 | for (node = _odict_FIRST(od); node != NULL; node = _odictnode_NEXT(node)) |
| 528 | |
Hai Shi | 46874c2 | 2020-01-30 17:20:25 -0600 | [diff] [blame] | 529 | _Py_IDENTIFIER(items); |
| 530 | |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 531 | /* Return the index into the hash table, regardless of a valid node. */ |
| 532 | static Py_ssize_t |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 533 | _odict_get_index_raw(PyODictObject *od, PyObject *key, Py_hash_t hash) |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 534 | { |
INADA Naoki | ba60977 | 2016-12-07 20:41:42 +0900 | [diff] [blame] | 535 | PyObject *value = NULL; |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 536 | PyDictKeysObject *keys = ((PyDictObject *)od)->ma_keys; |
Victor Stinner | 742da04 | 2016-09-07 17:40:12 -0700 | [diff] [blame] | 537 | Py_ssize_t ix; |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 538 | |
INADA Naoki | 778928b | 2017-08-03 23:45:15 +0900 | [diff] [blame] | 539 | ix = (keys->dk_lookup)((PyDictObject *)od, key, hash, &value); |
Victor Stinner | 742da04 | 2016-09-07 17:40:12 -0700 | [diff] [blame] | 540 | if (ix == DKIX_EMPTY) { |
| 541 | return keys->dk_nentries; /* index of new entry */ |
| 542 | } |
| 543 | if (ix < 0) |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 544 | return -1; |
| 545 | /* We use pointer arithmetic to get the entry's index into the table. */ |
Victor Stinner | 742da04 | 2016-09-07 17:40:12 -0700 | [diff] [blame] | 546 | return ix; |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 547 | } |
| 548 | |
| 549 | /* Replace od->od_fast_nodes with a new table matching the size of dict's. */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 550 | static int |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 551 | _odict_resize(PyODictObject *od) |
| 552 | { |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 553 | Py_ssize_t size, i; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 554 | _ODictNode **fast_nodes, *node; |
| 555 | |
| 556 | /* Initialize a new "fast nodes" table. */ |
| 557 | size = ((PyDictObject *)od)->ma_keys->dk_size; |
| 558 | fast_nodes = PyMem_NEW(_ODictNode *, size); |
| 559 | if (fast_nodes == NULL) { |
| 560 | PyErr_NoMemory(); |
| 561 | return -1; |
| 562 | } |
| 563 | for (i = 0; i < size; i++) |
| 564 | fast_nodes[i] = NULL; |
| 565 | |
| 566 | /* Copy the current nodes into the table. */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 567 | _odict_FOREACH(od, node) { |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 568 | i = _odict_get_index_raw(od, _odictnode_KEY(node), |
Victor Stinner | 742da04 | 2016-09-07 17:40:12 -0700 | [diff] [blame] | 569 | _odictnode_HASH(node)); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 570 | if (i < 0) { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 571 | PyMem_FREE(fast_nodes); |
| 572 | return -1; |
| 573 | } |
| 574 | fast_nodes[i] = node; |
| 575 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 576 | |
| 577 | /* Replace the old fast nodes table. */ |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 578 | PyMem_FREE(od->od_fast_nodes); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 579 | od->od_fast_nodes = fast_nodes; |
Serhiy Storchaka | 97f46db | 2015-11-06 12:00:03 +0200 | [diff] [blame] | 580 | od->od_fast_nodes_size = size; |
| 581 | od->od_resize_sentinel = ((PyDictObject *)od)->ma_keys; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 582 | return 0; |
| 583 | } |
| 584 | |
| 585 | /* Return the index into the hash table, regardless of a valid node. */ |
| 586 | static Py_ssize_t |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 587 | _odict_get_index(PyODictObject *od, PyObject *key, Py_hash_t hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 588 | { |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 589 | PyDictKeysObject *keys; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 590 | |
| 591 | assert(key != NULL); |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 592 | keys = ((PyDictObject *)od)->ma_keys; |
| 593 | |
| 594 | /* Ensure od_fast_nodes and dk_entries are in sync. */ |
Serhiy Storchaka | 97f46db | 2015-11-06 12:00:03 +0200 | [diff] [blame] | 595 | if (od->od_resize_sentinel != keys || |
| 596 | od->od_fast_nodes_size != keys->dk_size) { |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 597 | int resize_res = _odict_resize(od); |
| 598 | if (resize_res < 0) |
| 599 | return -1; |
| 600 | } |
| 601 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 602 | return _odict_get_index_raw(od, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 603 | } |
| 604 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 605 | /* Returns NULL if there was some error or the key was not found. */ |
| 606 | static _ODictNode * |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 607 | _odict_find_node_hash(PyODictObject *od, PyObject *key, Py_hash_t hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 608 | { |
| 609 | Py_ssize_t index; |
| 610 | |
| 611 | if (_odict_EMPTY(od)) |
| 612 | return NULL; |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 613 | index = _odict_get_index(od, key, hash); |
| 614 | if (index < 0) |
| 615 | return NULL; |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 616 | assert(od->od_fast_nodes != NULL); |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 617 | return od->od_fast_nodes[index]; |
| 618 | } |
| 619 | |
| 620 | static _ODictNode * |
| 621 | _odict_find_node(PyODictObject *od, PyObject *key) |
| 622 | { |
| 623 | Py_ssize_t index; |
| 624 | Py_hash_t hash; |
| 625 | |
| 626 | if (_odict_EMPTY(od)) |
| 627 | return NULL; |
| 628 | hash = PyObject_Hash(key); |
| 629 | if (hash == -1) |
| 630 | return NULL; |
| 631 | index = _odict_get_index(od, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 632 | if (index < 0) |
| 633 | return NULL; |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 634 | assert(od->od_fast_nodes != NULL); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 635 | return od->od_fast_nodes[index]; |
| 636 | } |
| 637 | |
| 638 | static void |
| 639 | _odict_add_head(PyODictObject *od, _ODictNode *node) |
| 640 | { |
Serhiy Storchaka | 992ec46 | 2015-10-14 19:21:24 +0300 | [diff] [blame] | 641 | _odictnode_PREV(node) = NULL; |
| 642 | _odictnode_NEXT(node) = _odict_FIRST(od); |
| 643 | if (_odict_FIRST(od) == NULL) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 644 | _odict_LAST(od) = node; |
Serhiy Storchaka | 992ec46 | 2015-10-14 19:21:24 +0300 | [diff] [blame] | 645 | else |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 646 | _odictnode_PREV(_odict_FIRST(od)) = node; |
Serhiy Storchaka | 992ec46 | 2015-10-14 19:21:24 +0300 | [diff] [blame] | 647 | _odict_FIRST(od) = node; |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 648 | od->od_state++; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 649 | } |
| 650 | |
| 651 | static void |
| 652 | _odict_add_tail(PyODictObject *od, _ODictNode *node) |
| 653 | { |
Serhiy Storchaka | 992ec46 | 2015-10-14 19:21:24 +0300 | [diff] [blame] | 654 | _odictnode_PREV(node) = _odict_LAST(od); |
| 655 | _odictnode_NEXT(node) = NULL; |
| 656 | if (_odict_LAST(od) == NULL) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 657 | _odict_FIRST(od) = node; |
Serhiy Storchaka | 992ec46 | 2015-10-14 19:21:24 +0300 | [diff] [blame] | 658 | else |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 659 | _odictnode_NEXT(_odict_LAST(od)) = node; |
Serhiy Storchaka | 992ec46 | 2015-10-14 19:21:24 +0300 | [diff] [blame] | 660 | _odict_LAST(od) = node; |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 661 | od->od_state++; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 662 | } |
| 663 | |
| 664 | /* adds the node to the end of the list */ |
| 665 | static int |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 666 | _odict_add_new_node(PyODictObject *od, PyObject *key, Py_hash_t hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 667 | { |
| 668 | Py_ssize_t i; |
| 669 | _ODictNode *node; |
| 670 | |
Serhiy Storchaka | d17427b | 2015-10-20 18:21:48 +0300 | [diff] [blame] | 671 | Py_INCREF(key); |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 672 | i = _odict_get_index(od, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 673 | if (i < 0) { |
| 674 | if (!PyErr_Occurred()) |
| 675 | PyErr_SetObject(PyExc_KeyError, key); |
| 676 | Py_DECREF(key); |
| 677 | return -1; |
| 678 | } |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 679 | assert(od->od_fast_nodes != NULL); |
| 680 | if (od->od_fast_nodes[i] != NULL) { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 681 | /* We already have a node for the key so there's no need to add one. */ |
| 682 | Py_DECREF(key); |
| 683 | return 0; |
| 684 | } |
| 685 | |
| 686 | /* must not be added yet */ |
| 687 | node = (_ODictNode *)PyMem_MALLOC(sizeof(_ODictNode)); |
| 688 | if (node == NULL) { |
| 689 | Py_DECREF(key); |
| 690 | PyErr_NoMemory(); |
| 691 | return -1; |
| 692 | } |
| 693 | |
| 694 | _odictnode_KEY(node) = key; |
Eric Snow | 4c72918 | 2015-06-03 10:50:37 -0600 | [diff] [blame] | 695 | _odictnode_HASH(node) = hash; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 696 | _odict_add_tail(od, node); |
| 697 | od->od_fast_nodes[i] = node; |
| 698 | return 0; |
| 699 | } |
| 700 | |
| 701 | /* Putting the decref after the free causes problems. */ |
| 702 | #define _odictnode_DEALLOC(node) \ |
| 703 | do { \ |
| 704 | Py_DECREF(_odictnode_KEY(node)); \ |
| 705 | PyMem_FREE((void *)node); \ |
| 706 | } while (0) |
| 707 | |
| 708 | /* Repeated calls on the same node are no-ops. */ |
| 709 | static void |
| 710 | _odict_remove_node(PyODictObject *od, _ODictNode *node) |
| 711 | { |
| 712 | if (_odict_FIRST(od) == node) |
| 713 | _odict_FIRST(od) = _odictnode_NEXT(node); |
| 714 | else if (_odictnode_PREV(node) != NULL) |
| 715 | _odictnode_NEXT(_odictnode_PREV(node)) = _odictnode_NEXT(node); |
| 716 | |
| 717 | if (_odict_LAST(od) == node) |
| 718 | _odict_LAST(od) = _odictnode_PREV(node); |
| 719 | else if (_odictnode_NEXT(node) != NULL) |
| 720 | _odictnode_PREV(_odictnode_NEXT(node)) = _odictnode_PREV(node); |
| 721 | |
| 722 | _odictnode_PREV(node) = NULL; |
| 723 | _odictnode_NEXT(node) = NULL; |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 724 | od->od_state++; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 725 | } |
| 726 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 727 | /* If someone calls PyDict_DelItem() directly on an OrderedDict, we'll |
| 728 | get all sorts of problems here. In PyODict_DelItem we make sure to |
| 729 | call _odict_clear_node first. |
Victor Stinner | ca30b02 | 2015-09-03 17:50:04 +0200 | [diff] [blame] | 730 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 731 | This matters in the case of colliding keys. Suppose we add 3 keys: |
| 732 | [A, B, C], where the hash of C collides with A and the next possible |
| 733 | index in the hash table is occupied by B. If we remove B then for C |
| 734 | the dict's looknode func will give us the old index of B instead of |
| 735 | the index we got before deleting B. However, the node for C in |
| 736 | od_fast_nodes is still at the old dict index of C. Thus to be sure |
| 737 | things don't get out of sync, we clear the node in od_fast_nodes |
| 738 | *before* calling PyDict_DelItem. |
| 739 | |
| 740 | The same must be done for any other OrderedDict operations where |
| 741 | we modify od_fast_nodes. |
| 742 | */ |
| 743 | static int |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 744 | _odict_clear_node(PyODictObject *od, _ODictNode *node, PyObject *key, |
| 745 | Py_hash_t hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 746 | { |
| 747 | Py_ssize_t i; |
| 748 | |
| 749 | assert(key != NULL); |
| 750 | if (_odict_EMPTY(od)) { |
| 751 | /* Let later code decide if this is a KeyError. */ |
| 752 | return 0; |
| 753 | } |
| 754 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 755 | i = _odict_get_index(od, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 756 | if (i < 0) |
| 757 | return PyErr_Occurred() ? -1 : 0; |
| 758 | |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 759 | assert(od->od_fast_nodes != NULL); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 760 | if (node == NULL) |
| 761 | node = od->od_fast_nodes[i]; |
| 762 | assert(node == od->od_fast_nodes[i]); |
| 763 | if (node == NULL) { |
| 764 | /* Let later code decide if this is a KeyError. */ |
| 765 | return 0; |
| 766 | } |
| 767 | |
| 768 | // Now clear the node. |
| 769 | od->od_fast_nodes[i] = NULL; |
| 770 | _odict_remove_node(od, node); |
| 771 | _odictnode_DEALLOC(node); |
| 772 | return 0; |
| 773 | } |
| 774 | |
| 775 | static void |
| 776 | _odict_clear_nodes(PyODictObject *od) |
| 777 | { |
| 778 | _ODictNode *node, *next; |
| 779 | |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 780 | PyMem_FREE(od->od_fast_nodes); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 781 | od->od_fast_nodes = NULL; |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 782 | od->od_fast_nodes_size = 0; |
| 783 | od->od_resize_sentinel = NULL; |
Serhiy Storchaka | d205d01 | 2016-01-19 14:46:25 +0200 | [diff] [blame] | 784 | |
| 785 | node = _odict_FIRST(od); |
| 786 | _odict_FIRST(od) = NULL; |
| 787 | _odict_LAST(od) = NULL; |
| 788 | while (node != NULL) { |
| 789 | next = _odictnode_NEXT(node); |
| 790 | _odictnode_DEALLOC(node); |
| 791 | node = next; |
| 792 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 793 | } |
| 794 | |
| 795 | /* There isn't any memory management of nodes past this point. */ |
| 796 | #undef _odictnode_DEALLOC |
| 797 | |
| 798 | static int |
| 799 | _odict_keys_equal(PyODictObject *a, PyODictObject *b) |
| 800 | { |
| 801 | _ODictNode *node_a, *node_b; |
| 802 | |
| 803 | node_a = _odict_FIRST(a); |
| 804 | node_b = _odict_FIRST(b); |
| 805 | while (1) { |
| 806 | if (node_a == NULL && node_b == NULL) |
| 807 | /* success: hit the end of each at the same time */ |
| 808 | return 1; |
| 809 | else if (node_a == NULL || node_b == NULL) |
| 810 | /* unequal length */ |
| 811 | return 0; |
| 812 | else { |
| 813 | int res = PyObject_RichCompareBool( |
| 814 | (PyObject *)_odictnode_KEY(node_a), |
| 815 | (PyObject *)_odictnode_KEY(node_b), |
| 816 | Py_EQ); |
| 817 | if (res < 0) |
| 818 | return res; |
| 819 | else if (res == 0) |
| 820 | return 0; |
| 821 | |
| 822 | /* otherwise it must match, so move on to the next one */ |
| 823 | node_a = _odictnode_NEXT(node_a); |
| 824 | node_b = _odictnode_NEXT(node_b); |
| 825 | } |
| 826 | } |
| 827 | } |
| 828 | |
| 829 | |
| 830 | /* ---------------------------------------------- |
| 831 | * OrderedDict mapping methods |
| 832 | */ |
| 833 | |
| 834 | /* mp_ass_subscript: __setitem__() and __delitem__() */ |
| 835 | |
| 836 | static int |
| 837 | odict_mp_ass_sub(PyODictObject *od, PyObject *v, PyObject *w) |
| 838 | { |
| 839 | if (w == NULL) |
| 840 | return PyODict_DelItem((PyObject *)od, v); |
| 841 | else |
| 842 | return PyODict_SetItem((PyObject *)od, v, w); |
| 843 | } |
| 844 | |
| 845 | /* tp_as_mapping */ |
| 846 | |
| 847 | static PyMappingMethods odict_as_mapping = { |
| 848 | 0, /*mp_length*/ |
| 849 | 0, /*mp_subscript*/ |
| 850 | (objobjargproc)odict_mp_ass_sub, /*mp_ass_subscript*/ |
| 851 | }; |
| 852 | |
| 853 | |
| 854 | /* ---------------------------------------------- |
| 855 | * OrderedDict methods |
| 856 | */ |
| 857 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 858 | /* fromkeys() */ |
| 859 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 860 | /*[clinic input] |
| 861 | @classmethod |
| 862 | OrderedDict.fromkeys |
| 863 | |
| 864 | iterable as seq: object |
| 865 | value: object = None |
| 866 | |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 867 | Create a new ordered dictionary with keys from iterable and values set to value. |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 868 | [clinic start generated code]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 869 | |
| 870 | static PyObject * |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 871 | OrderedDict_fromkeys_impl(PyTypeObject *type, PyObject *seq, PyObject *value) |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 872 | /*[clinic end generated code: output=c10390d452d78d6d input=1a0476c229c597b3]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 873 | { |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 874 | return _PyDict_FromKeys((PyObject *)type, seq, value); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 875 | } |
| 876 | |
| 877 | /* __sizeof__() */ |
| 878 | |
| 879 | /* OrderedDict.__sizeof__() does not have a docstring. */ |
| 880 | PyDoc_STRVAR(odict_sizeof__doc__, ""); |
| 881 | |
| 882 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 883 | odict_sizeof(PyODictObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 884 | { |
Serhiy Storchaka | 0ce7a3a | 2015-12-22 08:16:18 +0200 | [diff] [blame] | 885 | Py_ssize_t res = _PyDict_SizeOf((PyDictObject *)od); |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 886 | res += sizeof(_ODictNode *) * od->od_fast_nodes_size; /* od_fast_nodes */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 887 | if (!_odict_EMPTY(od)) { |
| 888 | res += sizeof(_ODictNode) * PyODict_SIZE(od); /* linked-list */ |
| 889 | } |
| 890 | return PyLong_FromSsize_t(res); |
| 891 | } |
| 892 | |
| 893 | /* __reduce__() */ |
| 894 | |
| 895 | PyDoc_STRVAR(odict_reduce__doc__, "Return state information for pickling"); |
| 896 | |
| 897 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 898 | odict_reduce(register PyODictObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 899 | { |
| 900 | _Py_IDENTIFIER(__dict__); |
Serhiy Storchaka | 4575beb | 2015-10-22 20:18:24 +0300 | [diff] [blame] | 901 | PyObject *dict = NULL, *result = NULL; |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 902 | PyObject *items_iter, *items, *args = NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 903 | |
| 904 | /* capture any instance state */ |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 905 | dict = _PyObject_GetAttrId((PyObject *)od, &PyId___dict__); |
| 906 | if (dict == NULL) |
Eric Snow | c5e5960 | 2015-05-30 11:28:56 -0600 | [diff] [blame] | 907 | goto Done; |
| 908 | else { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 909 | /* od.__dict__ isn't necessarily a dict... */ |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 910 | Py_ssize_t dict_len = PyObject_Length(dict); |
| 911 | if (dict_len == -1) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 912 | goto Done; |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 913 | if (!dict_len) { |
| 914 | /* nothing to pickle in od.__dict__ */ |
| 915 | Py_CLEAR(dict); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 916 | } |
| 917 | } |
| 918 | |
| 919 | /* build the result */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 920 | args = PyTuple_New(0); |
| 921 | if (args == NULL) |
| 922 | goto Done; |
| 923 | |
Jeroen Demeyer | 762f93f | 2019-07-08 10:19:25 +0200 | [diff] [blame] | 924 | items = _PyObject_CallMethodIdNoArgs((PyObject *)od, &PyId_items); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 925 | if (items == NULL) |
| 926 | goto Done; |
| 927 | |
| 928 | items_iter = PyObject_GetIter(items); |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 929 | Py_DECREF(items); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 930 | if (items_iter == NULL) |
| 931 | goto Done; |
| 932 | |
Serhiy Storchaka | 4575beb | 2015-10-22 20:18:24 +0300 | [diff] [blame] | 933 | result = PyTuple_Pack(5, Py_TYPE(od), args, dict ? dict : Py_None, Py_None, items_iter); |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 934 | Py_DECREF(items_iter); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 935 | |
| 936 | Done: |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 937 | Py_XDECREF(dict); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 938 | Py_XDECREF(args); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 939 | |
| 940 | return result; |
| 941 | } |
| 942 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 943 | /* setdefault(): Skips __missing__() calls. */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 944 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 945 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 946 | /*[clinic input] |
| 947 | OrderedDict.setdefault |
| 948 | |
| 949 | key: object |
Serhiy Storchaka | a70eaf2 | 2017-01-19 19:38:13 +0200 | [diff] [blame] | 950 | default: object = None |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 951 | |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 952 | Insert key with a value of default if key is not in the dictionary. |
| 953 | |
| 954 | Return the value for key if key is in the dictionary, else default. |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 955 | [clinic start generated code]*/ |
| 956 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 957 | static PyObject * |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 958 | OrderedDict_setdefault_impl(PyODictObject *self, PyObject *key, |
Serhiy Storchaka | a70eaf2 | 2017-01-19 19:38:13 +0200 | [diff] [blame] | 959 | PyObject *default_value) |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 960 | /*[clinic end generated code: output=97537cb7c28464b6 input=38e098381c1efbc6]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 961 | { |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 962 | PyObject *result = NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 963 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 964 | if (PyODict_CheckExact(self)) { |
| 965 | result = PyODict_GetItemWithError(self, key); /* borrowed */ |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 966 | if (result == NULL) { |
| 967 | if (PyErr_Occurred()) |
| 968 | return NULL; |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 969 | assert(_odict_find_node(self, key) == NULL); |
Serhiy Storchaka | a70eaf2 | 2017-01-19 19:38:13 +0200 | [diff] [blame] | 970 | if (PyODict_SetItem((PyObject *)self, key, default_value) >= 0) { |
| 971 | result = default_value; |
| 972 | Py_INCREF(result); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 973 | } |
| 974 | } |
| 975 | else { |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 976 | Py_INCREF(result); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 977 | } |
| 978 | } |
| 979 | else { |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 980 | int exists = PySequence_Contains((PyObject *)self, key); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 981 | if (exists < 0) { |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 982 | return NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 983 | } |
| 984 | else if (exists) { |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 985 | result = PyObject_GetItem((PyObject *)self, key); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 986 | } |
Serhiy Storchaka | a70eaf2 | 2017-01-19 19:38:13 +0200 | [diff] [blame] | 987 | else if (PyObject_SetItem((PyObject *)self, key, default_value) >= 0) { |
| 988 | result = default_value; |
| 989 | Py_INCREF(result); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 990 | } |
| 991 | } |
| 992 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 993 | return result; |
| 994 | } |
| 995 | |
| 996 | /* pop() */ |
| 997 | |
| 998 | PyDoc_STRVAR(odict_pop__doc__, |
| 999 | "od.pop(k[,d]) -> v, remove specified key and return the corresponding\n\ |
| 1000 | value. If key is not found, d is returned if given, otherwise KeyError\n\ |
| 1001 | is raised.\n\ |
| 1002 | \n\ |
| 1003 | "); |
| 1004 | |
| 1005 | /* forward */ |
| 1006 | static PyObject * _odict_popkey(PyObject *, PyObject *, PyObject *); |
| 1007 | |
| 1008 | /* Skips __missing__() calls. */ |
| 1009 | static PyObject * |
Eric Snow | ac02ef3 | 2015-06-02 20:42:14 -0600 | [diff] [blame] | 1010 | odict_pop(PyObject *od, PyObject *args, PyObject *kwargs) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1011 | { |
Eric Snow | ac02ef3 | 2015-06-02 20:42:14 -0600 | [diff] [blame] | 1012 | static char *kwlist[] = {"key", "default", 0}; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1013 | PyObject *key, *failobj = NULL; |
| 1014 | |
Eric Snow | ac02ef3 | 2015-06-02 20:42:14 -0600 | [diff] [blame] | 1015 | /* borrowed */ |
| 1016 | if (!PyArg_ParseTupleAndKeywords(args, kwargs, "O|O:pop", kwlist, |
| 1017 | &key, &failobj)) { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1018 | return NULL; |
| 1019 | } |
| 1020 | |
| 1021 | return _odict_popkey(od, key, failobj); |
| 1022 | } |
| 1023 | |
| 1024 | static PyObject * |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1025 | _odict_popkey_hash(PyObject *od, PyObject *key, PyObject *failobj, |
| 1026 | Py_hash_t hash) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1027 | { |
| 1028 | _ODictNode *node; |
| 1029 | PyObject *value = NULL; |
| 1030 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1031 | /* Pop the node first to avoid a possible dict resize (due to |
| 1032 | eval loop reentrancy) and complications due to hash collision |
| 1033 | resolution. */ |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1034 | node = _odict_find_node_hash((PyODictObject *)od, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1035 | if (node == NULL) { |
| 1036 | if (PyErr_Occurred()) |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 1037 | return NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1038 | } |
| 1039 | else { |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1040 | int res = _odict_clear_node((PyODictObject *)od, node, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1041 | if (res < 0) { |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 1042 | return NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1043 | } |
| 1044 | } |
| 1045 | |
| 1046 | /* Now delete the value from the dict. */ |
Serhiy Storchaka | 0438683 | 2016-10-30 17:17:24 +0200 | [diff] [blame] | 1047 | if (PyODict_CheckExact(od)) { |
| 1048 | if (node != NULL) { |
| 1049 | value = _PyDict_GetItem_KnownHash(od, key, hash); /* borrowed */ |
| 1050 | if (value != NULL) { |
| 1051 | Py_INCREF(value); |
| 1052 | if (_PyDict_DelItem_KnownHash(od, key, hash) < 0) { |
| 1053 | Py_DECREF(value); |
| 1054 | return NULL; |
| 1055 | } |
| 1056 | } |
| 1057 | } |
| 1058 | } |
| 1059 | else { |
| 1060 | int exists = PySequence_Contains(od, key); |
| 1061 | if (exists < 0) |
| 1062 | return NULL; |
| 1063 | if (exists) { |
| 1064 | value = PyObject_GetItem(od, key); |
| 1065 | if (value != NULL) { |
| 1066 | if (PyObject_DelItem(od, key) == -1) { |
| 1067 | Py_CLEAR(value); |
| 1068 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1069 | } |
| 1070 | } |
| 1071 | } |
| 1072 | |
| 1073 | /* Apply the fallback value, if necessary. */ |
| 1074 | if (value == NULL && !PyErr_Occurred()) { |
| 1075 | if (failobj) { |
| 1076 | value = failobj; |
| 1077 | Py_INCREF(failobj); |
| 1078 | } |
| 1079 | else { |
| 1080 | PyErr_SetObject(PyExc_KeyError, key); |
| 1081 | } |
| 1082 | } |
| 1083 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1084 | return value; |
| 1085 | } |
| 1086 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1087 | static PyObject * |
| 1088 | _odict_popkey(PyObject *od, PyObject *key, PyObject *failobj) |
| 1089 | { |
| 1090 | Py_hash_t hash = PyObject_Hash(key); |
| 1091 | if (hash == -1) |
| 1092 | return NULL; |
| 1093 | |
| 1094 | return _odict_popkey_hash(od, key, failobj, hash); |
| 1095 | } |
| 1096 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1097 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1098 | /* popitem() */ |
| 1099 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1100 | /*[clinic input] |
| 1101 | OrderedDict.popitem |
| 1102 | |
| 1103 | last: bool = True |
| 1104 | |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 1105 | Remove and return a (key, value) pair from the dictionary. |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1106 | |
| 1107 | Pairs are returned in LIFO order if last is true or FIFO order if false. |
| 1108 | [clinic start generated code]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1109 | |
| 1110 | static PyObject * |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1111 | OrderedDict_popitem_impl(PyODictObject *self, int last) |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 1112 | /*[clinic end generated code: output=98e7d986690d49eb input=d992ac5ee8305e1a]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1113 | { |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1114 | PyObject *key, *value, *item = NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1115 | _ODictNode *node; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1116 | |
| 1117 | /* pull the item */ |
| 1118 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1119 | if (_odict_EMPTY(self)) { |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1120 | PyErr_SetString(PyExc_KeyError, "dictionary is empty"); |
| 1121 | return NULL; |
Eric Snow | ac02ef3 | 2015-06-02 20:42:14 -0600 | [diff] [blame] | 1122 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1123 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1124 | node = last ? _odict_LAST(self) : _odict_FIRST(self); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1125 | key = _odictnode_KEY(node); |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 1126 | Py_INCREF(key); |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1127 | value = _odict_popkey_hash((PyObject *)self, key, NULL, _odictnode_HASH(node)); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1128 | if (value == NULL) |
| 1129 | return NULL; |
| 1130 | item = PyTuple_Pack(2, key, value); |
Eric Snow | d171975 | 2015-06-01 23:12:13 -0600 | [diff] [blame] | 1131 | Py_DECREF(key); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1132 | Py_DECREF(value); |
| 1133 | return item; |
| 1134 | } |
| 1135 | |
| 1136 | /* keys() */ |
| 1137 | |
| 1138 | /* MutableMapping.keys() does not have a docstring. */ |
| 1139 | PyDoc_STRVAR(odict_keys__doc__, ""); |
| 1140 | |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1141 | static PyObject * odictkeys_new(PyObject *od, PyObject *Py_UNUSED(ignored)); /* forward */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1142 | |
| 1143 | /* values() */ |
| 1144 | |
| 1145 | /* MutableMapping.values() does not have a docstring. */ |
| 1146 | PyDoc_STRVAR(odict_values__doc__, ""); |
| 1147 | |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1148 | static PyObject * odictvalues_new(PyObject *od, PyObject *Py_UNUSED(ignored)); /* forward */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1149 | |
| 1150 | /* items() */ |
| 1151 | |
| 1152 | /* MutableMapping.items() does not have a docstring. */ |
| 1153 | PyDoc_STRVAR(odict_items__doc__, ""); |
| 1154 | |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1155 | static PyObject * odictitems_new(PyObject *od, PyObject *Py_UNUSED(ignored)); /* forward */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1156 | |
| 1157 | /* update() */ |
| 1158 | |
| 1159 | /* MutableMapping.update() does not have a docstring. */ |
| 1160 | PyDoc_STRVAR(odict_update__doc__, ""); |
| 1161 | |
| 1162 | /* forward */ |
| 1163 | static PyObject * mutablemapping_update(PyObject *, PyObject *, PyObject *); |
| 1164 | |
| 1165 | #define odict_update mutablemapping_update |
| 1166 | |
| 1167 | /* clear() */ |
| 1168 | |
| 1169 | PyDoc_STRVAR(odict_clear__doc__, |
| 1170 | "od.clear() -> None. Remove all items from od."); |
| 1171 | |
| 1172 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1173 | odict_clear(register PyODictObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1174 | { |
| 1175 | PyDict_Clear((PyObject *)od); |
| 1176 | _odict_clear_nodes(od); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1177 | Py_RETURN_NONE; |
| 1178 | } |
| 1179 | |
| 1180 | /* copy() */ |
| 1181 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1182 | /* forward */ |
| 1183 | static int _PyODict_SetItem_KnownHash(PyObject *, PyObject *, PyObject *, |
| 1184 | Py_hash_t); |
| 1185 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1186 | PyDoc_STRVAR(odict_copy__doc__, "od.copy() -> a shallow copy of od"); |
| 1187 | |
| 1188 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1189 | odict_copy(register PyODictObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1190 | { |
| 1191 | _ODictNode *node; |
| 1192 | PyObject *od_copy; |
| 1193 | |
| 1194 | if (PyODict_CheckExact(od)) |
| 1195 | od_copy = PyODict_New(); |
| 1196 | else |
Victor Stinner | f17c3de | 2016-12-06 18:46:19 +0100 | [diff] [blame] | 1197 | od_copy = _PyObject_CallNoArg((PyObject *)Py_TYPE(od)); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1198 | if (od_copy == NULL) |
| 1199 | return NULL; |
| 1200 | |
| 1201 | if (PyODict_CheckExact(od)) { |
| 1202 | _odict_FOREACH(od, node) { |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1203 | PyObject *key = _odictnode_KEY(node); |
| 1204 | PyObject *value = _odictnode_VALUE(node, od); |
| 1205 | if (value == NULL) { |
| 1206 | if (!PyErr_Occurred()) |
| 1207 | PyErr_SetObject(PyExc_KeyError, key); |
| 1208 | goto fail; |
| 1209 | } |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1210 | if (_PyODict_SetItem_KnownHash((PyObject *)od_copy, key, value, |
| 1211 | _odictnode_HASH(node)) != 0) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1212 | goto fail; |
| 1213 | } |
| 1214 | } |
| 1215 | else { |
| 1216 | _odict_FOREACH(od, node) { |
| 1217 | int res; |
| 1218 | PyObject *value = PyObject_GetItem((PyObject *)od, |
| 1219 | _odictnode_KEY(node)); |
| 1220 | if (value == NULL) |
| 1221 | goto fail; |
| 1222 | res = PyObject_SetItem((PyObject *)od_copy, |
| 1223 | _odictnode_KEY(node), value); |
| 1224 | Py_DECREF(value); |
| 1225 | if (res != 0) |
| 1226 | goto fail; |
| 1227 | } |
| 1228 | } |
| 1229 | return od_copy; |
| 1230 | |
| 1231 | fail: |
| 1232 | Py_DECREF(od_copy); |
| 1233 | return NULL; |
| 1234 | } |
| 1235 | |
| 1236 | /* __reversed__() */ |
| 1237 | |
| 1238 | PyDoc_STRVAR(odict_reversed__doc__, "od.__reversed__() <==> reversed(od)"); |
| 1239 | |
| 1240 | #define _odict_ITER_REVERSED 1 |
| 1241 | #define _odict_ITER_KEYS 2 |
| 1242 | #define _odict_ITER_VALUES 4 |
| 1243 | |
| 1244 | /* forward */ |
| 1245 | static PyObject * odictiter_new(PyODictObject *, int); |
| 1246 | |
| 1247 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1248 | odict_reversed(PyODictObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1249 | { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1250 | return odictiter_new(od, _odict_ITER_KEYS|_odict_ITER_REVERSED); |
| 1251 | } |
| 1252 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1253 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1254 | /* move_to_end() */ |
| 1255 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1256 | /*[clinic input] |
| 1257 | OrderedDict.move_to_end |
| 1258 | |
| 1259 | key: object |
| 1260 | last: bool = True |
| 1261 | |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 1262 | Move an existing element to the end (or beginning if last is false). |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1263 | |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 1264 | Raise KeyError if the element does not exist. |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1265 | [clinic start generated code]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1266 | |
| 1267 | static PyObject * |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1268 | OrderedDict_move_to_end_impl(PyODictObject *self, PyObject *key, int last) |
Serhiy Storchaka | 78d9e58 | 2017-01-25 00:30:04 +0200 | [diff] [blame] | 1269 | /*[clinic end generated code: output=fafa4c5cc9b92f20 input=d6ceff7132a2fcd7]*/ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1270 | { |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1271 | _ODictNode *node; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1272 | |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1273 | if (_odict_EMPTY(self)) { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1274 | PyErr_SetObject(PyExc_KeyError, key); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1275 | return NULL; |
| 1276 | } |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1277 | node = last ? _odict_LAST(self) : _odict_FIRST(self); |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1278 | if (key != _odictnode_KEY(node)) { |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1279 | node = _odict_find_node(self, key); |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1280 | if (node == NULL) { |
| 1281 | if (!PyErr_Occurred()) |
| 1282 | PyErr_SetObject(PyExc_KeyError, key); |
Eric Snow | c5e5960 | 2015-05-30 11:28:56 -0600 | [diff] [blame] | 1283 | return NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1284 | } |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1285 | if (last) { |
| 1286 | /* Only move if not already the last one. */ |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1287 | if (node != _odict_LAST(self)) { |
| 1288 | _odict_remove_node(self, node); |
| 1289 | _odict_add_tail(self, node); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1290 | } |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1291 | } |
| 1292 | else { |
| 1293 | /* Only move if not already the first one. */ |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1294 | if (node != _odict_FIRST(self)) { |
| 1295 | _odict_remove_node(self, node); |
| 1296 | _odict_add_head(self, node); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1297 | } |
| 1298 | } |
| 1299 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1300 | Py_RETURN_NONE; |
| 1301 | } |
| 1302 | |
| 1303 | |
| 1304 | /* tp_methods */ |
| 1305 | |
| 1306 | static PyMethodDef odict_methods[] = { |
| 1307 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1308 | /* overridden dict methods */ |
Serhiy Storchaka | 827d49f | 2018-04-09 19:14:26 +0300 | [diff] [blame] | 1309 | ORDEREDDICT_FROMKEYS_METHODDEF |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1310 | {"__sizeof__", (PyCFunction)odict_sizeof, METH_NOARGS, |
| 1311 | odict_sizeof__doc__}, |
| 1312 | {"__reduce__", (PyCFunction)odict_reduce, METH_NOARGS, |
| 1313 | odict_reduce__doc__}, |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1314 | ORDEREDDICT_SETDEFAULT_METHODDEF |
Serhiy Storchaka | 62be742 | 2018-11-27 13:27:31 +0200 | [diff] [blame] | 1315 | {"pop", (PyCFunction)(void(*)(void))odict_pop, |
Eric Snow | ac02ef3 | 2015-06-02 20:42:14 -0600 | [diff] [blame] | 1316 | METH_VARARGS | METH_KEYWORDS, odict_pop__doc__}, |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1317 | ORDEREDDICT_POPITEM_METHODDEF |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1318 | {"keys", odictkeys_new, METH_NOARGS, |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1319 | odict_keys__doc__}, |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1320 | {"values", odictvalues_new, METH_NOARGS, |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1321 | odict_values__doc__}, |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1322 | {"items", odictitems_new, METH_NOARGS, |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1323 | odict_items__doc__}, |
Serhiy Storchaka | 62be742 | 2018-11-27 13:27:31 +0200 | [diff] [blame] | 1324 | {"update", (PyCFunction)(void(*)(void))odict_update, METH_VARARGS | METH_KEYWORDS, |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1325 | odict_update__doc__}, |
| 1326 | {"clear", (PyCFunction)odict_clear, METH_NOARGS, |
| 1327 | odict_clear__doc__}, |
| 1328 | {"copy", (PyCFunction)odict_copy, METH_NOARGS, |
| 1329 | odict_copy__doc__}, |
| 1330 | |
| 1331 | /* new methods */ |
| 1332 | {"__reversed__", (PyCFunction)odict_reversed, METH_NOARGS, |
| 1333 | odict_reversed__doc__}, |
Victor Stinner | b05cbac | 2017-01-17 03:46:13 +0100 | [diff] [blame] | 1334 | ORDEREDDICT_MOVE_TO_END_METHODDEF |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1335 | |
| 1336 | {NULL, NULL} /* sentinel */ |
| 1337 | }; |
| 1338 | |
| 1339 | |
| 1340 | /* ---------------------------------------------- |
| 1341 | * OrderedDict members |
| 1342 | */ |
| 1343 | |
Serhiy Storchaka | d2962f1 | 2016-02-08 16:39:05 +0200 | [diff] [blame] | 1344 | /* tp_getset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1345 | |
Serhiy Storchaka | d2962f1 | 2016-02-08 16:39:05 +0200 | [diff] [blame] | 1346 | static PyGetSetDef odict_getset[] = { |
| 1347 | {"__dict__", PyObject_GenericGetDict, PyObject_GenericSetDict}, |
| 1348 | {NULL} |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1349 | }; |
| 1350 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1351 | /* ---------------------------------------------- |
| 1352 | * OrderedDict type slot methods |
| 1353 | */ |
| 1354 | |
| 1355 | /* tp_dealloc */ |
| 1356 | |
| 1357 | static void |
| 1358 | odict_dealloc(PyODictObject *self) |
| 1359 | { |
| 1360 | PyObject_GC_UnTrack(self); |
Jeroen Demeyer | 351c674 | 2019-05-10 19:21:11 +0200 | [diff] [blame] | 1361 | Py_TRASHCAN_BEGIN(self, odict_dealloc) |
Serhiy Storchaka | 14eefe3 | 2015-11-01 16:12:34 +0200 | [diff] [blame] | 1362 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1363 | Py_XDECREF(self->od_inst_dict); |
| 1364 | if (self->od_weakreflist != NULL) |
| 1365 | PyObject_ClearWeakRefs((PyObject *)self); |
| 1366 | |
| 1367 | _odict_clear_nodes(self); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1368 | PyDict_Type.tp_dealloc((PyObject *)self); |
Serhiy Storchaka | 14eefe3 | 2015-11-01 16:12:34 +0200 | [diff] [blame] | 1369 | |
Jeroen Demeyer | 351c674 | 2019-05-10 19:21:11 +0200 | [diff] [blame] | 1370 | Py_TRASHCAN_END |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1371 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1372 | |
| 1373 | /* tp_repr */ |
| 1374 | |
| 1375 | static PyObject * |
| 1376 | odict_repr(PyODictObject *self) |
| 1377 | { |
| 1378 | int i; |
Serhiy Storchaka | 4575beb | 2015-10-22 20:18:24 +0300 | [diff] [blame] | 1379 | PyObject *pieces = NULL, *result = NULL; |
Serhiy Storchaka | 4575beb | 2015-10-22 20:18:24 +0300 | [diff] [blame] | 1380 | |
| 1381 | if (PyODict_SIZE(self) == 0) |
Serhiy Storchaka | 4ab46d7 | 2017-09-17 21:11:04 +0300 | [diff] [blame] | 1382 | return PyUnicode_FromFormat("%s()", _PyType_Name(Py_TYPE(self))); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1383 | |
| 1384 | i = Py_ReprEnter((PyObject *)self); |
| 1385 | if (i != 0) { |
| 1386 | return i > 0 ? PyUnicode_FromString("...") : NULL; |
| 1387 | } |
| 1388 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1389 | if (PyODict_CheckExact(self)) { |
Serhiy Storchaka | 710cd34 | 2015-11-04 22:33:07 +0200 | [diff] [blame] | 1390 | Py_ssize_t count = 0; |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1391 | _ODictNode *node; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1392 | pieces = PyList_New(PyODict_SIZE(self)); |
| 1393 | if (pieces == NULL) |
| 1394 | goto Done; |
| 1395 | |
| 1396 | _odict_FOREACH(self, node) { |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1397 | PyObject *pair; |
| 1398 | PyObject *key = _odictnode_KEY(node); |
| 1399 | PyObject *value = _odictnode_VALUE(node, self); |
| 1400 | if (value == NULL) { |
| 1401 | if (!PyErr_Occurred()) |
| 1402 | PyErr_SetObject(PyExc_KeyError, key); |
Eric Snow | db4061c | 2015-06-03 11:09:48 -0600 | [diff] [blame] | 1403 | goto Done; |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1404 | } |
| 1405 | pair = PyTuple_Pack(2, key, value); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1406 | if (pair == NULL) |
| 1407 | goto Done; |
| 1408 | |
Serhiy Storchaka | 710cd34 | 2015-11-04 22:33:07 +0200 | [diff] [blame] | 1409 | if (count < PyList_GET_SIZE(pieces)) |
| 1410 | PyList_SET_ITEM(pieces, count, pair); /* steals reference */ |
| 1411 | else { |
| 1412 | if (PyList_Append(pieces, pair) < 0) { |
| 1413 | Py_DECREF(pair); |
| 1414 | goto Done; |
| 1415 | } |
| 1416 | Py_DECREF(pair); |
| 1417 | } |
| 1418 | count++; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1419 | } |
Victor Stinner | 60ac6ed | 2020-02-07 23:18:08 +0100 | [diff] [blame^] | 1420 | if (count < PyList_GET_SIZE(pieces)) { |
| 1421 | Py_SET_SIZE(pieces, count); |
| 1422 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1423 | } |
| 1424 | else { |
Jeroen Demeyer | 762f93f | 2019-07-08 10:19:25 +0200 | [diff] [blame] | 1425 | PyObject *items = _PyObject_CallMethodIdNoArgs((PyObject *)self, |
| 1426 | &PyId_items); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1427 | if (items == NULL) |
| 1428 | goto Done; |
| 1429 | pieces = PySequence_List(items); |
| 1430 | Py_DECREF(items); |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 1431 | if (pieces == NULL) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1432 | goto Done; |
| 1433 | } |
| 1434 | |
Serhiy Storchaka | 4ab46d7 | 2017-09-17 21:11:04 +0300 | [diff] [blame] | 1435 | result = PyUnicode_FromFormat("%s(%R)", |
| 1436 | _PyType_Name(Py_TYPE(self)), pieces); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1437 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1438 | Done: |
| 1439 | Py_XDECREF(pieces); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1440 | Py_ReprLeave((PyObject *)self); |
| 1441 | return result; |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1442 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1443 | |
| 1444 | /* tp_doc */ |
| 1445 | |
| 1446 | PyDoc_STRVAR(odict_doc, |
| 1447 | "Dictionary that remembers insertion order"); |
| 1448 | |
| 1449 | /* tp_traverse */ |
| 1450 | |
| 1451 | static int |
| 1452 | odict_traverse(PyODictObject *od, visitproc visit, void *arg) |
| 1453 | { |
Serhiy Storchaka | d205d01 | 2016-01-19 14:46:25 +0200 | [diff] [blame] | 1454 | _ODictNode *node; |
| 1455 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1456 | Py_VISIT(od->od_inst_dict); |
| 1457 | Py_VISIT(od->od_weakreflist); |
Serhiy Storchaka | d205d01 | 2016-01-19 14:46:25 +0200 | [diff] [blame] | 1458 | _odict_FOREACH(od, node) { |
| 1459 | Py_VISIT(_odictnode_KEY(node)); |
| 1460 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1461 | return PyDict_Type.tp_traverse((PyObject *)od, visit, arg); |
| 1462 | } |
| 1463 | |
| 1464 | /* tp_clear */ |
| 1465 | |
| 1466 | static int |
| 1467 | odict_tp_clear(PyODictObject *od) |
| 1468 | { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1469 | Py_CLEAR(od->od_inst_dict); |
| 1470 | Py_CLEAR(od->od_weakreflist); |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 1471 | PyDict_Clear((PyObject *)od); |
| 1472 | _odict_clear_nodes(od); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1473 | return 0; |
| 1474 | } |
| 1475 | |
| 1476 | /* tp_richcompare */ |
| 1477 | |
| 1478 | static PyObject * |
| 1479 | odict_richcompare(PyObject *v, PyObject *w, int op) |
| 1480 | { |
| 1481 | if (!PyODict_Check(v) || !PyDict_Check(w)) { |
| 1482 | Py_RETURN_NOTIMPLEMENTED; |
| 1483 | } |
| 1484 | |
| 1485 | if (op == Py_EQ || op == Py_NE) { |
| 1486 | PyObject *res, *cmp; |
| 1487 | int eq; |
| 1488 | |
| 1489 | cmp = PyDict_Type.tp_richcompare(v, w, op); |
| 1490 | if (cmp == NULL) |
| 1491 | return NULL; |
| 1492 | if (!PyODict_Check(w)) |
| 1493 | return cmp; |
| 1494 | if (op == Py_EQ && cmp == Py_False) |
| 1495 | return cmp; |
| 1496 | if (op == Py_NE && cmp == Py_True) |
| 1497 | return cmp; |
| 1498 | Py_DECREF(cmp); |
| 1499 | |
| 1500 | /* Try comparing odict keys. */ |
| 1501 | eq = _odict_keys_equal((PyODictObject *)v, (PyODictObject *)w); |
| 1502 | if (eq < 0) |
| 1503 | return NULL; |
| 1504 | |
| 1505 | res = (eq == (op == Py_EQ)) ? Py_True : Py_False; |
| 1506 | Py_INCREF(res); |
| 1507 | return res; |
| 1508 | } else { |
| 1509 | Py_RETURN_NOTIMPLEMENTED; |
| 1510 | } |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1511 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1512 | |
| 1513 | /* tp_iter */ |
| 1514 | |
| 1515 | static PyObject * |
| 1516 | odict_iter(PyODictObject *od) |
| 1517 | { |
| 1518 | return odictiter_new(od, _odict_ITER_KEYS); |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1519 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1520 | |
| 1521 | /* tp_init */ |
| 1522 | |
| 1523 | static int |
| 1524 | odict_init(PyObject *self, PyObject *args, PyObject *kwds) |
| 1525 | { |
| 1526 | PyObject *res; |
| 1527 | Py_ssize_t len = PyObject_Length(args); |
| 1528 | |
| 1529 | if (len == -1) |
| 1530 | return -1; |
| 1531 | if (len > 1) { |
Serhiy Storchaka | d53fe5f | 2019-03-13 22:59:55 +0200 | [diff] [blame] | 1532 | const char *msg = "expected at most 1 arguments, got %zd"; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1533 | PyErr_Format(PyExc_TypeError, msg, len); |
| 1534 | return -1; |
| 1535 | } |
| 1536 | |
| 1537 | /* __init__() triggering update() is just the way things are! */ |
| 1538 | res = odict_update(self, args, kwds); |
| 1539 | if (res == NULL) { |
| 1540 | return -1; |
| 1541 | } else { |
| 1542 | Py_DECREF(res); |
| 1543 | return 0; |
| 1544 | } |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1545 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1546 | |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1547 | /* PyODict_Type */ |
| 1548 | |
| 1549 | PyTypeObject PyODict_Type = { |
| 1550 | PyVarObject_HEAD_INIT(&PyType_Type, 0) |
| 1551 | "collections.OrderedDict", /* tp_name */ |
| 1552 | sizeof(PyODictObject), /* tp_basicsize */ |
| 1553 | 0, /* tp_itemsize */ |
| 1554 | (destructor)odict_dealloc, /* tp_dealloc */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1555 | 0, /* tp_vectorcall_offset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1556 | 0, /* tp_getattr */ |
| 1557 | 0, /* tp_setattr */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1558 | 0, /* tp_as_async */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1559 | (reprfunc)odict_repr, /* tp_repr */ |
| 1560 | 0, /* tp_as_number */ |
| 1561 | 0, /* tp_as_sequence */ |
| 1562 | &odict_as_mapping, /* tp_as_mapping */ |
| 1563 | 0, /* tp_hash */ |
| 1564 | 0, /* tp_call */ |
| 1565 | 0, /* tp_str */ |
| 1566 | 0, /* tp_getattro */ |
| 1567 | 0, /* tp_setattro */ |
| 1568 | 0, /* tp_as_buffer */ |
| 1569 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC,/* tp_flags */ |
| 1570 | odict_doc, /* tp_doc */ |
| 1571 | (traverseproc)odict_traverse, /* tp_traverse */ |
| 1572 | (inquiry)odict_tp_clear, /* tp_clear */ |
| 1573 | (richcmpfunc)odict_richcompare, /* tp_richcompare */ |
| 1574 | offsetof(PyODictObject, od_weakreflist), /* tp_weaklistoffset */ |
| 1575 | (getiterfunc)odict_iter, /* tp_iter */ |
| 1576 | 0, /* tp_iternext */ |
| 1577 | odict_methods, /* tp_methods */ |
Serhiy Storchaka | d2962f1 | 2016-02-08 16:39:05 +0200 | [diff] [blame] | 1578 | 0, /* tp_members */ |
| 1579 | odict_getset, /* tp_getset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1580 | &PyDict_Type, /* tp_base */ |
| 1581 | 0, /* tp_dict */ |
| 1582 | 0, /* tp_descr_get */ |
| 1583 | 0, /* tp_descr_set */ |
| 1584 | offsetof(PyODictObject, od_inst_dict), /* tp_dictoffset */ |
| 1585 | (initproc)odict_init, /* tp_init */ |
| 1586 | PyType_GenericAlloc, /* tp_alloc */ |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 1587 | 0, /* tp_new */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1588 | 0, /* tp_free */ |
| 1589 | }; |
| 1590 | |
| 1591 | |
| 1592 | /* ---------------------------------------------- |
| 1593 | * the public OrderedDict API |
| 1594 | */ |
| 1595 | |
| 1596 | PyObject * |
Serhiy Storchaka | 6f17e51 | 2018-10-20 02:27:45 +0300 | [diff] [blame] | 1597 | PyODict_New(void) |
| 1598 | { |
| 1599 | return PyDict_Type.tp_new(&PyODict_Type, NULL, NULL); |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1600 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1601 | |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1602 | static int |
| 1603 | _PyODict_SetItem_KnownHash(PyObject *od, PyObject *key, PyObject *value, |
| 1604 | Py_hash_t hash) |
| 1605 | { |
| 1606 | int res = _PyDict_SetItem_KnownHash(od, key, value, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1607 | if (res == 0) { |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1608 | res = _odict_add_new_node((PyODictObject *)od, key, hash); |
Serhiy Storchaka | d5f353e | 2015-11-06 11:07:11 +0200 | [diff] [blame] | 1609 | if (res < 0) { |
| 1610 | /* Revert setting the value on the dict */ |
| 1611 | PyObject *exc, *val, *tb; |
| 1612 | PyErr_Fetch(&exc, &val, &tb); |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1613 | (void) _PyDict_DelItem_KnownHash(od, key, hash); |
Serhiy Storchaka | d5f353e | 2015-11-06 11:07:11 +0200 | [diff] [blame] | 1614 | _PyErr_ChainExceptions(exc, val, tb); |
| 1615 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1616 | } |
| 1617 | return res; |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1618 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1619 | |
| 1620 | int |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1621 | PyODict_SetItem(PyObject *od, PyObject *key, PyObject *value) |
| 1622 | { |
| 1623 | Py_hash_t hash = PyObject_Hash(key); |
| 1624 | if (hash == -1) |
| 1625 | return -1; |
| 1626 | return _PyODict_SetItem_KnownHash(od, key, value, hash); |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1627 | } |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1628 | |
| 1629 | int |
| 1630 | PyODict_DelItem(PyObject *od, PyObject *key) |
| 1631 | { |
| 1632 | int res; |
| 1633 | Py_hash_t hash = PyObject_Hash(key); |
| 1634 | if (hash == -1) |
| 1635 | return -1; |
| 1636 | res = _odict_clear_node((PyODictObject *)od, NULL, key, hash); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1637 | if (res < 0) |
| 1638 | return -1; |
Serhiy Storchaka | 19a70e7 | 2015-11-13 14:48:36 +0200 | [diff] [blame] | 1639 | return _PyDict_DelItem_KnownHash(od, key, hash); |
Victor Stinner | e187195 | 2016-06-08 10:18:18 +0200 | [diff] [blame] | 1640 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1641 | |
| 1642 | |
| 1643 | /* ------------------------------------------- |
| 1644 | * The OrderedDict views (keys/values/items) |
| 1645 | */ |
| 1646 | |
| 1647 | typedef struct { |
| 1648 | PyObject_HEAD |
| 1649 | int kind; |
| 1650 | PyODictObject *di_odict; |
Eric Snow | b952ab4 | 2015-06-01 23:35:13 -0600 | [diff] [blame] | 1651 | Py_ssize_t di_size; |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 1652 | size_t di_state; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1653 | PyObject *di_current; |
| 1654 | PyObject *di_result; /* reusable result tuple for iteritems */ |
| 1655 | } odictiterobject; |
| 1656 | |
| 1657 | static void |
| 1658 | odictiter_dealloc(odictiterobject *di) |
| 1659 | { |
| 1660 | _PyObject_GC_UNTRACK(di); |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1661 | Py_XDECREF(di->di_odict); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1662 | Py_XDECREF(di->di_current); |
| 1663 | if (di->kind & (_odict_ITER_KEYS | _odict_ITER_VALUES)) { |
| 1664 | Py_DECREF(di->di_result); |
| 1665 | } |
| 1666 | PyObject_GC_Del(di); |
| 1667 | } |
| 1668 | |
| 1669 | static int |
| 1670 | odictiter_traverse(odictiterobject *di, visitproc visit, void *arg) |
| 1671 | { |
| 1672 | Py_VISIT(di->di_odict); |
| 1673 | Py_VISIT(di->di_current); /* A key could be any type, not just str. */ |
| 1674 | Py_VISIT(di->di_result); |
| 1675 | return 0; |
| 1676 | } |
| 1677 | |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1678 | /* In order to protect against modifications during iteration, we track |
| 1679 | * the current key instead of the current node. */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1680 | static PyObject * |
| 1681 | odictiter_nextkey(odictiterobject *di) |
| 1682 | { |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1683 | PyObject *key = NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1684 | _ODictNode *node; |
| 1685 | int reversed = di->kind & _odict_ITER_REVERSED; |
| 1686 | |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1687 | if (di->di_odict == NULL) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1688 | return NULL; |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1689 | if (di->di_current == NULL) |
| 1690 | goto done; /* We're already done. */ |
| 1691 | |
Eric Snow | b952ab4 | 2015-06-01 23:35:13 -0600 | [diff] [blame] | 1692 | /* Check for unsupported changes. */ |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 1693 | if (di->di_odict->od_state != di->di_state) { |
| 1694 | PyErr_SetString(PyExc_RuntimeError, |
| 1695 | "OrderedDict mutated during iteration"); |
| 1696 | goto done; |
| 1697 | } |
Eric Snow | b952ab4 | 2015-06-01 23:35:13 -0600 | [diff] [blame] | 1698 | if (di->di_size != PyODict_SIZE(di->di_odict)) { |
| 1699 | PyErr_SetString(PyExc_RuntimeError, |
| 1700 | "OrderedDict changed size during iteration"); |
| 1701 | di->di_size = -1; /* Make this state sticky */ |
| 1702 | return NULL; |
| 1703 | } |
| 1704 | |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1705 | /* Get the key. */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1706 | node = _odict_find_node(di->di_odict, di->di_current); |
| 1707 | if (node == NULL) { |
Serhiy Storchaka | b45b7b2 | 2015-11-04 22:05:38 +0200 | [diff] [blame] | 1708 | if (!PyErr_Occurred()) |
| 1709 | PyErr_SetObject(PyExc_KeyError, di->di_current); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1710 | /* Must have been deleted. */ |
Eric Snow | e3dfa9e | 2015-05-30 12:51:15 -0600 | [diff] [blame] | 1711 | Py_CLEAR(di->di_current); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1712 | return NULL; |
| 1713 | } |
| 1714 | key = di->di_current; |
| 1715 | |
| 1716 | /* Advance to the next key. */ |
| 1717 | node = reversed ? _odictnode_PREV(node) : _odictnode_NEXT(node); |
| 1718 | if (node == NULL) { |
| 1719 | /* Reached the end. */ |
| 1720 | di->di_current = NULL; |
| 1721 | } |
| 1722 | else { |
| 1723 | di->di_current = _odictnode_KEY(node); |
| 1724 | Py_INCREF(di->di_current); |
| 1725 | } |
| 1726 | |
| 1727 | return key; |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1728 | |
| 1729 | done: |
| 1730 | Py_CLEAR(di->di_odict); |
| 1731 | return key; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1732 | } |
| 1733 | |
| 1734 | static PyObject * |
| 1735 | odictiter_iternext(odictiterobject *di) |
| 1736 | { |
Serhiy Storchaka | 9c96761 | 2015-11-06 10:39:51 +0200 | [diff] [blame] | 1737 | PyObject *result, *value; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1738 | PyObject *key = odictiter_nextkey(di); /* new reference */ |
| 1739 | |
| 1740 | if (key == NULL) |
| 1741 | return NULL; |
| 1742 | |
| 1743 | /* Handle the keys case. */ |
| 1744 | if (! (di->kind & _odict_ITER_VALUES)) { |
| 1745 | return key; |
| 1746 | } |
| 1747 | |
Serhiy Storchaka | 9c96761 | 2015-11-06 10:39:51 +0200 | [diff] [blame] | 1748 | value = PyODict_GetItem((PyObject *)di->di_odict, key); /* borrowed */ |
| 1749 | if (value == NULL) { |
| 1750 | if (!PyErr_Occurred()) |
| 1751 | PyErr_SetObject(PyExc_KeyError, key); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1752 | Py_DECREF(key); |
Serhiy Storchaka | 9c96761 | 2015-11-06 10:39:51 +0200 | [diff] [blame] | 1753 | goto done; |
| 1754 | } |
| 1755 | Py_INCREF(value); |
| 1756 | |
| 1757 | /* Handle the values case. */ |
| 1758 | if (!(di->kind & _odict_ITER_KEYS)) { |
| 1759 | Py_DECREF(key); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1760 | return value; |
| 1761 | } |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1762 | |
Serhiy Storchaka | 9c96761 | 2015-11-06 10:39:51 +0200 | [diff] [blame] | 1763 | /* Handle the items case. */ |
| 1764 | result = di->di_result; |
| 1765 | |
| 1766 | if (Py_REFCNT(result) == 1) { |
| 1767 | /* not in use so we can reuse it |
| 1768 | * (the common case during iteration) */ |
| 1769 | Py_INCREF(result); |
| 1770 | Py_DECREF(PyTuple_GET_ITEM(result, 0)); /* borrowed */ |
| 1771 | Py_DECREF(PyTuple_GET_ITEM(result, 1)); /* borrowed */ |
| 1772 | } |
| 1773 | else { |
| 1774 | result = PyTuple_New(2); |
| 1775 | if (result == NULL) { |
| 1776 | Py_DECREF(key); |
| 1777 | Py_DECREF(value); |
| 1778 | goto done; |
| 1779 | } |
| 1780 | } |
| 1781 | |
| 1782 | PyTuple_SET_ITEM(result, 0, key); /* steals reference */ |
| 1783 | PyTuple_SET_ITEM(result, 1, value); /* steals reference */ |
| 1784 | return result; |
| 1785 | |
Eric Snow | a762af7 | 2015-06-01 22:59:08 -0600 | [diff] [blame] | 1786 | done: |
| 1787 | Py_CLEAR(di->di_current); |
| 1788 | Py_CLEAR(di->di_odict); |
| 1789 | return NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1790 | } |
| 1791 | |
| 1792 | /* No need for tp_clear because odictiterobject is not mutable. */ |
| 1793 | |
| 1794 | PyDoc_STRVAR(reduce_doc, "Return state information for pickling"); |
| 1795 | |
| 1796 | static PyObject * |
Serhiy Storchaka | 8152402 | 2018-11-27 13:05:02 +0200 | [diff] [blame] | 1797 | odictiter_reduce(odictiterobject *di, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1798 | { |
Serhiy Storchaka | bb86bf4 | 2018-12-11 08:28:18 +0200 | [diff] [blame] | 1799 | _Py_IDENTIFIER(iter); |
Sergey Fedoseev | a5259fb | 2018-10-20 10:20:39 +0500 | [diff] [blame] | 1800 | /* copy the iterator state */ |
| 1801 | odictiterobject tmp = *di; |
| 1802 | Py_XINCREF(tmp.di_odict); |
| 1803 | Py_XINCREF(tmp.di_current); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1804 | |
| 1805 | /* iterate the temporary into a list */ |
Sergey Fedoseev | a5259fb | 2018-10-20 10:20:39 +0500 | [diff] [blame] | 1806 | PyObject *list = PySequence_List((PyObject*)&tmp); |
| 1807 | Py_XDECREF(tmp.di_odict); |
| 1808 | Py_XDECREF(tmp.di_current); |
| 1809 | if (list == NULL) { |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1810 | return NULL; |
| 1811 | } |
Serhiy Storchaka | bb86bf4 | 2018-12-11 08:28:18 +0200 | [diff] [blame] | 1812 | return Py_BuildValue("N(N)", _PyEval_GetBuiltinId(&PyId_iter), list); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1813 | } |
| 1814 | |
| 1815 | static PyMethodDef odictiter_methods[] = { |
| 1816 | {"__reduce__", (PyCFunction)odictiter_reduce, METH_NOARGS, reduce_doc}, |
| 1817 | {NULL, NULL} /* sentinel */ |
| 1818 | }; |
| 1819 | |
| 1820 | PyTypeObject PyODictIter_Type = { |
| 1821 | PyVarObject_HEAD_INIT(&PyType_Type, 0) |
| 1822 | "odict_iterator", /* tp_name */ |
| 1823 | sizeof(odictiterobject), /* tp_basicsize */ |
| 1824 | 0, /* tp_itemsize */ |
| 1825 | /* methods */ |
| 1826 | (destructor)odictiter_dealloc, /* tp_dealloc */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1827 | 0, /* tp_vectorcall_offset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1828 | 0, /* tp_getattr */ |
| 1829 | 0, /* tp_setattr */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1830 | 0, /* tp_as_async */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1831 | 0, /* tp_repr */ |
| 1832 | 0, /* tp_as_number */ |
| 1833 | 0, /* tp_as_sequence */ |
| 1834 | 0, /* tp_as_mapping */ |
| 1835 | 0, /* tp_hash */ |
| 1836 | 0, /* tp_call */ |
| 1837 | 0, /* tp_str */ |
| 1838 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 1839 | 0, /* tp_setattro */ |
| 1840 | 0, /* tp_as_buffer */ |
| 1841 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC, /* tp_flags */ |
| 1842 | 0, /* tp_doc */ |
| 1843 | (traverseproc)odictiter_traverse, /* tp_traverse */ |
| 1844 | 0, /* tp_clear */ |
| 1845 | 0, /* tp_richcompare */ |
| 1846 | 0, /* tp_weaklistoffset */ |
| 1847 | PyObject_SelfIter, /* tp_iter */ |
| 1848 | (iternextfunc)odictiter_iternext, /* tp_iternext */ |
| 1849 | odictiter_methods, /* tp_methods */ |
| 1850 | 0, |
| 1851 | }; |
| 1852 | |
| 1853 | static PyObject * |
| 1854 | odictiter_new(PyODictObject *od, int kind) |
| 1855 | { |
| 1856 | odictiterobject *di; |
| 1857 | _ODictNode *node; |
| 1858 | int reversed = kind & _odict_ITER_REVERSED; |
| 1859 | |
| 1860 | di = PyObject_GC_New(odictiterobject, &PyODictIter_Type); |
| 1861 | if (di == NULL) |
| 1862 | return NULL; |
| 1863 | |
| 1864 | if (kind & (_odict_ITER_KEYS | _odict_ITER_VALUES)){ |
| 1865 | di->di_result = PyTuple_Pack(2, Py_None, Py_None); |
| 1866 | if (di->di_result == NULL) { |
| 1867 | Py_DECREF(di); |
| 1868 | return NULL; |
| 1869 | } |
| 1870 | } |
| 1871 | else |
| 1872 | di->di_result = NULL; |
| 1873 | |
| 1874 | di->kind = kind; |
| 1875 | node = reversed ? _odict_LAST(od) : _odict_FIRST(od); |
| 1876 | di->di_current = node ? _odictnode_KEY(node) : NULL; |
| 1877 | Py_XINCREF(di->di_current); |
Eric Snow | b952ab4 | 2015-06-01 23:35:13 -0600 | [diff] [blame] | 1878 | di->di_size = PyODict_SIZE(od); |
Eric Snow | 4fabf02 | 2015-06-04 00:09:56 -0600 | [diff] [blame] | 1879 | di->di_state = od->od_state; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1880 | di->di_odict = od; |
| 1881 | Py_INCREF(od); |
| 1882 | |
| 1883 | _PyObject_GC_TRACK(di); |
| 1884 | return (PyObject *)di; |
| 1885 | } |
| 1886 | |
| 1887 | /* keys() */ |
| 1888 | |
| 1889 | static PyObject * |
| 1890 | odictkeys_iter(_PyDictViewObject *dv) |
| 1891 | { |
| 1892 | if (dv->dv_dict == NULL) { |
| 1893 | Py_RETURN_NONE; |
| 1894 | } |
| 1895 | return odictiter_new((PyODictObject *)dv->dv_dict, |
| 1896 | _odict_ITER_KEYS); |
| 1897 | } |
| 1898 | |
| 1899 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1900 | odictkeys_reversed(_PyDictViewObject *dv, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1901 | { |
| 1902 | if (dv->dv_dict == NULL) { |
| 1903 | Py_RETURN_NONE; |
| 1904 | } |
| 1905 | return odictiter_new((PyODictObject *)dv->dv_dict, |
| 1906 | _odict_ITER_KEYS|_odict_ITER_REVERSED); |
| 1907 | } |
| 1908 | |
| 1909 | static PyMethodDef odictkeys_methods[] = { |
| 1910 | {"__reversed__", (PyCFunction)odictkeys_reversed, METH_NOARGS, NULL}, |
| 1911 | {NULL, NULL} /* sentinel */ |
| 1912 | }; |
| 1913 | |
| 1914 | PyTypeObject PyODictKeys_Type = { |
| 1915 | PyVarObject_HEAD_INIT(&PyType_Type, 0) |
| 1916 | "odict_keys", /* tp_name */ |
| 1917 | 0, /* tp_basicsize */ |
| 1918 | 0, /* tp_itemsize */ |
| 1919 | 0, /* tp_dealloc */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1920 | 0, /* tp_vectorcall_offset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1921 | 0, /* tp_getattr */ |
| 1922 | 0, /* tp_setattr */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1923 | 0, /* tp_as_async */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1924 | 0, /* tp_repr */ |
| 1925 | 0, /* tp_as_number */ |
| 1926 | 0, /* tp_as_sequence */ |
| 1927 | 0, /* tp_as_mapping */ |
| 1928 | 0, /* tp_hash */ |
| 1929 | 0, /* tp_call */ |
| 1930 | 0, /* tp_str */ |
| 1931 | 0, /* tp_getattro */ |
| 1932 | 0, /* tp_setattro */ |
| 1933 | 0, /* tp_as_buffer */ |
| 1934 | 0, /* tp_flags */ |
| 1935 | 0, /* tp_doc */ |
| 1936 | 0, /* tp_traverse */ |
| 1937 | 0, /* tp_clear */ |
| 1938 | 0, /* tp_richcompare */ |
| 1939 | 0, /* tp_weaklistoffset */ |
| 1940 | (getiterfunc)odictkeys_iter, /* tp_iter */ |
| 1941 | 0, /* tp_iternext */ |
| 1942 | odictkeys_methods, /* tp_methods */ |
| 1943 | 0, /* tp_members */ |
| 1944 | 0, /* tp_getset */ |
| 1945 | &PyDictKeys_Type, /* tp_base */ |
| 1946 | }; |
| 1947 | |
| 1948 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1949 | odictkeys_new(PyObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1950 | { |
| 1951 | return _PyDictView_New(od, &PyODictKeys_Type); |
| 1952 | } |
| 1953 | |
| 1954 | /* items() */ |
| 1955 | |
| 1956 | static PyObject * |
| 1957 | odictitems_iter(_PyDictViewObject *dv) |
| 1958 | { |
| 1959 | if (dv->dv_dict == NULL) { |
| 1960 | Py_RETURN_NONE; |
| 1961 | } |
| 1962 | return odictiter_new((PyODictObject *)dv->dv_dict, |
| 1963 | _odict_ITER_KEYS|_odict_ITER_VALUES); |
| 1964 | } |
| 1965 | |
| 1966 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 1967 | odictitems_reversed(_PyDictViewObject *dv, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1968 | { |
| 1969 | if (dv->dv_dict == NULL) { |
| 1970 | Py_RETURN_NONE; |
| 1971 | } |
| 1972 | return odictiter_new((PyODictObject *)dv->dv_dict, |
| 1973 | _odict_ITER_KEYS|_odict_ITER_VALUES|_odict_ITER_REVERSED); |
| 1974 | } |
| 1975 | |
| 1976 | static PyMethodDef odictitems_methods[] = { |
| 1977 | {"__reversed__", (PyCFunction)odictitems_reversed, METH_NOARGS, NULL}, |
| 1978 | {NULL, NULL} /* sentinel */ |
| 1979 | }; |
| 1980 | |
| 1981 | PyTypeObject PyODictItems_Type = { |
| 1982 | PyVarObject_HEAD_INIT(&PyType_Type, 0) |
| 1983 | "odict_items", /* tp_name */ |
| 1984 | 0, /* tp_basicsize */ |
| 1985 | 0, /* tp_itemsize */ |
| 1986 | 0, /* tp_dealloc */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1987 | 0, /* tp_vectorcall_offset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1988 | 0, /* tp_getattr */ |
| 1989 | 0, /* tp_setattr */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1990 | 0, /* tp_as_async */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 1991 | 0, /* tp_repr */ |
| 1992 | 0, /* tp_as_number */ |
| 1993 | 0, /* tp_as_sequence */ |
| 1994 | 0, /* tp_as_mapping */ |
| 1995 | 0, /* tp_hash */ |
| 1996 | 0, /* tp_call */ |
| 1997 | 0, /* tp_str */ |
| 1998 | 0, /* tp_getattro */ |
| 1999 | 0, /* tp_setattro */ |
| 2000 | 0, /* tp_as_buffer */ |
| 2001 | 0, /* tp_flags */ |
| 2002 | 0, /* tp_doc */ |
| 2003 | 0, /* tp_traverse */ |
| 2004 | 0, /* tp_clear */ |
| 2005 | 0, /* tp_richcompare */ |
| 2006 | 0, /* tp_weaklistoffset */ |
| 2007 | (getiterfunc)odictitems_iter, /* tp_iter */ |
| 2008 | 0, /* tp_iternext */ |
| 2009 | odictitems_methods, /* tp_methods */ |
| 2010 | 0, /* tp_members */ |
| 2011 | 0, /* tp_getset */ |
| 2012 | &PyDictItems_Type, /* tp_base */ |
| 2013 | }; |
| 2014 | |
| 2015 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 2016 | odictitems_new(PyObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2017 | { |
| 2018 | return _PyDictView_New(od, &PyODictItems_Type); |
| 2019 | } |
| 2020 | |
| 2021 | /* values() */ |
| 2022 | |
| 2023 | static PyObject * |
| 2024 | odictvalues_iter(_PyDictViewObject *dv) |
| 2025 | { |
| 2026 | if (dv->dv_dict == NULL) { |
| 2027 | Py_RETURN_NONE; |
| 2028 | } |
| 2029 | return odictiter_new((PyODictObject *)dv->dv_dict, |
| 2030 | _odict_ITER_VALUES); |
| 2031 | } |
| 2032 | |
| 2033 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 2034 | odictvalues_reversed(_PyDictViewObject *dv, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2035 | { |
| 2036 | if (dv->dv_dict == NULL) { |
| 2037 | Py_RETURN_NONE; |
| 2038 | } |
| 2039 | return odictiter_new((PyODictObject *)dv->dv_dict, |
| 2040 | _odict_ITER_VALUES|_odict_ITER_REVERSED); |
| 2041 | } |
| 2042 | |
| 2043 | static PyMethodDef odictvalues_methods[] = { |
| 2044 | {"__reversed__", (PyCFunction)odictvalues_reversed, METH_NOARGS, NULL}, |
| 2045 | {NULL, NULL} /* sentinel */ |
| 2046 | }; |
| 2047 | |
| 2048 | PyTypeObject PyODictValues_Type = { |
| 2049 | PyVarObject_HEAD_INIT(&PyType_Type, 0) |
| 2050 | "odict_values", /* tp_name */ |
| 2051 | 0, /* tp_basicsize */ |
| 2052 | 0, /* tp_itemsize */ |
| 2053 | 0, /* tp_dealloc */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 2054 | 0, /* tp_vectorcall_offset */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2055 | 0, /* tp_getattr */ |
| 2056 | 0, /* tp_setattr */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 2057 | 0, /* tp_as_async */ |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2058 | 0, /* tp_repr */ |
| 2059 | 0, /* tp_as_number */ |
| 2060 | 0, /* tp_as_sequence */ |
| 2061 | 0, /* tp_as_mapping */ |
| 2062 | 0, /* tp_hash */ |
| 2063 | 0, /* tp_call */ |
| 2064 | 0, /* tp_str */ |
| 2065 | 0, /* tp_getattro */ |
| 2066 | 0, /* tp_setattro */ |
| 2067 | 0, /* tp_as_buffer */ |
| 2068 | 0, /* tp_flags */ |
| 2069 | 0, /* tp_doc */ |
| 2070 | 0, /* tp_traverse */ |
| 2071 | 0, /* tp_clear */ |
| 2072 | 0, /* tp_richcompare */ |
| 2073 | 0, /* tp_weaklistoffset */ |
| 2074 | (getiterfunc)odictvalues_iter, /* tp_iter */ |
| 2075 | 0, /* tp_iternext */ |
| 2076 | odictvalues_methods, /* tp_methods */ |
| 2077 | 0, /* tp_members */ |
| 2078 | 0, /* tp_getset */ |
| 2079 | &PyDictValues_Type, /* tp_base */ |
| 2080 | }; |
| 2081 | |
| 2082 | static PyObject * |
Siddhesh Poyarekar | 55edd0c | 2018-04-30 00:29:33 +0530 | [diff] [blame] | 2083 | odictvalues_new(PyObject *od, PyObject *Py_UNUSED(ignored)) |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2084 | { |
| 2085 | return _PyDictView_New(od, &PyODictValues_Type); |
| 2086 | } |
| 2087 | |
| 2088 | |
| 2089 | /* ---------------------------------------------- |
Martin Panter | 536d70e | 2017-01-14 08:23:08 +0000 | [diff] [blame] | 2090 | MutableMapping implementations |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2091 | |
| 2092 | Mapping: |
| 2093 | |
| 2094 | ============ =========== |
| 2095 | method uses |
| 2096 | ============ =========== |
| 2097 | __contains__ __getitem__ |
| 2098 | __eq__ items |
| 2099 | __getitem__ + |
| 2100 | __iter__ + |
| 2101 | __len__ + |
| 2102 | __ne__ __eq__ |
| 2103 | get __getitem__ |
| 2104 | items ItemsView |
| 2105 | keys KeysView |
| 2106 | values ValuesView |
| 2107 | ============ =========== |
| 2108 | |
| 2109 | ItemsView uses __len__, __iter__, and __getitem__. |
| 2110 | KeysView uses __len__, __iter__, and __contains__. |
| 2111 | ValuesView uses __len__, __iter__, and __getitem__. |
| 2112 | |
| 2113 | MutableMapping: |
| 2114 | |
| 2115 | ============ =========== |
| 2116 | method uses |
| 2117 | ============ =========== |
| 2118 | __delitem__ + |
| 2119 | __setitem__ + |
| 2120 | clear popitem |
| 2121 | pop __getitem__ |
| 2122 | __delitem__ |
| 2123 | popitem __iter__ |
| 2124 | _getitem__ |
| 2125 | __delitem__ |
| 2126 | setdefault __getitem__ |
| 2127 | __setitem__ |
| 2128 | update __setitem__ |
| 2129 | ============ =========== |
| 2130 | */ |
| 2131 | |
| 2132 | static int |
| 2133 | mutablemapping_add_pairs(PyObject *self, PyObject *pairs) |
| 2134 | { |
| 2135 | PyObject *pair, *iterator, *unexpected; |
| 2136 | int res = 0; |
| 2137 | |
| 2138 | iterator = PyObject_GetIter(pairs); |
| 2139 | if (iterator == NULL) |
| 2140 | return -1; |
| 2141 | PyErr_Clear(); |
| 2142 | |
| 2143 | while ((pair = PyIter_Next(iterator)) != NULL) { |
| 2144 | /* could be more efficient (see UNPACK_SEQUENCE in ceval.c) */ |
Eric Snow | c5e5960 | 2015-05-30 11:28:56 -0600 | [diff] [blame] | 2145 | PyObject *key = NULL, *value = NULL; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2146 | PyObject *pair_iterator = PyObject_GetIter(pair); |
Eric Snow | c5e5960 | 2015-05-30 11:28:56 -0600 | [diff] [blame] | 2147 | if (pair_iterator == NULL) |
| 2148 | goto Done; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2149 | |
| 2150 | key = PyIter_Next(pair_iterator); |
| 2151 | if (key == NULL) { |
| 2152 | if (!PyErr_Occurred()) |
| 2153 | PyErr_SetString(PyExc_ValueError, |
| 2154 | "need more than 0 values to unpack"); |
| 2155 | goto Done; |
| 2156 | } |
| 2157 | |
| 2158 | value = PyIter_Next(pair_iterator); |
| 2159 | if (value == NULL) { |
| 2160 | if (!PyErr_Occurred()) |
| 2161 | PyErr_SetString(PyExc_ValueError, |
| 2162 | "need more than 1 value to unpack"); |
| 2163 | goto Done; |
| 2164 | } |
| 2165 | |
| 2166 | unexpected = PyIter_Next(pair_iterator); |
| 2167 | if (unexpected != NULL) { |
| 2168 | Py_DECREF(unexpected); |
| 2169 | PyErr_SetString(PyExc_ValueError, |
| 2170 | "too many values to unpack (expected 2)"); |
| 2171 | goto Done; |
| 2172 | } |
| 2173 | else if (PyErr_Occurred()) |
| 2174 | goto Done; |
| 2175 | |
| 2176 | res = PyObject_SetItem(self, key, value); |
| 2177 | |
| 2178 | Done: |
| 2179 | Py_DECREF(pair); |
Eric Snow | c5e5960 | 2015-05-30 11:28:56 -0600 | [diff] [blame] | 2180 | Py_XDECREF(pair_iterator); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2181 | Py_XDECREF(key); |
| 2182 | Py_XDECREF(value); |
| 2183 | if (PyErr_Occurred()) |
| 2184 | break; |
| 2185 | } |
| 2186 | Py_DECREF(iterator); |
| 2187 | |
| 2188 | if (res < 0 || PyErr_Occurred() != NULL) |
| 2189 | return -1; |
| 2190 | else |
| 2191 | return 0; |
| 2192 | } |
| 2193 | |
| 2194 | static PyObject * |
| 2195 | mutablemapping_update(PyObject *self, PyObject *args, PyObject *kwargs) |
| 2196 | { |
| 2197 | int res = 0; |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2198 | Py_ssize_t len; |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2199 | _Py_IDENTIFIER(keys); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2200 | |
| 2201 | /* first handle args, if any */ |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2202 | assert(args == NULL || PyTuple_Check(args)); |
| 2203 | len = (args != NULL) ? PyTuple_GET_SIZE(args) : 0; |
Benjamin Peterson | 99e96f2 | 2015-06-06 23:20:32 -0500 | [diff] [blame] | 2204 | if (len > 1) { |
Serhiy Storchaka | d53fe5f | 2019-03-13 22:59:55 +0200 | [diff] [blame] | 2205 | const char *msg = "update() takes at most 1 positional argument (%zd given)"; |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2206 | PyErr_Format(PyExc_TypeError, msg, len); |
| 2207 | return NULL; |
| 2208 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2209 | |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2210 | if (len) { |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2211 | PyObject *func; |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2212 | PyObject *other = PyTuple_GET_ITEM(args, 0); /* borrowed reference */ |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2213 | assert(other != NULL); |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2214 | Py_INCREF(other); |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2215 | if (PyDict_CheckExact(other)) { |
| 2216 | PyObject *items = PyDict_Items(other); |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2217 | Py_DECREF(other); |
| 2218 | if (items == NULL) |
| 2219 | return NULL; |
| 2220 | res = mutablemapping_add_pairs(self, items); |
| 2221 | Py_DECREF(items); |
| 2222 | if (res == -1) |
| 2223 | return NULL; |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2224 | goto handle_kwargs; |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2225 | } |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2226 | |
Serhiy Storchaka | f320be7 | 2018-01-25 10:49:40 +0200 | [diff] [blame] | 2227 | if (_PyObject_LookupAttrId(other, &PyId_keys, &func) < 0) { |
| 2228 | Py_DECREF(other); |
| 2229 | return NULL; |
| 2230 | } |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2231 | if (func != NULL) { |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2232 | PyObject *keys, *iterator, *key; |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2233 | keys = _PyObject_CallNoArg(func); |
| 2234 | Py_DECREF(func); |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2235 | if (keys == NULL) { |
| 2236 | Py_DECREF(other); |
| 2237 | return NULL; |
| 2238 | } |
| 2239 | iterator = PyObject_GetIter(keys); |
| 2240 | Py_DECREF(keys); |
| 2241 | if (iterator == NULL) { |
| 2242 | Py_DECREF(other); |
| 2243 | return NULL; |
| 2244 | } |
| 2245 | while (res == 0 && (key = PyIter_Next(iterator))) { |
| 2246 | PyObject *value = PyObject_GetItem(other, key); |
| 2247 | if (value != NULL) { |
| 2248 | res = PyObject_SetItem(self, key, value); |
| 2249 | Py_DECREF(value); |
| 2250 | } |
| 2251 | else { |
| 2252 | res = -1; |
| 2253 | } |
| 2254 | Py_DECREF(key); |
| 2255 | } |
| 2256 | Py_DECREF(other); |
| 2257 | Py_DECREF(iterator); |
| 2258 | if (res != 0 || PyErr_Occurred()) |
| 2259 | return NULL; |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2260 | goto handle_kwargs; |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2261 | } |
Serhiy Storchaka | f320be7 | 2018-01-25 10:49:40 +0200 | [diff] [blame] | 2262 | |
| 2263 | if (_PyObject_LookupAttrId(other, &PyId_items, &func) < 0) { |
Eric Snow | 06aed90 | 2016-09-09 11:59:08 -0700 | [diff] [blame] | 2264 | Py_DECREF(other); |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2265 | return NULL; |
| 2266 | } |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2267 | if (func != NULL) { |
| 2268 | PyObject *items; |
| 2269 | Py_DECREF(other); |
| 2270 | items = _PyObject_CallNoArg(func); |
| 2271 | Py_DECREF(func); |
Eric Snow | 06aed90 | 2016-09-09 11:59:08 -0700 | [diff] [blame] | 2272 | if (items == NULL) |
| 2273 | return NULL; |
| 2274 | res = mutablemapping_add_pairs(self, items); |
| 2275 | Py_DECREF(items); |
| 2276 | if (res == -1) |
| 2277 | return NULL; |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2278 | goto handle_kwargs; |
| 2279 | } |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2280 | |
| 2281 | res = mutablemapping_add_pairs(self, other); |
| 2282 | Py_DECREF(other); |
| 2283 | if (res != 0) |
| 2284 | return NULL; |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2285 | } |
| 2286 | |
Serhiy Storchaka | 60c3d35 | 2017-11-11 16:19:56 +0200 | [diff] [blame] | 2287 | handle_kwargs: |
Benjamin Peterson | 0718de9 | 2015-06-07 00:00:42 -0500 | [diff] [blame] | 2288 | /* now handle kwargs */ |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2289 | assert(kwargs == NULL || PyDict_Check(kwargs)); |
Serhiy Storchaka | 5ab81d7 | 2016-12-16 16:18:57 +0200 | [diff] [blame] | 2290 | if (kwargs != NULL && PyDict_GET_SIZE(kwargs)) { |
Serhiy Storchaka | 8003baf | 2015-10-18 09:53:17 +0300 | [diff] [blame] | 2291 | PyObject *items = PyDict_Items(kwargs); |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2292 | if (items == NULL) |
| 2293 | return NULL; |
| 2294 | res = mutablemapping_add_pairs(self, items); |
| 2295 | Py_DECREF(items); |
| 2296 | if (res == -1) |
| 2297 | return NULL; |
| 2298 | } |
Eric Snow | 96c6af9 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2299 | |
| 2300 | Py_RETURN_NONE; |
| 2301 | } |