Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1 | #include "Python.h" |
Raymond Hettinger | 691d805 | 2004-05-30 07:26:47 +0000 | [diff] [blame] | 2 | #include "structmember.h" |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 3 | |
Raymond Hettinger | c208308 | 2015-02-28 23:29:16 -0800 | [diff] [blame] | 4 | #ifdef STDC_HEADERS |
| 5 | #include <stddef.h> |
| 6 | #else |
| 7 | #include <sys/types.h> /* For size_t */ |
| 8 | #endif |
| 9 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 10 | /* collections module implementation of a deque() datatype |
| 11 | Written and maintained by Raymond D. Hettinger <python@rcn.com> |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 12 | */ |
| 13 | |
Raymond Hettinger | 77e8bf1 | 2004-10-01 15:25:53 +0000 | [diff] [blame] | 14 | /* The block length may be set to any number over 1. Larger numbers |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 15 | * reduce the number of calls to the memory allocator, give faster |
Raymond Hettinger | 30c9074 | 2015-03-02 22:31:35 -0800 | [diff] [blame] | 16 | * indexing and rotation, and reduce the link to data overhead ratio. |
Raymond Hettinger | daf57f2 | 2015-02-26 23:21:29 -0800 | [diff] [blame] | 17 | * Making the block length a power of two speeds-up the modulo |
Raymond Hettinger | 30c9074 | 2015-03-02 22:31:35 -0800 | [diff] [blame] | 18 | * and division calculations in deque_item() and deque_ass_item(). |
Raymond Hettinger | 77e8bf1 | 2004-10-01 15:25:53 +0000 | [diff] [blame] | 19 | */ |
| 20 | |
Raymond Hettinger | daf57f2 | 2015-02-26 23:21:29 -0800 | [diff] [blame] | 21 | #define BLOCKLEN 64 |
Raymond Hettinger | 61f05fb | 2004-10-01 06:24:12 +0000 | [diff] [blame] | 22 | #define CENTER ((BLOCKLEN - 1) / 2) |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 23 | |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 24 | /* Data for deque objects is stored in a doubly-linked list of fixed |
| 25 | * length blocks. This assures that appends or pops never move any |
| 26 | * other data elements besides the one being appended or popped. |
| 27 | * |
| 28 | * Another advantage is that it completely avoids use of realloc(), |
| 29 | * resulting in more predictable performance. |
| 30 | * |
| 31 | * Textbook implementations of doubly-linked lists store one datum |
| 32 | * per link, but that gives them a 200% memory overhead (a prev and |
| 33 | * next link for each datum) and it costs one malloc() call per data |
| 34 | * element. By using fixed-length blocks, the link to data ratio is |
| 35 | * significantly improved and there are proportionally fewer calls |
| 36 | * to malloc() and free(). The data blocks of consecutive pointers |
| 37 | * also improve cache locality. |
| 38 | * |
Raymond Hettinger | 61f05fb | 2004-10-01 06:24:12 +0000 | [diff] [blame] | 39 | * The list of blocks is never empty, so d.leftblock and d.rightblock |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 40 | * are never equal to NULL. The list is not circular. |
| 41 | * |
| 42 | * A deque d's first element is at d.leftblock[leftindex] |
| 43 | * and its last element is at d.rightblock[rightindex]. |
Raymond Hettinger | 61f05fb | 2004-10-01 06:24:12 +0000 | [diff] [blame] | 44 | * |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 45 | * Unlike Python slice indices, these indices are inclusive on both |
| 46 | * ends. This makes the algorithms for left and right operations |
| 47 | * more symmetrical and it simplifies the design. |
Raymond Hettinger | 61f05fb | 2004-10-01 06:24:12 +0000 | [diff] [blame] | 48 | * |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 49 | * The indices, d.leftindex and d.rightindex are always in the range: |
| 50 | * 0 <= index < BLOCKLEN |
| 51 | * |
| 52 | * And their exact relationship is: |
| 53 | * (d.leftindex + d.len - 1) % BLOCKLEN == d.rightindex |
Raymond Hettinger | 61f05fb | 2004-10-01 06:24:12 +0000 | [diff] [blame] | 54 | * |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 55 | * Whenever d.leftblock == d.rightblock, then: |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 56 | * d.leftindex + d.len - 1 == d.rightindex |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 57 | * |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 58 | * However, when d.leftblock != d.rightblock, the d.leftindex and |
| 59 | * d.rightindex become indices into distinct blocks and either may |
| 60 | * be larger than the other. |
| 61 | * |
| 62 | * Empty deques have: |
| 63 | * d.len == 0 |
| 64 | * d.leftblock == d.rightblock |
| 65 | * d.leftindex == CENTER + 1 |
| 66 | * d.rightindex == CENTER |
| 67 | * |
| 68 | * Checking for d.len == 0 is the intended way to see whether d is empty. |
Tim Peters | d8768d3 | 2004-10-01 01:32:53 +0000 | [diff] [blame] | 69 | */ |
| 70 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 71 | typedef struct BLOCK { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 72 | struct BLOCK *leftlink; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 73 | PyObject *data[BLOCKLEN]; |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 74 | struct BLOCK *rightlink; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 75 | } block; |
| 76 | |
Raymond Hettinger | 30c9074 | 2015-03-02 22:31:35 -0800 | [diff] [blame] | 77 | typedef struct { |
| 78 | PyObject_VAR_HEAD |
| 79 | block *leftblock; |
| 80 | block *rightblock; |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 81 | Py_ssize_t leftindex; /* 0 <= leftindex < BLOCKLEN */ |
| 82 | Py_ssize_t rightindex; /* 0 <= rightindex < BLOCKLEN */ |
Raymond Hettinger | f9d9c79 | 2015-03-02 22:47:46 -0800 | [diff] [blame] | 83 | size_t state; /* incremented whenever the indices move */ |
Raymond Hettinger | 30c9074 | 2015-03-02 22:31:35 -0800 | [diff] [blame] | 84 | Py_ssize_t maxlen; |
Raymond Hettinger | 0f6f947 | 2015-03-21 01:42:10 -0700 | [diff] [blame] | 85 | PyObject *weakreflist; |
Raymond Hettinger | 30c9074 | 2015-03-02 22:31:35 -0800 | [diff] [blame] | 86 | } dequeobject; |
| 87 | |
| 88 | static PyTypeObject deque_type; |
| 89 | |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 90 | /* For debug builds, add error checking to track the endpoints |
| 91 | * in the chain of links. The goal is to make sure that link |
| 92 | * assignments only take place at endpoints so that links already |
| 93 | * in use do not get overwritten. |
| 94 | * |
| 95 | * CHECK_END should happen before each assignment to a block's link field. |
| 96 | * MARK_END should happen whenever a link field becomes a new endpoint. |
| 97 | * This happens when new blocks are added or whenever an existing |
| 98 | * block is freed leaving another existing block as the new endpoint. |
| 99 | */ |
| 100 | |
Raymond Hettinger | 3223dd5 | 2013-07-26 23:14:22 -0700 | [diff] [blame] | 101 | #ifndef NDEBUG |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 102 | #define MARK_END(link) link = NULL; |
| 103 | #define CHECK_END(link) assert(link == NULL); |
| 104 | #define CHECK_NOT_END(link) assert(link != NULL); |
| 105 | #else |
| 106 | #define MARK_END(link) |
| 107 | #define CHECK_END(link) |
| 108 | #define CHECK_NOT_END(link) |
| 109 | #endif |
| 110 | |
| 111 | /* A simple freelisting scheme is used to minimize calls to the memory |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 112 | allocator. It accommodates common use cases where new blocks are being |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 113 | added at about the same rate as old blocks are being freed. |
| 114 | */ |
| 115 | |
Raymond Hettinger | f2b02ce | 2015-09-26 17:47:02 -0700 | [diff] [blame] | 116 | #define MAXFREEBLOCKS 16 |
Benjamin Peterson | d631371 | 2008-07-31 16:23:04 +0000 | [diff] [blame] | 117 | static Py_ssize_t numfreeblocks = 0; |
Guido van Rossum | 58da931 | 2007-11-10 23:39:45 +0000 | [diff] [blame] | 118 | static block *freeblocks[MAXFREEBLOCKS]; |
| 119 | |
Tim Peters | 6f85356 | 2004-10-01 01:04:50 +0000 | [diff] [blame] | 120 | static block * |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 121 | newblock(void) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 122 | block *b; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 123 | if (numfreeblocks) { |
Raymond Hettinger | 59cf23a | 2013-02-07 00:57:19 -0500 | [diff] [blame] | 124 | numfreeblocks--; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 125 | return freeblocks[numfreeblocks]; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 126 | } |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 127 | b = PyMem_Malloc(sizeof(block)); |
| 128 | if (b != NULL) { |
| 129 | return b; |
| 130 | } |
| 131 | PyErr_NoMemory(); |
| 132 | return NULL; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 133 | } |
| 134 | |
Martin v. Löwis | 59683e8 | 2008-06-13 07:50:45 +0000 | [diff] [blame] | 135 | static void |
Guido van Rossum | 58da931 | 2007-11-10 23:39:45 +0000 | [diff] [blame] | 136 | freeblock(block *b) |
| 137 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 138 | if (numfreeblocks < MAXFREEBLOCKS) { |
| 139 | freeblocks[numfreeblocks] = b; |
| 140 | numfreeblocks++; |
| 141 | } else { |
| 142 | PyMem_Free(b); |
| 143 | } |
Guido van Rossum | 58da931 | 2007-11-10 23:39:45 +0000 | [diff] [blame] | 144 | } |
| 145 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 146 | static PyObject * |
| 147 | deque_new(PyTypeObject *type, PyObject *args, PyObject *kwds) |
| 148 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 149 | dequeobject *deque; |
| 150 | block *b; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 151 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 152 | /* create dequeobject structure */ |
| 153 | deque = (dequeobject *)type->tp_alloc(type, 0); |
| 154 | if (deque == NULL) |
| 155 | return NULL; |
Tim Peters | 1065f75 | 2004-10-01 01:03:29 +0000 | [diff] [blame] | 156 | |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 157 | b = newblock(); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 158 | if (b == NULL) { |
| 159 | Py_DECREF(deque); |
| 160 | return NULL; |
| 161 | } |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 162 | MARK_END(b->leftlink); |
| 163 | MARK_END(b->rightlink); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 164 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 165 | assert(BLOCKLEN >= 2); |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 166 | Py_SIZE(deque) = 0; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 167 | deque->leftblock = b; |
| 168 | deque->rightblock = b; |
| 169 | deque->leftindex = CENTER + 1; |
| 170 | deque->rightindex = CENTER; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 171 | deque->state = 0; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 172 | deque->maxlen = -1; |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 173 | deque->weakreflist = NULL; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 174 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 175 | return (PyObject *)deque; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 176 | } |
| 177 | |
| 178 | static PyObject * |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 179 | deque_pop(dequeobject *deque, PyObject *unused) |
| 180 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 181 | PyObject *item; |
| 182 | block *prevblock; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 183 | |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 184 | if (Py_SIZE(deque) == 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 185 | PyErr_SetString(PyExc_IndexError, "pop from an empty deque"); |
| 186 | return NULL; |
| 187 | } |
| 188 | item = deque->rightblock->data[deque->rightindex]; |
| 189 | deque->rightindex--; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 190 | Py_SIZE(deque)--; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 191 | deque->state++; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 192 | |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 193 | if (deque->rightindex < 0) { |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 194 | if (Py_SIZE(deque)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 195 | prevblock = deque->rightblock->leftlink; |
| 196 | assert(deque->leftblock != deque->rightblock); |
| 197 | freeblock(deque->rightblock); |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 198 | CHECK_NOT_END(prevblock); |
| 199 | MARK_END(prevblock->rightlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 200 | deque->rightblock = prevblock; |
| 201 | deque->rightindex = BLOCKLEN - 1; |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 202 | } else { |
| 203 | assert(deque->leftblock == deque->rightblock); |
| 204 | assert(deque->leftindex == deque->rightindex+1); |
| 205 | /* re-center instead of freeing a block */ |
| 206 | deque->leftindex = CENTER + 1; |
| 207 | deque->rightindex = CENTER; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 208 | } |
| 209 | } |
| 210 | return item; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 211 | } |
| 212 | |
| 213 | PyDoc_STRVAR(pop_doc, "Remove and return the rightmost element."); |
| 214 | |
| 215 | static PyObject * |
| 216 | deque_popleft(dequeobject *deque, PyObject *unused) |
| 217 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 218 | PyObject *item; |
| 219 | block *prevblock; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 220 | |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 221 | if (Py_SIZE(deque) == 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 222 | PyErr_SetString(PyExc_IndexError, "pop from an empty deque"); |
| 223 | return NULL; |
| 224 | } |
| 225 | assert(deque->leftblock != NULL); |
| 226 | item = deque->leftblock->data[deque->leftindex]; |
| 227 | deque->leftindex++; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 228 | Py_SIZE(deque)--; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 229 | deque->state++; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 230 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 231 | if (deque->leftindex == BLOCKLEN) { |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 232 | if (Py_SIZE(deque)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 233 | assert(deque->leftblock != deque->rightblock); |
| 234 | prevblock = deque->leftblock->rightlink; |
| 235 | freeblock(deque->leftblock); |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 236 | CHECK_NOT_END(prevblock); |
| 237 | MARK_END(prevblock->leftlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 238 | deque->leftblock = prevblock; |
| 239 | deque->leftindex = 0; |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 240 | } else { |
| 241 | assert(deque->leftblock == deque->rightblock); |
| 242 | assert(deque->leftindex == deque->rightindex+1); |
| 243 | /* re-center instead of freeing a block */ |
| 244 | deque->leftindex = CENTER + 1; |
| 245 | deque->rightindex = CENTER; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 246 | } |
| 247 | } |
| 248 | return item; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 249 | } |
| 250 | |
| 251 | PyDoc_STRVAR(popleft_doc, "Remove and return the leftmost element."); |
| 252 | |
Raymond Hettinger | f30f5b9 | 2015-03-02 22:23:37 -0800 | [diff] [blame] | 253 | /* The deque's size limit is d.maxlen. The limit can be zero or positive. |
| 254 | * If there is no limit, then d.maxlen == -1. |
| 255 | * |
Raymond Hettinger | a4b13d0 | 2015-10-15 08:05:31 -0700 | [diff] [blame] | 256 | * After an item is added to a deque, we check to see if the size has |
| 257 | * grown past the limit. If it has, we get the size back down to the limit |
| 258 | * by popping an item off of the opposite end. The methods that can |
| 259 | * trigger this are append(), appendleft(), extend(), and extendleft(). |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 260 | * |
| 261 | * The macro to check whether a deque needs to be trimmed uses a single |
| 262 | * unsigned test that returns true whenever 0 <= maxlen < Py_SIZE(deque). |
Raymond Hettinger | f30f5b9 | 2015-03-02 22:23:37 -0800 | [diff] [blame] | 263 | */ |
| 264 | |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 265 | #define NEEDS_TRIM(deque, maxlen) ((size_t)(maxlen) < (size_t)(Py_SIZE(deque))) |
Raymond Hettinger | f30f5b9 | 2015-03-02 22:23:37 -0800 | [diff] [blame] | 266 | |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 267 | static PyObject * |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 268 | deque_append(dequeobject *deque, PyObject *item) |
| 269 | { |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 270 | if (deque->rightindex == BLOCKLEN - 1) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 271 | block *b = newblock(); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 272 | if (b == NULL) |
| 273 | return NULL; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 274 | b->leftlink = deque->rightblock; |
| 275 | CHECK_END(deque->rightblock->rightlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 276 | deque->rightblock->rightlink = b; |
| 277 | deque->rightblock = b; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 278 | MARK_END(b->rightlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 279 | deque->rightindex = -1; |
| 280 | } |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 281 | Py_SIZE(deque)++; |
Raymond Hettinger | 7c0b70f | 2015-09-26 21:11:05 -0700 | [diff] [blame] | 282 | Py_INCREF(item); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 283 | deque->rightindex++; |
| 284 | deque->rightblock->data[deque->rightindex] = item; |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 285 | if (NEEDS_TRIM(deque, deque->maxlen)) { |
Raymond Hettinger | 1286d14 | 2015-10-14 23:16:57 -0700 | [diff] [blame] | 286 | PyObject *olditem = deque_popleft(deque, NULL); |
| 287 | Py_DECREF(olditem); |
Raymond Hettinger | 0f43bb1 | 2015-10-20 00:03:33 -0700 | [diff] [blame] | 288 | } else { |
| 289 | deque->state++; |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 290 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 291 | Py_RETURN_NONE; |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 292 | } |
| 293 | |
| 294 | PyDoc_STRVAR(append_doc, "Add an element to the right side of the deque."); |
| 295 | |
| 296 | static PyObject * |
| 297 | deque_appendleft(dequeobject *deque, PyObject *item) |
| 298 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 299 | if (deque->leftindex == 0) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 300 | block *b = newblock(); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 301 | if (b == NULL) |
| 302 | return NULL; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 303 | b->rightlink = deque->leftblock; |
| 304 | CHECK_END(deque->leftblock->leftlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 305 | deque->leftblock->leftlink = b; |
| 306 | deque->leftblock = b; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 307 | MARK_END(b->leftlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 308 | deque->leftindex = BLOCKLEN; |
| 309 | } |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 310 | Py_SIZE(deque)++; |
Raymond Hettinger | 7c0b70f | 2015-09-26 21:11:05 -0700 | [diff] [blame] | 311 | Py_INCREF(item); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 312 | deque->leftindex--; |
| 313 | deque->leftblock->data[deque->leftindex] = item; |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 314 | if (NEEDS_TRIM(deque, deque->maxlen)) { |
Raymond Hettinger | 1286d14 | 2015-10-14 23:16:57 -0700 | [diff] [blame] | 315 | PyObject *olditem = deque_pop(deque, NULL); |
| 316 | Py_DECREF(olditem); |
Raymond Hettinger | 0f43bb1 | 2015-10-20 00:03:33 -0700 | [diff] [blame] | 317 | } else { |
| 318 | deque->state++; |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 319 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 320 | Py_RETURN_NONE; |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 321 | } |
| 322 | |
| 323 | PyDoc_STRVAR(appendleft_doc, "Add an element to the left side of the deque."); |
| 324 | |
Raymond Hettinger | fd265f4 | 2015-10-02 23:17:33 -0700 | [diff] [blame] | 325 | static PyObject* |
| 326 | finalize_iterator(PyObject *it) |
| 327 | { |
| 328 | if (PyErr_Occurred()) { |
| 329 | if (PyErr_ExceptionMatches(PyExc_StopIteration)) |
| 330 | PyErr_Clear(); |
| 331 | else { |
| 332 | Py_DECREF(it); |
| 333 | return NULL; |
| 334 | } |
| 335 | } |
| 336 | Py_DECREF(it); |
| 337 | Py_RETURN_NONE; |
| 338 | } |
Raymond Hettinger | 060c7f6 | 2009-03-10 09:36:07 +0000 | [diff] [blame] | 339 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 340 | /* Run an iterator to exhaustion. Shortcut for |
Raymond Hettinger | 060c7f6 | 2009-03-10 09:36:07 +0000 | [diff] [blame] | 341 | the extend/extendleft methods when maxlen == 0. */ |
| 342 | static PyObject* |
| 343 | consume_iterator(PyObject *it) |
| 344 | { |
Raymond Hettinger | fd265f4 | 2015-10-02 23:17:33 -0700 | [diff] [blame] | 345 | PyObject *(*iternext)(PyObject *); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 346 | PyObject *item; |
Raymond Hettinger | 060c7f6 | 2009-03-10 09:36:07 +0000 | [diff] [blame] | 347 | |
Raymond Hettinger | fd265f4 | 2015-10-02 23:17:33 -0700 | [diff] [blame] | 348 | iternext = *Py_TYPE(it)->tp_iternext; |
| 349 | while ((item = iternext(it)) != NULL) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 350 | Py_DECREF(item); |
| 351 | } |
Raymond Hettinger | fd265f4 | 2015-10-02 23:17:33 -0700 | [diff] [blame] | 352 | return finalize_iterator(it); |
Raymond Hettinger | 060c7f6 | 2009-03-10 09:36:07 +0000 | [diff] [blame] | 353 | } |
| 354 | |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 355 | static PyObject * |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 356 | deque_extend(dequeobject *deque, PyObject *iterable) |
| 357 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 358 | PyObject *it, *item; |
Raymond Hettinger | 7a84552 | 2015-09-26 01:30:51 -0700 | [diff] [blame] | 359 | PyObject *(*iternext)(PyObject *); |
Raymond Hettinger | 6b1e113 | 2015-10-11 09:43:50 -0700 | [diff] [blame] | 360 | Py_ssize_t maxlen = deque->maxlen; |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 361 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 362 | /* Handle case where id(deque) == id(iterable) */ |
| 363 | if ((PyObject *)deque == iterable) { |
| 364 | PyObject *result; |
| 365 | PyObject *s = PySequence_List(iterable); |
| 366 | if (s == NULL) |
| 367 | return NULL; |
| 368 | result = deque_extend(deque, s); |
| 369 | Py_DECREF(s); |
| 370 | return result; |
| 371 | } |
Raymond Hettinger | 3f9afd8 | 2009-12-10 03:03:02 +0000 | [diff] [blame] | 372 | |
Raymond Hettinger | d9c116c | 2013-07-09 00:13:21 -0700 | [diff] [blame] | 373 | /* Space saving heuristic. Start filling from the left */ |
| 374 | if (Py_SIZE(deque) == 0) { |
| 375 | assert(deque->leftblock == deque->rightblock); |
| 376 | assert(deque->leftindex == deque->rightindex+1); |
| 377 | deque->leftindex = 1; |
| 378 | deque->rightindex = 0; |
| 379 | } |
| 380 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 381 | it = PyObject_GetIter(iterable); |
| 382 | if (it == NULL) |
| 383 | return NULL; |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 384 | |
Raymond Hettinger | 965362e | 2015-10-11 22:52:54 -0700 | [diff] [blame] | 385 | if (maxlen == 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 386 | return consume_iterator(it); |
Raymond Hettinger | 060c7f6 | 2009-03-10 09:36:07 +0000 | [diff] [blame] | 387 | |
Raymond Hettinger | 7a84552 | 2015-09-26 01:30:51 -0700 | [diff] [blame] | 388 | iternext = *Py_TYPE(it)->tp_iternext; |
| 389 | while ((item = iternext(it)) != NULL) { |
Raymond Hettinger | 8dbbae2 | 2015-03-24 21:01:50 -0700 | [diff] [blame] | 390 | if (deque->rightindex == BLOCKLEN - 1) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 391 | block *b = newblock(); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 392 | if (b == NULL) { |
| 393 | Py_DECREF(item); |
| 394 | Py_DECREF(it); |
| 395 | return NULL; |
| 396 | } |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 397 | b->leftlink = deque->rightblock; |
| 398 | CHECK_END(deque->rightblock->rightlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 399 | deque->rightblock->rightlink = b; |
| 400 | deque->rightblock = b; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 401 | MARK_END(b->rightlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 402 | deque->rightindex = -1; |
| 403 | } |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 404 | Py_SIZE(deque)++; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 405 | deque->rightindex++; |
| 406 | deque->rightblock->data[deque->rightindex] = item; |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 407 | if (NEEDS_TRIM(deque, maxlen)) { |
Raymond Hettinger | 1286d14 | 2015-10-14 23:16:57 -0700 | [diff] [blame] | 408 | PyObject *olditem = deque_popleft(deque, NULL); |
| 409 | Py_DECREF(olditem); |
Raymond Hettinger | 0f43bb1 | 2015-10-20 00:03:33 -0700 | [diff] [blame] | 410 | } else { |
| 411 | deque->state++; |
Raymond Hettinger | 6b1e113 | 2015-10-11 09:43:50 -0700 | [diff] [blame] | 412 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 413 | } |
Raymond Hettinger | fd265f4 | 2015-10-02 23:17:33 -0700 | [diff] [blame] | 414 | return finalize_iterator(it); |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 415 | } |
| 416 | |
Tim Peters | 1065f75 | 2004-10-01 01:03:29 +0000 | [diff] [blame] | 417 | PyDoc_STRVAR(extend_doc, |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 418 | "Extend the right side of the deque with elements from the iterable"); |
| 419 | |
| 420 | static PyObject * |
| 421 | deque_extendleft(dequeobject *deque, PyObject *iterable) |
| 422 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 423 | PyObject *it, *item; |
Raymond Hettinger | 7a84552 | 2015-09-26 01:30:51 -0700 | [diff] [blame] | 424 | PyObject *(*iternext)(PyObject *); |
Raymond Hettinger | 6b1e113 | 2015-10-11 09:43:50 -0700 | [diff] [blame] | 425 | Py_ssize_t maxlen = deque->maxlen; |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 426 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 427 | /* Handle case where id(deque) == id(iterable) */ |
| 428 | if ((PyObject *)deque == iterable) { |
| 429 | PyObject *result; |
| 430 | PyObject *s = PySequence_List(iterable); |
| 431 | if (s == NULL) |
| 432 | return NULL; |
| 433 | result = deque_extendleft(deque, s); |
| 434 | Py_DECREF(s); |
| 435 | return result; |
| 436 | } |
Raymond Hettinger | 3f9afd8 | 2009-12-10 03:03:02 +0000 | [diff] [blame] | 437 | |
Raymond Hettinger | d9c116c | 2013-07-09 00:13:21 -0700 | [diff] [blame] | 438 | /* Space saving heuristic. Start filling from the right */ |
| 439 | if (Py_SIZE(deque) == 0) { |
| 440 | assert(deque->leftblock == deque->rightblock); |
| 441 | assert(deque->leftindex == deque->rightindex+1); |
| 442 | deque->leftindex = BLOCKLEN - 1; |
| 443 | deque->rightindex = BLOCKLEN - 2; |
| 444 | } |
| 445 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 446 | it = PyObject_GetIter(iterable); |
| 447 | if (it == NULL) |
| 448 | return NULL; |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 449 | |
Raymond Hettinger | 965362e | 2015-10-11 22:52:54 -0700 | [diff] [blame] | 450 | if (maxlen == 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 451 | return consume_iterator(it); |
Raymond Hettinger | 060c7f6 | 2009-03-10 09:36:07 +0000 | [diff] [blame] | 452 | |
Raymond Hettinger | 7a84552 | 2015-09-26 01:30:51 -0700 | [diff] [blame] | 453 | iternext = *Py_TYPE(it)->tp_iternext; |
| 454 | while ((item = iternext(it)) != NULL) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 455 | if (deque->leftindex == 0) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 456 | block *b = newblock(); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 457 | if (b == NULL) { |
| 458 | Py_DECREF(item); |
| 459 | Py_DECREF(it); |
| 460 | return NULL; |
| 461 | } |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 462 | b->rightlink = deque->leftblock; |
| 463 | CHECK_END(deque->leftblock->leftlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 464 | deque->leftblock->leftlink = b; |
| 465 | deque->leftblock = b; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 466 | MARK_END(b->leftlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 467 | deque->leftindex = BLOCKLEN; |
| 468 | } |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 469 | Py_SIZE(deque)++; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 470 | deque->leftindex--; |
| 471 | deque->leftblock->data[deque->leftindex] = item; |
Raymond Hettinger | d96db09 | 2015-10-11 22:34:48 -0700 | [diff] [blame] | 472 | if (NEEDS_TRIM(deque, maxlen)) { |
Raymond Hettinger | 1286d14 | 2015-10-14 23:16:57 -0700 | [diff] [blame] | 473 | PyObject *olditem = deque_pop(deque, NULL); |
| 474 | Py_DECREF(olditem); |
Raymond Hettinger | 0f43bb1 | 2015-10-20 00:03:33 -0700 | [diff] [blame] | 475 | } else { |
| 476 | deque->state++; |
Raymond Hettinger | 6b1e113 | 2015-10-11 09:43:50 -0700 | [diff] [blame] | 477 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 478 | } |
Raymond Hettinger | fd265f4 | 2015-10-02 23:17:33 -0700 | [diff] [blame] | 479 | return finalize_iterator(it); |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 480 | } |
| 481 | |
Tim Peters | 1065f75 | 2004-10-01 01:03:29 +0000 | [diff] [blame] | 482 | PyDoc_STRVAR(extendleft_doc, |
Raymond Hettinger | 3ba85c2 | 2004-02-06 19:04:56 +0000 | [diff] [blame] | 483 | "Extend the left side of the deque with elements from the iterable"); |
| 484 | |
Raymond Hettinger | 3f9afd8 | 2009-12-10 03:03:02 +0000 | [diff] [blame] | 485 | static PyObject * |
| 486 | deque_inplace_concat(dequeobject *deque, PyObject *other) |
| 487 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 488 | PyObject *result; |
Raymond Hettinger | 3f9afd8 | 2009-12-10 03:03:02 +0000 | [diff] [blame] | 489 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 490 | result = deque_extend(deque, other); |
| 491 | if (result == NULL) |
| 492 | return result; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 493 | Py_INCREF(deque); |
Raymond Hettinger | 2b2b753 | 2015-09-05 17:05:52 -0700 | [diff] [blame] | 494 | Py_DECREF(result); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 495 | return (PyObject *)deque; |
Raymond Hettinger | 3f9afd8 | 2009-12-10 03:03:02 +0000 | [diff] [blame] | 496 | } |
| 497 | |
Raymond Hettinger | 8299e9b | 2015-09-26 21:31:23 -0700 | [diff] [blame] | 498 | static PyObject * |
| 499 | deque_copy(PyObject *deque) |
| 500 | { |
| 501 | dequeobject *old_deque = (dequeobject *)deque; |
| 502 | if (Py_TYPE(deque) == &deque_type) { |
| 503 | dequeobject *new_deque; |
| 504 | PyObject *rv; |
| 505 | |
| 506 | new_deque = (dequeobject *)deque_new(&deque_type, (PyObject *)NULL, (PyObject *)NULL); |
| 507 | if (new_deque == NULL) |
| 508 | return NULL; |
| 509 | new_deque->maxlen = old_deque->maxlen; |
| 510 | /* Fast path for the deque_repeat() common case where len(deque) == 1 */ |
Raymond Hettinger | 0443ac2 | 2015-10-05 22:52:37 -0400 | [diff] [blame] | 511 | if (Py_SIZE(deque) == 1) { |
Raymond Hettinger | 8299e9b | 2015-09-26 21:31:23 -0700 | [diff] [blame] | 512 | PyObject *item = old_deque->leftblock->data[old_deque->leftindex]; |
| 513 | rv = deque_append(new_deque, item); |
| 514 | } else { |
| 515 | rv = deque_extend(new_deque, deque); |
| 516 | } |
| 517 | if (rv != NULL) { |
| 518 | Py_DECREF(rv); |
| 519 | return (PyObject *)new_deque; |
| 520 | } |
| 521 | Py_DECREF(new_deque); |
| 522 | return NULL; |
| 523 | } |
| 524 | if (old_deque->maxlen < 0) |
| 525 | return PyObject_CallFunction((PyObject *)(Py_TYPE(deque)), "O", deque, NULL); |
| 526 | else |
| 527 | return PyObject_CallFunction((PyObject *)(Py_TYPE(deque)), "Oi", |
| 528 | deque, old_deque->maxlen, NULL); |
| 529 | } |
| 530 | |
| 531 | PyDoc_STRVAR(copy_doc, "Return a shallow copy of a deque."); |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 532 | |
| 533 | static PyObject * |
| 534 | deque_concat(dequeobject *deque, PyObject *other) |
| 535 | { |
Benjamin Peterson | 1a62921 | 2015-04-04 10:52:36 -0400 | [diff] [blame] | 536 | PyObject *new_deque, *result; |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 537 | int rv; |
| 538 | |
| 539 | rv = PyObject_IsInstance(other, (PyObject *)&deque_type); |
| 540 | if (rv <= 0) { |
| 541 | if (rv == 0) { |
| 542 | PyErr_Format(PyExc_TypeError, |
| 543 | "can only concatenate deque (not \"%.200s\") to deque", |
| 544 | other->ob_type->tp_name); |
| 545 | } |
| 546 | return NULL; |
| 547 | } |
| 548 | |
| 549 | new_deque = deque_copy((PyObject *)deque); |
| 550 | if (new_deque == NULL) |
| 551 | return NULL; |
Benjamin Peterson | 1a62921 | 2015-04-04 10:52:36 -0400 | [diff] [blame] | 552 | result = deque_extend((dequeobject *)new_deque, other); |
| 553 | if (result == NULL) { |
| 554 | Py_DECREF(new_deque); |
| 555 | return NULL; |
| 556 | } |
| 557 | Py_DECREF(result); |
| 558 | return new_deque; |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 559 | } |
| 560 | |
Raymond Hettinger | 8299e9b | 2015-09-26 21:31:23 -0700 | [diff] [blame] | 561 | static void |
| 562 | deque_clear(dequeobject *deque) |
| 563 | { |
| 564 | block *b; |
| 565 | block *prevblock; |
| 566 | block *leftblock; |
| 567 | Py_ssize_t leftindex; |
| 568 | Py_ssize_t n; |
| 569 | PyObject *item; |
| 570 | |
Raymond Hettinger | 3803114 | 2015-09-29 22:45:05 -0700 | [diff] [blame] | 571 | if (Py_SIZE(deque) == 0) |
| 572 | return; |
| 573 | |
Raymond Hettinger | 8299e9b | 2015-09-26 21:31:23 -0700 | [diff] [blame] | 574 | /* During the process of clearing a deque, decrefs can cause the |
| 575 | deque to mutate. To avoid fatal confusion, we have to make the |
| 576 | deque empty before clearing the blocks and never refer to |
| 577 | anything via deque->ref while clearing. (This is the same |
| 578 | technique used for clearing lists, sets, and dicts.) |
| 579 | |
| 580 | Making the deque empty requires allocating a new empty block. In |
| 581 | the unlikely event that memory is full, we fall back to an |
| 582 | alternate method that doesn't require a new block. Repeating |
| 583 | pops in a while-loop is slower, possibly re-entrant (and a clever |
| 584 | adversary could cause it to never terminate). |
| 585 | */ |
| 586 | |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 587 | b = newblock(); |
Raymond Hettinger | 8299e9b | 2015-09-26 21:31:23 -0700 | [diff] [blame] | 588 | if (b == NULL) { |
| 589 | PyErr_Clear(); |
| 590 | goto alternate_method; |
| 591 | } |
| 592 | |
| 593 | /* Remember the old size, leftblock, and leftindex */ |
| 594 | leftblock = deque->leftblock; |
| 595 | leftindex = deque->leftindex; |
| 596 | n = Py_SIZE(deque); |
| 597 | |
| 598 | /* Set the deque to be empty using the newly allocated block */ |
| 599 | MARK_END(b->leftlink); |
| 600 | MARK_END(b->rightlink); |
| 601 | Py_SIZE(deque) = 0; |
| 602 | deque->leftblock = b; |
| 603 | deque->rightblock = b; |
| 604 | deque->leftindex = CENTER + 1; |
| 605 | deque->rightindex = CENTER; |
| 606 | deque->state++; |
| 607 | |
| 608 | /* Now the old size, leftblock, and leftindex are disconnected from |
| 609 | the empty deque and we can use them to decref the pointers. |
| 610 | */ |
| 611 | while (n--) { |
| 612 | item = leftblock->data[leftindex]; |
| 613 | Py_DECREF(item); |
| 614 | leftindex++; |
| 615 | if (leftindex == BLOCKLEN && n) { |
| 616 | CHECK_NOT_END(leftblock->rightlink); |
| 617 | prevblock = leftblock; |
| 618 | leftblock = leftblock->rightlink; |
| 619 | leftindex = 0; |
| 620 | freeblock(prevblock); |
| 621 | } |
| 622 | } |
| 623 | CHECK_END(leftblock->rightlink); |
| 624 | freeblock(leftblock); |
| 625 | return; |
| 626 | |
| 627 | alternate_method: |
| 628 | while (Py_SIZE(deque)) { |
| 629 | item = deque_pop(deque, NULL); |
| 630 | assert (item != NULL); |
| 631 | Py_DECREF(item); |
| 632 | } |
| 633 | } |
| 634 | |
| 635 | static PyObject * |
| 636 | deque_clearmethod(dequeobject *deque) |
| 637 | { |
| 638 | deque_clear(deque); |
| 639 | Py_RETURN_NONE; |
| 640 | } |
| 641 | |
| 642 | PyDoc_STRVAR(clear_doc, "Remove all elements from the deque."); |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 643 | |
| 644 | static PyObject * |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 645 | deque_inplace_repeat(dequeobject *deque, Py_ssize_t n) |
| 646 | { |
Raymond Hettinger | c22eee6 | 2015-09-26 02:14:50 -0700 | [diff] [blame] | 647 | Py_ssize_t i, m, size; |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 648 | PyObject *seq; |
| 649 | PyObject *rv; |
| 650 | |
| 651 | size = Py_SIZE(deque); |
| 652 | if (size == 0 || n == 1) { |
| 653 | Py_INCREF(deque); |
| 654 | return (PyObject *)deque; |
| 655 | } |
| 656 | |
| 657 | if (n <= 0) { |
| 658 | deque_clear(deque); |
| 659 | Py_INCREF(deque); |
| 660 | return (PyObject *)deque; |
| 661 | } |
| 662 | |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 663 | if (size == 1) { |
| 664 | /* common case, repeating a single element */ |
| 665 | PyObject *item = deque->leftblock->data[deque->leftindex]; |
| 666 | |
Raymond Hettinger | a7f63009 | 2015-10-10 23:56:02 -0400 | [diff] [blame] | 667 | if (deque->maxlen >= 0 && n > deque->maxlen) |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 668 | n = deque->maxlen; |
| 669 | |
Raymond Hettinger | 67c78b5 | 2015-09-12 11:00:20 -0400 | [diff] [blame] | 670 | deque->state++; |
Raymond Hettinger | ad26225 | 2015-09-14 01:03:04 -0400 | [diff] [blame] | 671 | for (i = 0 ; i < n-1 ; ) { |
Raymond Hettinger | 67c78b5 | 2015-09-12 11:00:20 -0400 | [diff] [blame] | 672 | if (deque->rightindex == BLOCKLEN - 1) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 673 | block *b = newblock(); |
Raymond Hettinger | 67c78b5 | 2015-09-12 11:00:20 -0400 | [diff] [blame] | 674 | if (b == NULL) { |
| 675 | Py_SIZE(deque) += i; |
| 676 | return NULL; |
| 677 | } |
| 678 | b->leftlink = deque->rightblock; |
| 679 | CHECK_END(deque->rightblock->rightlink); |
| 680 | deque->rightblock->rightlink = b; |
| 681 | deque->rightblock = b; |
| 682 | MARK_END(b->rightlink); |
| 683 | deque->rightindex = -1; |
| 684 | } |
Raymond Hettinger | c22eee6 | 2015-09-26 02:14:50 -0700 | [diff] [blame] | 685 | m = n - 1 - i; |
| 686 | if (m > BLOCKLEN - 1 - deque->rightindex) |
| 687 | m = BLOCKLEN - 1 - deque->rightindex; |
| 688 | i += m; |
| 689 | while (m--) { |
Raymond Hettinger | ad26225 | 2015-09-14 01:03:04 -0400 | [diff] [blame] | 690 | deque->rightindex++; |
| 691 | Py_INCREF(item); |
| 692 | deque->rightblock->data[deque->rightindex] = item; |
| 693 | } |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 694 | } |
Raymond Hettinger | 67c78b5 | 2015-09-12 11:00:20 -0400 | [diff] [blame] | 695 | Py_SIZE(deque) += i; |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 696 | Py_INCREF(deque); |
| 697 | return (PyObject *)deque; |
| 698 | } |
| 699 | |
Raymond Hettinger | 20151f5 | 2015-10-16 22:47:29 -0700 | [diff] [blame] | 700 | if ((size_t)size > PY_SSIZE_T_MAX / (size_t)n) { |
Raymond Hettinger | f5d72f3 | 2015-09-09 22:39:44 -0400 | [diff] [blame] | 701 | return PyErr_NoMemory(); |
| 702 | } |
| 703 | |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 704 | seq = PySequence_List((PyObject *)deque); |
| 705 | if (seq == NULL) |
| 706 | return seq; |
| 707 | |
| 708 | for (i = 0 ; i < n-1 ; i++) { |
| 709 | rv = deque_extend(deque, seq); |
| 710 | if (rv == NULL) { |
| 711 | Py_DECREF(seq); |
| 712 | return NULL; |
| 713 | } |
| 714 | Py_DECREF(rv); |
| 715 | } |
| 716 | Py_INCREF(deque); |
| 717 | Py_DECREF(seq); |
| 718 | return (PyObject *)deque; |
| 719 | } |
| 720 | |
Raymond Hettinger | f5d72f3 | 2015-09-09 22:39:44 -0400 | [diff] [blame] | 721 | static PyObject * |
| 722 | deque_repeat(dequeobject *deque, Py_ssize_t n) |
| 723 | { |
| 724 | dequeobject *new_deque; |
Raymond Hettinger | 95e2cc5 | 2015-09-13 02:41:18 -0400 | [diff] [blame] | 725 | PyObject *rv; |
Raymond Hettinger | f5d72f3 | 2015-09-09 22:39:44 -0400 | [diff] [blame] | 726 | |
| 727 | new_deque = (dequeobject *)deque_copy((PyObject *) deque); |
| 728 | if (new_deque == NULL) |
| 729 | return NULL; |
Raymond Hettinger | 95e2cc5 | 2015-09-13 02:41:18 -0400 | [diff] [blame] | 730 | rv = deque_inplace_repeat(new_deque, n); |
| 731 | Py_DECREF(new_deque); |
| 732 | return rv; |
Raymond Hettinger | f5d72f3 | 2015-09-09 22:39:44 -0400 | [diff] [blame] | 733 | } |
| 734 | |
Raymond Hettinger | 5402315 | 2014-04-23 00:58:48 -0700 | [diff] [blame] | 735 | /* The rotate() method is part of the public API and is used internally |
| 736 | as a primitive for other methods. |
| 737 | |
| 738 | Rotation by 1 or -1 is a common case, so any optimizations for high |
| 739 | volume rotations should take care not to penalize the common case. |
| 740 | |
| 741 | Conceptually, a rotate by one is equivalent to a pop on one side and an |
| 742 | append on the other. However, a pop/append pair is unnecessarily slow |
Martin Panter | d2ad571 | 2015-11-02 04:20:33 +0000 | [diff] [blame] | 743 | because it requires an incref/decref pair for an object located randomly |
Raymond Hettinger | 5402315 | 2014-04-23 00:58:48 -0700 | [diff] [blame] | 744 | in memory. It is better to just move the object pointer from one block |
| 745 | to the next without changing the reference count. |
| 746 | |
| 747 | When moving batches of pointers, it is tempting to use memcpy() but that |
| 748 | proved to be slower than a simple loop for a variety of reasons. |
| 749 | Memcpy() cannot know in advance that we're copying pointers instead of |
| 750 | bytes, that the source and destination are pointer aligned and |
| 751 | non-overlapping, that moving just one pointer is a common case, that we |
| 752 | never need to move more than BLOCKLEN pointers, and that at least one |
| 753 | pointer is always moved. |
| 754 | |
| 755 | For high volume rotations, newblock() and freeblock() are never called |
| 756 | more than once. Previously emptied blocks are immediately reused as a |
| 757 | destination block. If a block is left-over at the end, it is freed. |
| 758 | */ |
| 759 | |
Raymond Hettinger | dcb9d94 | 2004-10-09 16:02:18 +0000 | [diff] [blame] | 760 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 761 | _deque_rotate(dequeobject *deque, Py_ssize_t n) |
Raymond Hettinger | 5c5eb86 | 2004-02-07 21:13:00 +0000 | [diff] [blame] | 762 | { |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 763 | block *b = NULL; |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 764 | block *leftblock = deque->leftblock; |
| 765 | block *rightblock = deque->rightblock; |
| 766 | Py_ssize_t leftindex = deque->leftindex; |
| 767 | Py_ssize_t rightindex = deque->rightindex; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 768 | Py_ssize_t len=Py_SIZE(deque), halflen=len>>1; |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 769 | int rv = -1; |
Raymond Hettinger | 5c5eb86 | 2004-02-07 21:13:00 +0000 | [diff] [blame] | 770 | |
Raymond Hettinger | 464d89b | 2013-01-11 22:29:50 -0800 | [diff] [blame] | 771 | if (len <= 1) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 772 | return 0; |
| 773 | if (n > halflen || n < -halflen) { |
| 774 | n %= len; |
| 775 | if (n > halflen) |
| 776 | n -= len; |
| 777 | else if (n < -halflen) |
| 778 | n += len; |
| 779 | } |
Raymond Hettinger | 1f0044c | 2013-02-05 01:30:46 -0500 | [diff] [blame] | 780 | assert(len > 1); |
Raymond Hettinger | a4409c1 | 2013-02-04 00:08:12 -0500 | [diff] [blame] | 781 | assert(-halflen <= n && n <= halflen); |
Raymond Hettinger | 231ee4d | 2013-02-02 11:24:43 -0800 | [diff] [blame] | 782 | |
Raymond Hettinger | 464d89b | 2013-01-11 22:29:50 -0800 | [diff] [blame] | 783 | deque->state++; |
Raymond Hettinger | 1f0044c | 2013-02-05 01:30:46 -0500 | [diff] [blame] | 784 | while (n > 0) { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 785 | if (leftindex == 0) { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 786 | if (b == NULL) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 787 | b = newblock(); |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 788 | if (b == NULL) |
| 789 | goto done; |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 790 | } |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 791 | b->rightlink = leftblock; |
| 792 | CHECK_END(leftblock->leftlink); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 793 | leftblock->leftlink = b; |
| 794 | leftblock = b; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 795 | MARK_END(b->leftlink); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 796 | leftindex = BLOCKLEN; |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 797 | b = NULL; |
Raymond Hettinger | 464d89b | 2013-01-11 22:29:50 -0800 | [diff] [blame] | 798 | } |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 799 | assert(leftindex > 0); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 800 | { |
| 801 | PyObject **src, **dest; |
| 802 | Py_ssize_t m = n; |
Raymond Hettinger | 21777ac | 2013-02-02 09:56:08 -0800 | [diff] [blame] | 803 | |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 804 | if (m > rightindex + 1) |
| 805 | m = rightindex + 1; |
| 806 | if (m > leftindex) |
| 807 | m = leftindex; |
| 808 | assert (m > 0 && m <= len); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 809 | rightindex -= m; |
| 810 | leftindex -= m; |
Raymond Hettinger | 0e259f1 | 2015-02-01 22:53:41 -0800 | [diff] [blame] | 811 | src = &rightblock->data[rightindex + 1]; |
| 812 | dest = &leftblock->data[leftindex]; |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 813 | n -= m; |
Raymond Hettinger | 840533b | 2013-07-13 17:03:58 -0700 | [diff] [blame] | 814 | do { |
Raymond Hettinger | 0e259f1 | 2015-02-01 22:53:41 -0800 | [diff] [blame] | 815 | *(dest++) = *(src++); |
Raymond Hettinger | 840533b | 2013-07-13 17:03:58 -0700 | [diff] [blame] | 816 | } while (--m); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 817 | } |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 818 | if (rightindex < 0) { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 819 | assert(leftblock != rightblock); |
Raymond Hettinger | 840533b | 2013-07-13 17:03:58 -0700 | [diff] [blame] | 820 | assert(b == NULL); |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 821 | b = rightblock; |
Raymond Hettinger | b97cc49 | 2013-07-21 01:51:07 -0700 | [diff] [blame] | 822 | CHECK_NOT_END(rightblock->leftlink); |
| 823 | rightblock = rightblock->leftlink; |
| 824 | MARK_END(rightblock->rightlink); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 825 | rightindex = BLOCKLEN - 1; |
Raymond Hettinger | 464d89b | 2013-01-11 22:29:50 -0800 | [diff] [blame] | 826 | } |
Raymond Hettinger | 21777ac | 2013-02-02 09:56:08 -0800 | [diff] [blame] | 827 | } |
Raymond Hettinger | 1f0044c | 2013-02-05 01:30:46 -0500 | [diff] [blame] | 828 | while (n < 0) { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 829 | if (rightindex == BLOCKLEN - 1) { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 830 | if (b == NULL) { |
Raymond Hettinger | db41fd4 | 2015-10-22 22:48:16 -0700 | [diff] [blame] | 831 | b = newblock(); |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 832 | if (b == NULL) |
| 833 | goto done; |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 834 | } |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 835 | b->leftlink = rightblock; |
| 836 | CHECK_END(rightblock->rightlink); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 837 | rightblock->rightlink = b; |
| 838 | rightblock = b; |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 839 | MARK_END(b->rightlink); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 840 | rightindex = -1; |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 841 | b = NULL; |
Raymond Hettinger | 464d89b | 2013-01-11 22:29:50 -0800 | [diff] [blame] | 842 | } |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 843 | assert (rightindex < BLOCKLEN - 1); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 844 | { |
| 845 | PyObject **src, **dest; |
| 846 | Py_ssize_t m = -n; |
Raymond Hettinger | 21777ac | 2013-02-02 09:56:08 -0800 | [diff] [blame] | 847 | |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 848 | if (m > BLOCKLEN - leftindex) |
| 849 | m = BLOCKLEN - leftindex; |
| 850 | if (m > BLOCKLEN - 1 - rightindex) |
| 851 | m = BLOCKLEN - 1 - rightindex; |
| 852 | assert (m > 0 && m <= len); |
| 853 | src = &leftblock->data[leftindex]; |
| 854 | dest = &rightblock->data[rightindex + 1]; |
| 855 | leftindex += m; |
| 856 | rightindex += m; |
| 857 | n += m; |
Raymond Hettinger | 840533b | 2013-07-13 17:03:58 -0700 | [diff] [blame] | 858 | do { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 859 | *(dest++) = *(src++); |
Raymond Hettinger | 840533b | 2013-07-13 17:03:58 -0700 | [diff] [blame] | 860 | } while (--m); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 861 | } |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 862 | if (leftindex == BLOCKLEN) { |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 863 | assert(leftblock != rightblock); |
Raymond Hettinger | 840533b | 2013-07-13 17:03:58 -0700 | [diff] [blame] | 864 | assert(b == NULL); |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 865 | b = leftblock; |
Raymond Hettinger | b97cc49 | 2013-07-21 01:51:07 -0700 | [diff] [blame] | 866 | CHECK_NOT_END(leftblock->rightlink); |
| 867 | leftblock = leftblock->rightlink; |
| 868 | MARK_END(leftblock->leftlink); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 869 | leftindex = 0; |
Raymond Hettinger | 21777ac | 2013-02-02 09:56:08 -0800 | [diff] [blame] | 870 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 871 | } |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 872 | rv = 0; |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 873 | done: |
Raymond Hettinger | 3959af9 | 2013-07-13 02:34:08 -0700 | [diff] [blame] | 874 | if (b != NULL) |
| 875 | freeblock(b); |
Raymond Hettinger | 20b0f87 | 2013-06-23 15:44:33 -0700 | [diff] [blame] | 876 | deque->leftblock = leftblock; |
| 877 | deque->rightblock = rightblock; |
| 878 | deque->leftindex = leftindex; |
| 879 | deque->rightindex = rightindex; |
| 880 | |
| 881 | return rv; |
Raymond Hettinger | dcb9d94 | 2004-10-09 16:02:18 +0000 | [diff] [blame] | 882 | } |
| 883 | |
| 884 | static PyObject * |
| 885 | deque_rotate(dequeobject *deque, PyObject *args) |
| 886 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 887 | Py_ssize_t n=1; |
Raymond Hettinger | dcb9d94 | 2004-10-09 16:02:18 +0000 | [diff] [blame] | 888 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 889 | if (!PyArg_ParseTuple(args, "|n:rotate", &n)) |
| 890 | return NULL; |
Raymond Hettinger | 6921c13 | 2015-03-21 02:03:40 -0700 | [diff] [blame] | 891 | if (!_deque_rotate(deque, n)) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 892 | Py_RETURN_NONE; |
| 893 | return NULL; |
Raymond Hettinger | 5c5eb86 | 2004-02-07 21:13:00 +0000 | [diff] [blame] | 894 | } |
| 895 | |
Tim Peters | 1065f75 | 2004-10-01 01:03:29 +0000 | [diff] [blame] | 896 | PyDoc_STRVAR(rotate_doc, |
Raymond Hettinger | ee33b27 | 2004-02-08 04:05:26 +0000 | [diff] [blame] | 897 | "Rotate the deque n steps to the right (default n=1). If n is negative, rotates left."); |
Raymond Hettinger | 5c5eb86 | 2004-02-07 21:13:00 +0000 | [diff] [blame] | 898 | |
Raymond Hettinger | e5fdedb | 2009-12-10 00:47:21 +0000 | [diff] [blame] | 899 | static PyObject * |
| 900 | deque_reverse(dequeobject *deque, PyObject *unused) |
| 901 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 902 | block *leftblock = deque->leftblock; |
| 903 | block *rightblock = deque->rightblock; |
| 904 | Py_ssize_t leftindex = deque->leftindex; |
| 905 | Py_ssize_t rightindex = deque->rightindex; |
Raymond Hettinger | cfe5b6c | 2015-07-20 00:25:50 -0400 | [diff] [blame] | 906 | Py_ssize_t n = Py_SIZE(deque) >> 1; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 907 | PyObject *tmp; |
Raymond Hettinger | e5fdedb | 2009-12-10 00:47:21 +0000 | [diff] [blame] | 908 | |
Raymond Hettinger | 7a23723 | 2015-09-22 01:20:36 -0700 | [diff] [blame] | 909 | while (n-- > 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 910 | /* Validate that pointers haven't met in the middle */ |
| 911 | assert(leftblock != rightblock || leftindex < rightindex); |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 912 | CHECK_NOT_END(leftblock); |
| 913 | CHECK_NOT_END(rightblock); |
Raymond Hettinger | e5fdedb | 2009-12-10 00:47:21 +0000 | [diff] [blame] | 914 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 915 | /* Swap */ |
| 916 | tmp = leftblock->data[leftindex]; |
| 917 | leftblock->data[leftindex] = rightblock->data[rightindex]; |
| 918 | rightblock->data[rightindex] = tmp; |
Raymond Hettinger | e5fdedb | 2009-12-10 00:47:21 +0000 | [diff] [blame] | 919 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 920 | /* Advance left block/index pair */ |
| 921 | leftindex++; |
| 922 | if (leftindex == BLOCKLEN) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 923 | leftblock = leftblock->rightlink; |
| 924 | leftindex = 0; |
| 925 | } |
Raymond Hettinger | e5fdedb | 2009-12-10 00:47:21 +0000 | [diff] [blame] | 926 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 927 | /* Step backwards with the right block/index pair */ |
| 928 | rightindex--; |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 929 | if (rightindex < 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 930 | rightblock = rightblock->leftlink; |
| 931 | rightindex = BLOCKLEN - 1; |
| 932 | } |
| 933 | } |
| 934 | Py_RETURN_NONE; |
Raymond Hettinger | e5fdedb | 2009-12-10 00:47:21 +0000 | [diff] [blame] | 935 | } |
| 936 | |
| 937 | PyDoc_STRVAR(reverse_doc, |
| 938 | "D.reverse() -- reverse *IN PLACE*"); |
| 939 | |
Raymond Hettinger | 44459de | 2010-04-03 23:20:46 +0000 | [diff] [blame] | 940 | static PyObject * |
| 941 | deque_count(dequeobject *deque, PyObject *v) |
| 942 | { |
Raymond Hettinger | f3a67b7 | 2013-07-06 17:49:06 -1000 | [diff] [blame] | 943 | block *b = deque->leftblock; |
| 944 | Py_ssize_t index = deque->leftindex; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 945 | Py_ssize_t n = Py_SIZE(deque); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 946 | Py_ssize_t count = 0; |
Raymond Hettinger | f9d9c79 | 2015-03-02 22:47:46 -0800 | [diff] [blame] | 947 | size_t start_state = deque->state; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 948 | PyObject *item; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 949 | int cmp; |
Raymond Hettinger | 44459de | 2010-04-03 23:20:46 +0000 | [diff] [blame] | 950 | |
Raymond Hettinger | 3a1a8d0 | 2015-09-23 02:42:02 -0700 | [diff] [blame] | 951 | while (n--) { |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 952 | CHECK_NOT_END(b); |
Raymond Hettinger | f3a67b7 | 2013-07-06 17:49:06 -1000 | [diff] [blame] | 953 | item = b->data[index]; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 954 | cmp = PyObject_RichCompareBool(item, v, Py_EQ); |
Raymond Hettinger | 2b0d646 | 2015-09-23 19:15:44 -0700 | [diff] [blame] | 955 | if (cmp < 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 956 | return NULL; |
Raymond Hettinger | 2b0d646 | 2015-09-23 19:15:44 -0700 | [diff] [blame] | 957 | count += cmp; |
Raymond Hettinger | 44459de | 2010-04-03 23:20:46 +0000 | [diff] [blame] | 958 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 959 | if (start_state != deque->state) { |
| 960 | PyErr_SetString(PyExc_RuntimeError, |
| 961 | "deque mutated during iteration"); |
| 962 | return NULL; |
| 963 | } |
Raymond Hettinger | 44459de | 2010-04-03 23:20:46 +0000 | [diff] [blame] | 964 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 965 | /* Advance left block/index pair */ |
Raymond Hettinger | f3a67b7 | 2013-07-06 17:49:06 -1000 | [diff] [blame] | 966 | index++; |
| 967 | if (index == BLOCKLEN) { |
| 968 | b = b->rightlink; |
| 969 | index = 0; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 970 | } |
| 971 | } |
| 972 | return PyLong_FromSsize_t(count); |
Raymond Hettinger | 44459de | 2010-04-03 23:20:46 +0000 | [diff] [blame] | 973 | } |
| 974 | |
| 975 | PyDoc_STRVAR(count_doc, |
| 976 | "D.count(value) -> integer -- return number of occurrences of value"); |
| 977 | |
Raymond Hettinger | 39dadf7 | 2015-03-20 16:38:56 -0700 | [diff] [blame] | 978 | static int |
| 979 | deque_contains(dequeobject *deque, PyObject *v) |
| 980 | { |
| 981 | block *b = deque->leftblock; |
| 982 | Py_ssize_t index = deque->leftindex; |
| 983 | Py_ssize_t n = Py_SIZE(deque); |
Raymond Hettinger | 39dadf7 | 2015-03-20 16:38:56 -0700 | [diff] [blame] | 984 | size_t start_state = deque->state; |
| 985 | PyObject *item; |
| 986 | int cmp; |
| 987 | |
Raymond Hettinger | 3a1a8d0 | 2015-09-23 02:42:02 -0700 | [diff] [blame] | 988 | while (n--) { |
Raymond Hettinger | 39dadf7 | 2015-03-20 16:38:56 -0700 | [diff] [blame] | 989 | CHECK_NOT_END(b); |
| 990 | item = b->data[index]; |
| 991 | cmp = PyObject_RichCompareBool(item, v, Py_EQ); |
| 992 | if (cmp) { |
| 993 | return cmp; |
| 994 | } |
| 995 | if (start_state != deque->state) { |
| 996 | PyErr_SetString(PyExc_RuntimeError, |
| 997 | "deque mutated during iteration"); |
| 998 | return -1; |
| 999 | } |
| 1000 | index++; |
| 1001 | if (index == BLOCKLEN) { |
| 1002 | b = b->rightlink; |
| 1003 | index = 0; |
| 1004 | } |
| 1005 | } |
| 1006 | return 0; |
| 1007 | } |
| 1008 | |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 1009 | static Py_ssize_t |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1010 | deque_len(dequeobject *deque) |
| 1011 | { |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1012 | return Py_SIZE(deque); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1013 | } |
| 1014 | |
Raymond Hettinger | 4aec61e | 2005-03-18 21:20:23 +0000 | [diff] [blame] | 1015 | static PyObject * |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1016 | deque_index(dequeobject *deque, PyObject *args) |
| 1017 | { |
Raymond Hettinger | 67b97b8 | 2015-11-01 23:57:37 -0500 | [diff] [blame] | 1018 | Py_ssize_t i, n, start=0, stop=Py_SIZE(deque); |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1019 | PyObject *v, *item; |
| 1020 | block *b = deque->leftblock; |
| 1021 | Py_ssize_t index = deque->leftindex; |
| 1022 | size_t start_state = deque->state; |
Raymond Hettinger | 67b97b8 | 2015-11-01 23:57:37 -0500 | [diff] [blame] | 1023 | int cmp; |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1024 | |
| 1025 | if (!PyArg_ParseTuple(args, "O|O&O&:index", &v, |
| 1026 | _PyEval_SliceIndex, &start, |
| 1027 | _PyEval_SliceIndex, &stop)) |
| 1028 | return NULL; |
| 1029 | if (start < 0) { |
| 1030 | start += Py_SIZE(deque); |
| 1031 | if (start < 0) |
| 1032 | start = 0; |
| 1033 | } |
| 1034 | if (stop < 0) { |
| 1035 | stop += Py_SIZE(deque); |
| 1036 | if (stop < 0) |
| 1037 | stop = 0; |
| 1038 | } |
Raymond Hettinger | 87674ec | 2015-08-26 08:08:38 -0700 | [diff] [blame] | 1039 | if (stop > Py_SIZE(deque)) |
| 1040 | stop = Py_SIZE(deque); |
Raymond Hettinger | 67b97b8 | 2015-11-01 23:57:37 -0500 | [diff] [blame] | 1041 | if (start > stop) |
| 1042 | start = stop; |
| 1043 | assert(0 <= start && start <= stop && stop <= Py_SIZE(deque)); |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1044 | |
Raymond Hettinger | 67b97b8 | 2015-11-01 23:57:37 -0500 | [diff] [blame] | 1045 | /* XXX Replace this loop with faster code from deque_item() */ |
| 1046 | for (i=0 ; i<start ; i++) { |
| 1047 | index++; |
| 1048 | if (index == BLOCKLEN) { |
| 1049 | b = b->rightlink; |
| 1050 | index = 0; |
| 1051 | } |
| 1052 | } |
| 1053 | |
Raymond Hettinger | 4a91d21 | 2015-11-03 22:00:26 -0500 | [diff] [blame] | 1054 | n = stop - i + 1; |
| 1055 | while (--n) { |
Raymond Hettinger | 67b97b8 | 2015-11-01 23:57:37 -0500 | [diff] [blame] | 1056 | CHECK_NOT_END(b); |
| 1057 | item = b->data[index]; |
| 1058 | cmp = PyObject_RichCompareBool(item, v, Py_EQ); |
| 1059 | if (cmp > 0) |
Raymond Hettinger | 4a91d21 | 2015-11-03 22:00:26 -0500 | [diff] [blame] | 1060 | return PyLong_FromSsize_t(stop - n); |
Raymond Hettinger | df8f5b5 | 2015-11-02 07:27:40 -0500 | [diff] [blame] | 1061 | if (cmp < 0) |
Raymond Hettinger | 67b97b8 | 2015-11-01 23:57:37 -0500 | [diff] [blame] | 1062 | return NULL; |
| 1063 | if (start_state != deque->state) { |
| 1064 | PyErr_SetString(PyExc_RuntimeError, |
| 1065 | "deque mutated during iteration"); |
| 1066 | return NULL; |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1067 | } |
| 1068 | index++; |
| 1069 | if (index == BLOCKLEN) { |
| 1070 | b = b->rightlink; |
| 1071 | index = 0; |
| 1072 | } |
| 1073 | } |
| 1074 | PyErr_Format(PyExc_ValueError, "%R is not in deque", v); |
| 1075 | return NULL; |
| 1076 | } |
| 1077 | |
| 1078 | PyDoc_STRVAR(index_doc, |
| 1079 | "D.index(value, [start, [stop]]) -> integer -- return first index of value.\n" |
| 1080 | "Raises ValueError if the value is not present."); |
| 1081 | |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 1082 | /* insert(), remove(), and delitem() are implemented in terms of |
| 1083 | rotate() for simplicity and reasonable performance near the end |
| 1084 | points. If for some reason these methods become popular, it is not |
| 1085 | hard to re-implement this using direct data movement (similar to |
| 1086 | the code used in list slice assignments) and achieve a performance |
Raymond Hettinger | fef9c1b | 2015-03-24 21:12:57 -0700 | [diff] [blame] | 1087 | boost (by moving each pointer only once instead of twice). |
Raymond Hettinger | 551350a | 2015-03-24 00:19:53 -0700 | [diff] [blame] | 1088 | */ |
| 1089 | |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1090 | static PyObject * |
| 1091 | deque_insert(dequeobject *deque, PyObject *args) |
| 1092 | { |
| 1093 | Py_ssize_t index; |
| 1094 | Py_ssize_t n = Py_SIZE(deque); |
| 1095 | PyObject *value; |
| 1096 | PyObject *rv; |
| 1097 | |
| 1098 | if (!PyArg_ParseTuple(args, "nO:insert", &index, &value)) |
| 1099 | return NULL; |
| 1100 | if (index >= n) |
| 1101 | return deque_append(deque, value); |
| 1102 | if (index <= -n || index == 0) |
| 1103 | return deque_appendleft(deque, value); |
| 1104 | if (_deque_rotate(deque, -index)) |
| 1105 | return NULL; |
| 1106 | if (index < 0) |
| 1107 | rv = deque_append(deque, value); |
| 1108 | else |
| 1109 | rv = deque_appendleft(deque, value); |
| 1110 | if (rv == NULL) |
| 1111 | return NULL; |
| 1112 | Py_DECREF(rv); |
| 1113 | if (_deque_rotate(deque, index)) |
| 1114 | return NULL; |
| 1115 | Py_RETURN_NONE; |
| 1116 | } |
| 1117 | |
| 1118 | PyDoc_STRVAR(insert_doc, |
| 1119 | "D.insert(index, object) -- insert object before index"); |
| 1120 | |
| 1121 | static PyObject * |
Raymond Hettinger | 4aec61e | 2005-03-18 21:20:23 +0000 | [diff] [blame] | 1122 | deque_remove(dequeobject *deque, PyObject *value) |
| 1123 | { |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1124 | Py_ssize_t i, n=Py_SIZE(deque); |
Raymond Hettinger | 4aec61e | 2005-03-18 21:20:23 +0000 | [diff] [blame] | 1125 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1126 | for (i=0 ; i<n ; i++) { |
| 1127 | PyObject *item = deque->leftblock->data[deque->leftindex]; |
| 1128 | int cmp = PyObject_RichCompareBool(item, value, Py_EQ); |
Raymond Hettinger | d73202c | 2005-03-19 00:00:51 +0000 | [diff] [blame] | 1129 | |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1130 | if (Py_SIZE(deque) != n) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1131 | PyErr_SetString(PyExc_IndexError, |
| 1132 | "deque mutated during remove()."); |
| 1133 | return NULL; |
| 1134 | } |
| 1135 | if (cmp > 0) { |
| 1136 | PyObject *tgt = deque_popleft(deque, NULL); |
| 1137 | assert (tgt != NULL); |
Raymond Hettinger | 6921c13 | 2015-03-21 02:03:40 -0700 | [diff] [blame] | 1138 | if (_deque_rotate(deque, i)) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1139 | return NULL; |
Raymond Hettinger | ac13ad6 | 2015-03-21 01:53:16 -0700 | [diff] [blame] | 1140 | Py_DECREF(tgt); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1141 | Py_RETURN_NONE; |
| 1142 | } |
| 1143 | else if (cmp < 0) { |
| 1144 | _deque_rotate(deque, i); |
| 1145 | return NULL; |
| 1146 | } |
| 1147 | _deque_rotate(deque, -1); |
| 1148 | } |
| 1149 | PyErr_SetString(PyExc_ValueError, "deque.remove(x): x not in deque"); |
| 1150 | return NULL; |
Raymond Hettinger | 4aec61e | 2005-03-18 21:20:23 +0000 | [diff] [blame] | 1151 | } |
| 1152 | |
| 1153 | PyDoc_STRVAR(remove_doc, |
| 1154 | "D.remove(value) -- remove first occurrence of value."); |
| 1155 | |
Raymond Hettinger | 3c186ba | 2015-03-02 21:45:02 -0800 | [diff] [blame] | 1156 | static int |
| 1157 | valid_index(Py_ssize_t i, Py_ssize_t limit) |
| 1158 | { |
Raymond Hettinger | 12f896c | 2015-07-31 12:03:20 -0700 | [diff] [blame] | 1159 | /* The cast to size_t lets us use just a single comparison |
Raymond Hettinger | 3c186ba | 2015-03-02 21:45:02 -0800 | [diff] [blame] | 1160 | to check whether i is in the range: 0 <= i < limit */ |
| 1161 | return (size_t) i < (size_t) limit; |
| 1162 | } |
| 1163 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1164 | static PyObject * |
Benjamin Peterson | d631371 | 2008-07-31 16:23:04 +0000 | [diff] [blame] | 1165 | deque_item(dequeobject *deque, Py_ssize_t i) |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1166 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1167 | block *b; |
| 1168 | PyObject *item; |
| 1169 | Py_ssize_t n, index=i; |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1170 | |
Raymond Hettinger | 3c186ba | 2015-03-02 21:45:02 -0800 | [diff] [blame] | 1171 | if (!valid_index(i, Py_SIZE(deque))) { |
| 1172 | PyErr_SetString(PyExc_IndexError, "deque index out of range"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1173 | return NULL; |
| 1174 | } |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1175 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1176 | if (i == 0) { |
| 1177 | i = deque->leftindex; |
| 1178 | b = deque->leftblock; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1179 | } else if (i == Py_SIZE(deque) - 1) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1180 | i = deque->rightindex; |
| 1181 | b = deque->rightblock; |
| 1182 | } else { |
| 1183 | i += deque->leftindex; |
Raymond Hettinger | c208308 | 2015-02-28 23:29:16 -0800 | [diff] [blame] | 1184 | n = (Py_ssize_t)((size_t) i / BLOCKLEN); |
| 1185 | i = (Py_ssize_t)((size_t) i % BLOCKLEN); |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1186 | if (index < (Py_SIZE(deque) >> 1)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1187 | b = deque->leftblock; |
| 1188 | while (n--) |
| 1189 | b = b->rightlink; |
| 1190 | } else { |
Raymond Hettinger | 63d1ff2 | 2015-02-28 07:41:30 -0800 | [diff] [blame] | 1191 | n = (Py_ssize_t)( |
Raymond Hettinger | c208308 | 2015-02-28 23:29:16 -0800 | [diff] [blame] | 1192 | ((size_t)(deque->leftindex + Py_SIZE(deque) - 1)) |
Raymond Hettinger | 63d1ff2 | 2015-02-28 07:41:30 -0800 | [diff] [blame] | 1193 | / BLOCKLEN - n); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1194 | b = deque->rightblock; |
| 1195 | while (n--) |
| 1196 | b = b->leftlink; |
| 1197 | } |
| 1198 | } |
| 1199 | item = b->data[i]; |
| 1200 | Py_INCREF(item); |
| 1201 | return item; |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1202 | } |
| 1203 | |
| 1204 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 1205 | deque_del_item(dequeobject *deque, Py_ssize_t i) |
Raymond Hettinger | 0e371f2 | 2004-05-12 20:55:56 +0000 | [diff] [blame] | 1206 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1207 | PyObject *item; |
Raymond Hettinger | ac13ad6 | 2015-03-21 01:53:16 -0700 | [diff] [blame] | 1208 | int rv; |
Raymond Hettinger | 0e371f2 | 2004-05-12 20:55:56 +0000 | [diff] [blame] | 1209 | |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1210 | assert (i >= 0 && i < Py_SIZE(deque)); |
Raymond Hettinger | 6921c13 | 2015-03-21 02:03:40 -0700 | [diff] [blame] | 1211 | if (_deque_rotate(deque, -i)) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1212 | return -1; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1213 | item = deque_popleft(deque, NULL); |
Raymond Hettinger | ac13ad6 | 2015-03-21 01:53:16 -0700 | [diff] [blame] | 1214 | rv = _deque_rotate(deque, i); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1215 | assert (item != NULL); |
| 1216 | Py_DECREF(item); |
Raymond Hettinger | ac13ad6 | 2015-03-21 01:53:16 -0700 | [diff] [blame] | 1217 | return rv; |
Raymond Hettinger | 0e371f2 | 2004-05-12 20:55:56 +0000 | [diff] [blame] | 1218 | } |
| 1219 | |
| 1220 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 1221 | deque_ass_item(dequeobject *deque, Py_ssize_t i, PyObject *v) |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1222 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1223 | block *b; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1224 | Py_ssize_t n, len=Py_SIZE(deque), halflen=(len+1)>>1, index=i; |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1225 | |
Raymond Hettinger | 3c186ba | 2015-03-02 21:45:02 -0800 | [diff] [blame] | 1226 | if (!valid_index(i, len)) { |
| 1227 | PyErr_SetString(PyExc_IndexError, "deque index out of range"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1228 | return -1; |
| 1229 | } |
| 1230 | if (v == NULL) |
| 1231 | return deque_del_item(deque, i); |
Raymond Hettinger | 0e371f2 | 2004-05-12 20:55:56 +0000 | [diff] [blame] | 1232 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1233 | i += deque->leftindex; |
Raymond Hettinger | c208308 | 2015-02-28 23:29:16 -0800 | [diff] [blame] | 1234 | n = (Py_ssize_t)((size_t) i / BLOCKLEN); |
| 1235 | i = (Py_ssize_t)((size_t) i % BLOCKLEN); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1236 | if (index <= halflen) { |
| 1237 | b = deque->leftblock; |
| 1238 | while (n--) |
| 1239 | b = b->rightlink; |
| 1240 | } else { |
Raymond Hettinger | a473b9d | 2015-02-28 17:49:47 -0800 | [diff] [blame] | 1241 | n = (Py_ssize_t)( |
Raymond Hettinger | c208308 | 2015-02-28 23:29:16 -0800 | [diff] [blame] | 1242 | ((size_t)(deque->leftindex + Py_SIZE(deque) - 1)) |
Raymond Hettinger | a473b9d | 2015-02-28 17:49:47 -0800 | [diff] [blame] | 1243 | / BLOCKLEN - n); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1244 | b = deque->rightblock; |
| 1245 | while (n--) |
| 1246 | b = b->leftlink; |
| 1247 | } |
| 1248 | Py_INCREF(v); |
Serhiy Storchaka | 1ed017a | 2015-12-27 15:51:32 +0200 | [diff] [blame] | 1249 | Py_SETREF(b->data[i], v); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1250 | return 0; |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1251 | } |
| 1252 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1253 | static void |
| 1254 | deque_dealloc(dequeobject *deque) |
| 1255 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1256 | PyObject_GC_UnTrack(deque); |
| 1257 | if (deque->weakreflist != NULL) |
| 1258 | PyObject_ClearWeakRefs((PyObject *) deque); |
| 1259 | if (deque->leftblock != NULL) { |
| 1260 | deque_clear(deque); |
| 1261 | assert(deque->leftblock != NULL); |
| 1262 | freeblock(deque->leftblock); |
| 1263 | } |
| 1264 | deque->leftblock = NULL; |
| 1265 | deque->rightblock = NULL; |
| 1266 | Py_TYPE(deque)->tp_free(deque); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1267 | } |
| 1268 | |
| 1269 | static int |
Raymond Hettinger | 0a4977c | 2004-03-01 23:16:22 +0000 | [diff] [blame] | 1270 | deque_traverse(dequeobject *deque, visitproc visit, void *arg) |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1271 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1272 | block *b; |
| 1273 | PyObject *item; |
| 1274 | Py_ssize_t index; |
| 1275 | Py_ssize_t indexlo = deque->leftindex; |
Raymond Hettinger | 1286d14 | 2015-10-14 23:16:57 -0700 | [diff] [blame] | 1276 | Py_ssize_t indexhigh; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1277 | |
Raymond Hettinger | 5bfa867 | 2013-07-06 11:58:09 -1000 | [diff] [blame] | 1278 | for (b = deque->leftblock; b != deque->rightblock; b = b->rightlink) { |
| 1279 | for (index = indexlo; index < BLOCKLEN ; index++) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1280 | item = b->data[index]; |
| 1281 | Py_VISIT(item); |
| 1282 | } |
| 1283 | indexlo = 0; |
| 1284 | } |
Raymond Hettinger | 1286d14 | 2015-10-14 23:16:57 -0700 | [diff] [blame] | 1285 | indexhigh = deque->rightindex; |
| 1286 | for (index = indexlo; index <= indexhigh; index++) { |
Raymond Hettinger | 5bfa867 | 2013-07-06 11:58:09 -1000 | [diff] [blame] | 1287 | item = b->data[index]; |
| 1288 | Py_VISIT(item); |
| 1289 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1290 | return 0; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1291 | } |
| 1292 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1293 | static PyObject * |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1294 | deque_reduce(dequeobject *deque) |
| 1295 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1296 | PyObject *dict, *result, *aslist; |
Martin v. Löwis | bd928fe | 2011-10-14 10:20:37 +0200 | [diff] [blame] | 1297 | _Py_IDENTIFIER(__dict__); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1298 | |
Martin v. Löwis | 1ee1b6f | 2011-10-10 18:11:30 +0200 | [diff] [blame] | 1299 | dict = _PyObject_GetAttrId((PyObject *)deque, &PyId___dict__); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1300 | if (dict == NULL) |
| 1301 | PyErr_Clear(); |
| 1302 | aslist = PySequence_List((PyObject *)deque); |
| 1303 | if (aslist == NULL) { |
| 1304 | Py_XDECREF(dict); |
| 1305 | return NULL; |
| 1306 | } |
| 1307 | if (dict == NULL) { |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 1308 | if (deque->maxlen < 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1309 | result = Py_BuildValue("O(O)", Py_TYPE(deque), aslist); |
| 1310 | else |
| 1311 | result = Py_BuildValue("O(On)", Py_TYPE(deque), aslist, deque->maxlen); |
| 1312 | } else { |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 1313 | if (deque->maxlen < 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1314 | result = Py_BuildValue("O(OO)O", Py_TYPE(deque), aslist, Py_None, dict); |
| 1315 | else |
| 1316 | result = Py_BuildValue("O(On)O", Py_TYPE(deque), aslist, deque->maxlen, dict); |
| 1317 | } |
| 1318 | Py_XDECREF(dict); |
| 1319 | Py_DECREF(aslist); |
| 1320 | return result; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1321 | } |
| 1322 | |
| 1323 | PyDoc_STRVAR(reduce_doc, "Return state information for pickling."); |
| 1324 | |
| 1325 | static PyObject * |
| 1326 | deque_repr(PyObject *deque) |
| 1327 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1328 | PyObject *aslist, *result; |
| 1329 | int i; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1330 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1331 | i = Py_ReprEnter(deque); |
| 1332 | if (i != 0) { |
| 1333 | if (i < 0) |
| 1334 | return NULL; |
| 1335 | return PyUnicode_FromString("[...]"); |
| 1336 | } |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1337 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1338 | aslist = PySequence_List(deque); |
| 1339 | if (aslist == NULL) { |
| 1340 | Py_ReprLeave(deque); |
| 1341 | return NULL; |
| 1342 | } |
Raymond Hettinger | a7f63009 | 2015-10-10 23:56:02 -0400 | [diff] [blame] | 1343 | if (((dequeobject *)deque)->maxlen >= 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1344 | result = PyUnicode_FromFormat("deque(%R, maxlen=%zd)", |
| 1345 | aslist, ((dequeobject *)deque)->maxlen); |
| 1346 | else |
| 1347 | result = PyUnicode_FromFormat("deque(%R)", aslist); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1348 | Py_ReprLeave(deque); |
Raymond Hettinger | 2b2b753 | 2015-09-05 17:05:52 -0700 | [diff] [blame] | 1349 | Py_DECREF(aslist); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1350 | return result; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1351 | } |
| 1352 | |
Raymond Hettinger | 738ec90 | 2004-02-29 02:15:56 +0000 | [diff] [blame] | 1353 | static PyObject * |
| 1354 | deque_richcompare(PyObject *v, PyObject *w, int op) |
| 1355 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1356 | PyObject *it1=NULL, *it2=NULL, *x, *y; |
| 1357 | Py_ssize_t vs, ws; |
| 1358 | int b, cmp=-1; |
Raymond Hettinger | 738ec90 | 2004-02-29 02:15:56 +0000 | [diff] [blame] | 1359 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1360 | if (!PyObject_TypeCheck(v, &deque_type) || |
| 1361 | !PyObject_TypeCheck(w, &deque_type)) { |
Brian Curtin | dfc80e3 | 2011-08-10 20:28:54 -0500 | [diff] [blame] | 1362 | Py_RETURN_NOTIMPLEMENTED; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1363 | } |
Raymond Hettinger | 738ec90 | 2004-02-29 02:15:56 +0000 | [diff] [blame] | 1364 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1365 | /* Shortcuts */ |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1366 | vs = Py_SIZE((dequeobject *)v); |
| 1367 | ws = Py_SIZE((dequeobject *)w); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1368 | if (op == Py_EQ) { |
| 1369 | if (v == w) |
| 1370 | Py_RETURN_TRUE; |
| 1371 | if (vs != ws) |
| 1372 | Py_RETURN_FALSE; |
| 1373 | } |
| 1374 | if (op == Py_NE) { |
| 1375 | if (v == w) |
| 1376 | Py_RETURN_FALSE; |
| 1377 | if (vs != ws) |
| 1378 | Py_RETURN_TRUE; |
| 1379 | } |
Raymond Hettinger | 738ec90 | 2004-02-29 02:15:56 +0000 | [diff] [blame] | 1380 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1381 | /* Search for the first index where items are different */ |
| 1382 | it1 = PyObject_GetIter(v); |
| 1383 | if (it1 == NULL) |
| 1384 | goto done; |
| 1385 | it2 = PyObject_GetIter(w); |
| 1386 | if (it2 == NULL) |
| 1387 | goto done; |
| 1388 | for (;;) { |
| 1389 | x = PyIter_Next(it1); |
| 1390 | if (x == NULL && PyErr_Occurred()) |
| 1391 | goto done; |
| 1392 | y = PyIter_Next(it2); |
| 1393 | if (x == NULL || y == NULL) |
| 1394 | break; |
| 1395 | b = PyObject_RichCompareBool(x, y, Py_EQ); |
| 1396 | if (b == 0) { |
| 1397 | cmp = PyObject_RichCompareBool(x, y, op); |
| 1398 | Py_DECREF(x); |
| 1399 | Py_DECREF(y); |
| 1400 | goto done; |
| 1401 | } |
| 1402 | Py_DECREF(x); |
| 1403 | Py_DECREF(y); |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 1404 | if (b < 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1405 | goto done; |
| 1406 | } |
| 1407 | /* We reached the end of one deque or both */ |
| 1408 | Py_XDECREF(x); |
| 1409 | Py_XDECREF(y); |
| 1410 | if (PyErr_Occurred()) |
| 1411 | goto done; |
| 1412 | switch (op) { |
| 1413 | case Py_LT: cmp = y != NULL; break; /* if w was longer */ |
| 1414 | case Py_LE: cmp = x == NULL; break; /* if v was not longer */ |
| 1415 | case Py_EQ: cmp = x == y; break; /* if we reached the end of both */ |
| 1416 | case Py_NE: cmp = x != y; break; /* if one deque continues */ |
| 1417 | case Py_GT: cmp = x != NULL; break; /* if v was longer */ |
| 1418 | case Py_GE: cmp = y == NULL; break; /* if w was not longer */ |
| 1419 | } |
Tim Peters | 1065f75 | 2004-10-01 01:03:29 +0000 | [diff] [blame] | 1420 | |
Raymond Hettinger | 738ec90 | 2004-02-29 02:15:56 +0000 | [diff] [blame] | 1421 | done: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1422 | Py_XDECREF(it1); |
| 1423 | Py_XDECREF(it2); |
| 1424 | if (cmp == 1) |
| 1425 | Py_RETURN_TRUE; |
| 1426 | if (cmp == 0) |
| 1427 | Py_RETURN_FALSE; |
| 1428 | return NULL; |
Raymond Hettinger | 738ec90 | 2004-02-29 02:15:56 +0000 | [diff] [blame] | 1429 | } |
| 1430 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1431 | static int |
Guido van Rossum | 8ce8a78 | 2007-11-01 19:42:39 +0000 | [diff] [blame] | 1432 | deque_init(dequeobject *deque, PyObject *args, PyObject *kwdargs) |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1433 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1434 | PyObject *iterable = NULL; |
| 1435 | PyObject *maxlenobj = NULL; |
| 1436 | Py_ssize_t maxlen = -1; |
| 1437 | char *kwlist[] = {"iterable", "maxlen", 0}; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1438 | |
Raymond Hettinger | 0d30940 | 2015-09-30 23:15:02 -0700 | [diff] [blame] | 1439 | if (kwdargs == NULL) { |
| 1440 | if (!PyArg_UnpackTuple(args, "deque()", 0, 2, &iterable, &maxlenobj)) |
| 1441 | return -1; |
| 1442 | } else { |
| 1443 | if (!PyArg_ParseTupleAndKeywords(args, kwdargs, "|OO:deque", kwlist, |
| 1444 | &iterable, &maxlenobj)) |
| 1445 | return -1; |
| 1446 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1447 | if (maxlenobj != NULL && maxlenobj != Py_None) { |
| 1448 | maxlen = PyLong_AsSsize_t(maxlenobj); |
| 1449 | if (maxlen == -1 && PyErr_Occurred()) |
| 1450 | return -1; |
| 1451 | if (maxlen < 0) { |
| 1452 | PyErr_SetString(PyExc_ValueError, "maxlen must be non-negative"); |
| 1453 | return -1; |
| 1454 | } |
| 1455 | } |
| 1456 | deque->maxlen = maxlen; |
Raymond Hettinger | 0d30940 | 2015-09-30 23:15:02 -0700 | [diff] [blame] | 1457 | if (Py_SIZE(deque) > 0) |
| 1458 | deque_clear(deque); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1459 | if (iterable != NULL) { |
| 1460 | PyObject *rv = deque_extend(deque, iterable); |
| 1461 | if (rv == NULL) |
| 1462 | return -1; |
| 1463 | Py_DECREF(rv); |
| 1464 | } |
| 1465 | return 0; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1466 | } |
| 1467 | |
Raymond Hettinger | 5bb0f0e | 2009-03-10 12:56:32 +0000 | [diff] [blame] | 1468 | static PyObject * |
Jesus Cea | 16e2fca | 2012-08-03 14:49:42 +0200 | [diff] [blame] | 1469 | deque_sizeof(dequeobject *deque, void *unused) |
| 1470 | { |
| 1471 | Py_ssize_t res; |
| 1472 | Py_ssize_t blocks; |
| 1473 | |
Serhiy Storchaka | 5c4064e | 2015-12-19 20:05:25 +0200 | [diff] [blame] | 1474 | res = _PyObject_SIZE(Py_TYPE(deque)); |
Raymond Hettinger | bc00341 | 2015-10-14 23:33:23 -0700 | [diff] [blame] | 1475 | blocks = (size_t)(deque->leftindex + Py_SIZE(deque) + BLOCKLEN - 1) / BLOCKLEN; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1476 | assert(deque->leftindex + Py_SIZE(deque) - 1 == |
Jesus Cea | 16e2fca | 2012-08-03 14:49:42 +0200 | [diff] [blame] | 1477 | (blocks - 1) * BLOCKLEN + deque->rightindex); |
| 1478 | res += blocks * sizeof(block); |
| 1479 | return PyLong_FromSsize_t(res); |
| 1480 | } |
| 1481 | |
| 1482 | PyDoc_STRVAR(sizeof_doc, |
| 1483 | "D.__sizeof__() -- size of D in memory, in bytes"); |
| 1484 | |
Raymond Hettinger | 0f1451c | 2015-03-23 23:23:55 -0700 | [diff] [blame] | 1485 | static int |
| 1486 | deque_bool(dequeobject *deque) |
| 1487 | { |
| 1488 | return Py_SIZE(deque) != 0; |
| 1489 | } |
| 1490 | |
Jesus Cea | 16e2fca | 2012-08-03 14:49:42 +0200 | [diff] [blame] | 1491 | static PyObject * |
Raymond Hettinger | 5bb0f0e | 2009-03-10 12:56:32 +0000 | [diff] [blame] | 1492 | deque_get_maxlen(dequeobject *deque) |
| 1493 | { |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 1494 | if (deque->maxlen < 0) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1495 | Py_RETURN_NONE; |
| 1496 | return PyLong_FromSsize_t(deque->maxlen); |
Raymond Hettinger | 5bb0f0e | 2009-03-10 12:56:32 +0000 | [diff] [blame] | 1497 | } |
| 1498 | |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 1499 | |
| 1500 | /* deque object ********************************************************/ |
| 1501 | |
Raymond Hettinger | 5bb0f0e | 2009-03-10 12:56:32 +0000 | [diff] [blame] | 1502 | static PyGetSetDef deque_getset[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1503 | {"maxlen", (getter)deque_get_maxlen, (setter)NULL, |
| 1504 | "maximum size of a deque or None if unbounded"}, |
| 1505 | {0} |
Raymond Hettinger | 5bb0f0e | 2009-03-10 12:56:32 +0000 | [diff] [blame] | 1506 | }; |
| 1507 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1508 | static PySequenceMethods deque_as_sequence = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1509 | (lenfunc)deque_len, /* sq_length */ |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 1510 | (binaryfunc)deque_concat, /* sq_concat */ |
| 1511 | (ssizeargfunc)deque_repeat, /* sq_repeat */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1512 | (ssizeargfunc)deque_item, /* sq_item */ |
| 1513 | 0, /* sq_slice */ |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1514 | (ssizeobjargproc)deque_ass_item, /* sq_ass_item */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1515 | 0, /* sq_ass_slice */ |
Raymond Hettinger | 39dadf7 | 2015-03-20 16:38:56 -0700 | [diff] [blame] | 1516 | (objobjproc)deque_contains, /* sq_contains */ |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1517 | (binaryfunc)deque_inplace_concat, /* sq_inplace_concat */ |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 1518 | (ssizeargfunc)deque_inplace_repeat, /* sq_inplace_repeat */ |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1519 | }; |
| 1520 | |
Raymond Hettinger | 0f1451c | 2015-03-23 23:23:55 -0700 | [diff] [blame] | 1521 | static PyNumberMethods deque_as_number = { |
| 1522 | 0, /* nb_add */ |
| 1523 | 0, /* nb_subtract */ |
| 1524 | 0, /* nb_multiply */ |
| 1525 | 0, /* nb_remainder */ |
| 1526 | 0, /* nb_divmod */ |
| 1527 | 0, /* nb_power */ |
| 1528 | 0, /* nb_negative */ |
| 1529 | 0, /* nb_positive */ |
| 1530 | 0, /* nb_absolute */ |
| 1531 | (inquiry)deque_bool, /* nb_bool */ |
| 1532 | 0, /* nb_invert */ |
Raymond Hettinger | 0f1451c | 2015-03-23 23:23:55 -0700 | [diff] [blame] | 1533 | }; |
| 1534 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1535 | static PyObject *deque_iter(dequeobject *deque); |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1536 | static PyObject *deque_reviter(dequeobject *deque); |
Tim Peters | 1065f75 | 2004-10-01 01:03:29 +0000 | [diff] [blame] | 1537 | PyDoc_STRVAR(reversed_doc, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1538 | "D.__reversed__() -- return a reverse iterator over the deque"); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1539 | |
| 1540 | static PyMethodDef deque_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1541 | {"append", (PyCFunction)deque_append, |
| 1542 | METH_O, append_doc}, |
| 1543 | {"appendleft", (PyCFunction)deque_appendleft, |
| 1544 | METH_O, appendleft_doc}, |
| 1545 | {"clear", (PyCFunction)deque_clearmethod, |
| 1546 | METH_NOARGS, clear_doc}, |
| 1547 | {"__copy__", (PyCFunction)deque_copy, |
| 1548 | METH_NOARGS, copy_doc}, |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1549 | {"copy", (PyCFunction)deque_copy, |
| 1550 | METH_NOARGS, copy_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1551 | {"count", (PyCFunction)deque_count, |
Raymond Hettinger | 0f6f947 | 2015-03-21 01:42:10 -0700 | [diff] [blame] | 1552 | METH_O, count_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1553 | {"extend", (PyCFunction)deque_extend, |
| 1554 | METH_O, extend_doc}, |
| 1555 | {"extendleft", (PyCFunction)deque_extendleft, |
| 1556 | METH_O, extendleft_doc}, |
Raymond Hettinger | 32ea165 | 2015-03-21 01:37:37 -0700 | [diff] [blame] | 1557 | {"index", (PyCFunction)deque_index, |
| 1558 | METH_VARARGS, index_doc}, |
| 1559 | {"insert", (PyCFunction)deque_insert, |
| 1560 | METH_VARARGS, insert_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1561 | {"pop", (PyCFunction)deque_pop, |
| 1562 | METH_NOARGS, pop_doc}, |
| 1563 | {"popleft", (PyCFunction)deque_popleft, |
| 1564 | METH_NOARGS, popleft_doc}, |
Raymond Hettinger | 0f6f947 | 2015-03-21 01:42:10 -0700 | [diff] [blame] | 1565 | {"__reduce__", (PyCFunction)deque_reduce, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1566 | METH_NOARGS, reduce_doc}, |
| 1567 | {"remove", (PyCFunction)deque_remove, |
| 1568 | METH_O, remove_doc}, |
| 1569 | {"__reversed__", (PyCFunction)deque_reviter, |
| 1570 | METH_NOARGS, reversed_doc}, |
| 1571 | {"reverse", (PyCFunction)deque_reverse, |
| 1572 | METH_NOARGS, reverse_doc}, |
| 1573 | {"rotate", (PyCFunction)deque_rotate, |
Jesus Cea | 16e2fca | 2012-08-03 14:49:42 +0200 | [diff] [blame] | 1574 | METH_VARARGS, rotate_doc}, |
| 1575 | {"__sizeof__", (PyCFunction)deque_sizeof, |
| 1576 | METH_NOARGS, sizeof_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1577 | {NULL, NULL} /* sentinel */ |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1578 | }; |
| 1579 | |
| 1580 | PyDoc_STRVAR(deque_doc, |
Andrew Svetlov | 6a5c7c3 | 2012-10-31 11:50:40 +0200 | [diff] [blame] | 1581 | "deque([iterable[, maxlen]]) --> deque object\n\ |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1582 | \n\ |
Raymond Hettinger | 41290a6 | 2015-03-31 08:12:23 -0700 | [diff] [blame] | 1583 | A list-like sequence optimized for data accesses near its endpoints."); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1584 | |
Neal Norwitz | 87f1013 | 2004-02-29 15:40:53 +0000 | [diff] [blame] | 1585 | static PyTypeObject deque_type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1586 | PyVarObject_HEAD_INIT(NULL, 0) |
| 1587 | "collections.deque", /* tp_name */ |
| 1588 | sizeof(dequeobject), /* tp_basicsize */ |
| 1589 | 0, /* tp_itemsize */ |
| 1590 | /* methods */ |
| 1591 | (destructor)deque_dealloc, /* tp_dealloc */ |
| 1592 | 0, /* tp_print */ |
| 1593 | 0, /* tp_getattr */ |
| 1594 | 0, /* tp_setattr */ |
| 1595 | 0, /* tp_reserved */ |
| 1596 | deque_repr, /* tp_repr */ |
Raymond Hettinger | 0f1451c | 2015-03-23 23:23:55 -0700 | [diff] [blame] | 1597 | &deque_as_number, /* tp_as_number */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1598 | &deque_as_sequence, /* tp_as_sequence */ |
| 1599 | 0, /* tp_as_mapping */ |
Georg Brandl | f038b32 | 2010-10-18 07:35:09 +0000 | [diff] [blame] | 1600 | PyObject_HashNotImplemented, /* tp_hash */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1601 | 0, /* tp_call */ |
| 1602 | 0, /* tp_str */ |
| 1603 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 1604 | 0, /* tp_setattro */ |
| 1605 | 0, /* tp_as_buffer */ |
| 1606 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC, |
Georg Brandl | f038b32 | 2010-10-18 07:35:09 +0000 | [diff] [blame] | 1607 | /* tp_flags */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1608 | deque_doc, /* tp_doc */ |
| 1609 | (traverseproc)deque_traverse, /* tp_traverse */ |
| 1610 | (inquiry)deque_clear, /* tp_clear */ |
| 1611 | (richcmpfunc)deque_richcompare, /* tp_richcompare */ |
Georg Brandl | f038b32 | 2010-10-18 07:35:09 +0000 | [diff] [blame] | 1612 | offsetof(dequeobject, weakreflist), /* tp_weaklistoffset*/ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1613 | (getiterfunc)deque_iter, /* tp_iter */ |
| 1614 | 0, /* tp_iternext */ |
| 1615 | deque_methods, /* tp_methods */ |
| 1616 | 0, /* tp_members */ |
Georg Brandl | f038b32 | 2010-10-18 07:35:09 +0000 | [diff] [blame] | 1617 | deque_getset, /* tp_getset */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1618 | 0, /* tp_base */ |
| 1619 | 0, /* tp_dict */ |
| 1620 | 0, /* tp_descr_get */ |
| 1621 | 0, /* tp_descr_set */ |
| 1622 | 0, /* tp_dictoffset */ |
| 1623 | (initproc)deque_init, /* tp_init */ |
| 1624 | PyType_GenericAlloc, /* tp_alloc */ |
| 1625 | deque_new, /* tp_new */ |
| 1626 | PyObject_GC_Del, /* tp_free */ |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1627 | }; |
| 1628 | |
| 1629 | /*********************** Deque Iterator **************************/ |
| 1630 | |
| 1631 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1632 | PyObject_HEAD |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1633 | block *b; |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1634 | Py_ssize_t index; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1635 | dequeobject *deque; |
Raymond Hettinger | f9d9c79 | 2015-03-02 22:47:46 -0800 | [diff] [blame] | 1636 | size_t state; /* state when the iterator is created */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1637 | Py_ssize_t counter; /* number of items remaining for iteration */ |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1638 | } dequeiterobject; |
| 1639 | |
Martin v. Löwis | 59683e8 | 2008-06-13 07:50:45 +0000 | [diff] [blame] | 1640 | static PyTypeObject dequeiter_type; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1641 | |
| 1642 | static PyObject * |
| 1643 | deque_iter(dequeobject *deque) |
| 1644 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1645 | dequeiterobject *it; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1646 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1647 | it = PyObject_GC_New(dequeiterobject, &dequeiter_type); |
| 1648 | if (it == NULL) |
| 1649 | return NULL; |
| 1650 | it->b = deque->leftblock; |
| 1651 | it->index = deque->leftindex; |
| 1652 | Py_INCREF(deque); |
| 1653 | it->deque = deque; |
| 1654 | it->state = deque->state; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1655 | it->counter = Py_SIZE(deque); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1656 | PyObject_GC_Track(it); |
| 1657 | return (PyObject *)it; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1658 | } |
| 1659 | |
Antoine Pitrou | 7ddda78 | 2009-01-01 15:35:33 +0000 | [diff] [blame] | 1660 | static int |
| 1661 | dequeiter_traverse(dequeiterobject *dio, visitproc visit, void *arg) |
| 1662 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1663 | Py_VISIT(dio->deque); |
| 1664 | return 0; |
Antoine Pitrou | 7ddda78 | 2009-01-01 15:35:33 +0000 | [diff] [blame] | 1665 | } |
| 1666 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1667 | static void |
| 1668 | dequeiter_dealloc(dequeiterobject *dio) |
| 1669 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1670 | Py_XDECREF(dio->deque); |
| 1671 | PyObject_GC_Del(dio); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1672 | } |
| 1673 | |
| 1674 | static PyObject * |
| 1675 | dequeiter_next(dequeiterobject *it) |
| 1676 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1677 | PyObject *item; |
Raymond Hettinger | d1b3d88 | 2004-10-02 00:43:13 +0000 | [diff] [blame] | 1678 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1679 | if (it->deque->state != it->state) { |
| 1680 | it->counter = 0; |
| 1681 | PyErr_SetString(PyExc_RuntimeError, |
| 1682 | "deque mutated during iteration"); |
| 1683 | return NULL; |
| 1684 | } |
| 1685 | if (it->counter == 0) |
| 1686 | return NULL; |
| 1687 | assert (!(it->b == it->deque->rightblock && |
| 1688 | it->index > it->deque->rightindex)); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1689 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1690 | item = it->b->data[it->index]; |
| 1691 | it->index++; |
| 1692 | it->counter--; |
| 1693 | if (it->index == BLOCKLEN && it->counter > 0) { |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 1694 | CHECK_NOT_END(it->b->rightlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1695 | it->b = it->b->rightlink; |
| 1696 | it->index = 0; |
| 1697 | } |
| 1698 | Py_INCREF(item); |
| 1699 | return item; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1700 | } |
| 1701 | |
Raymond Hettinger | 6b27cda | 2005-09-24 21:23:05 +0000 | [diff] [blame] | 1702 | static PyObject * |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1703 | dequeiter_new(PyTypeObject *type, PyObject *args, PyObject *kwds) |
| 1704 | { |
| 1705 | Py_ssize_t i, index=0; |
| 1706 | PyObject *deque; |
| 1707 | dequeiterobject *it; |
| 1708 | if (!PyArg_ParseTuple(args, "O!|n", &deque_type, &deque, &index)) |
| 1709 | return NULL; |
| 1710 | assert(type == &dequeiter_type); |
| 1711 | |
| 1712 | it = (dequeiterobject*)deque_iter((dequeobject *)deque); |
| 1713 | if (!it) |
| 1714 | return NULL; |
| 1715 | /* consume items from the queue */ |
| 1716 | for(i=0; i<index; i++) { |
| 1717 | PyObject *item = dequeiter_next(it); |
| 1718 | if (item) { |
| 1719 | Py_DECREF(item); |
| 1720 | } else { |
| 1721 | if (it->counter) { |
| 1722 | Py_DECREF(it); |
| 1723 | return NULL; |
| 1724 | } else |
| 1725 | break; |
| 1726 | } |
| 1727 | } |
| 1728 | return (PyObject*)it; |
| 1729 | } |
| 1730 | |
| 1731 | static PyObject * |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1732 | dequeiter_len(dequeiterobject *it) |
| 1733 | { |
Antoine Pitrou | 554f334 | 2010-08-17 18:30:06 +0000 | [diff] [blame] | 1734 | return PyLong_FromSsize_t(it->counter); |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1735 | } |
| 1736 | |
Armin Rigo | f5b3e36 | 2006-02-11 21:32:43 +0000 | [diff] [blame] | 1737 | PyDoc_STRVAR(length_hint_doc, "Private method returning an estimate of len(list(it))."); |
Raymond Hettinger | 6b27cda | 2005-09-24 21:23:05 +0000 | [diff] [blame] | 1738 | |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1739 | static PyObject * |
| 1740 | dequeiter_reduce(dequeiterobject *it) |
| 1741 | { |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1742 | return Py_BuildValue("O(On)", Py_TYPE(it), it->deque, Py_SIZE(it->deque) - it->counter); |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1743 | } |
| 1744 | |
Raymond Hettinger | 6b27cda | 2005-09-24 21:23:05 +0000 | [diff] [blame] | 1745 | static PyMethodDef dequeiter_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1746 | {"__length_hint__", (PyCFunction)dequeiter_len, METH_NOARGS, length_hint_doc}, |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1747 | {"__reduce__", (PyCFunction)dequeiter_reduce, METH_NOARGS, reduce_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1748 | {NULL, NULL} /* sentinel */ |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1749 | }; |
| 1750 | |
Martin v. Löwis | 59683e8 | 2008-06-13 07:50:45 +0000 | [diff] [blame] | 1751 | static PyTypeObject dequeiter_type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1752 | PyVarObject_HEAD_INIT(NULL, 0) |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1753 | "_collections._deque_iterator", /* tp_name */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1754 | sizeof(dequeiterobject), /* tp_basicsize */ |
| 1755 | 0, /* tp_itemsize */ |
| 1756 | /* methods */ |
| 1757 | (destructor)dequeiter_dealloc, /* tp_dealloc */ |
| 1758 | 0, /* tp_print */ |
| 1759 | 0, /* tp_getattr */ |
| 1760 | 0, /* tp_setattr */ |
| 1761 | 0, /* tp_reserved */ |
| 1762 | 0, /* tp_repr */ |
| 1763 | 0, /* tp_as_number */ |
| 1764 | 0, /* tp_as_sequence */ |
| 1765 | 0, /* tp_as_mapping */ |
| 1766 | 0, /* tp_hash */ |
| 1767 | 0, /* tp_call */ |
| 1768 | 0, /* tp_str */ |
| 1769 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 1770 | 0, /* tp_setattro */ |
| 1771 | 0, /* tp_as_buffer */ |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1772 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC, /* tp_flags */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1773 | 0, /* tp_doc */ |
| 1774 | (traverseproc)dequeiter_traverse, /* tp_traverse */ |
| 1775 | 0, /* tp_clear */ |
| 1776 | 0, /* tp_richcompare */ |
| 1777 | 0, /* tp_weaklistoffset */ |
| 1778 | PyObject_SelfIter, /* tp_iter */ |
| 1779 | (iternextfunc)dequeiter_next, /* tp_iternext */ |
| 1780 | dequeiter_methods, /* tp_methods */ |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1781 | 0, /* tp_members */ |
| 1782 | 0, /* tp_getset */ |
| 1783 | 0, /* tp_base */ |
| 1784 | 0, /* tp_dict */ |
| 1785 | 0, /* tp_descr_get */ |
| 1786 | 0, /* tp_descr_set */ |
| 1787 | 0, /* tp_dictoffset */ |
| 1788 | 0, /* tp_init */ |
| 1789 | 0, /* tp_alloc */ |
| 1790 | dequeiter_new, /* tp_new */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1791 | 0, |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 1792 | }; |
| 1793 | |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1794 | /*********************** Deque Reverse Iterator **************************/ |
| 1795 | |
Martin v. Löwis | 59683e8 | 2008-06-13 07:50:45 +0000 | [diff] [blame] | 1796 | static PyTypeObject dequereviter_type; |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1797 | |
| 1798 | static PyObject * |
| 1799 | deque_reviter(dequeobject *deque) |
| 1800 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1801 | dequeiterobject *it; |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1802 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1803 | it = PyObject_GC_New(dequeiterobject, &dequereviter_type); |
| 1804 | if (it == NULL) |
| 1805 | return NULL; |
| 1806 | it->b = deque->rightblock; |
| 1807 | it->index = deque->rightindex; |
| 1808 | Py_INCREF(deque); |
| 1809 | it->deque = deque; |
| 1810 | it->state = deque->state; |
Raymond Hettinger | df715ba | 2013-07-06 13:01:13 -1000 | [diff] [blame] | 1811 | it->counter = Py_SIZE(deque); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1812 | PyObject_GC_Track(it); |
| 1813 | return (PyObject *)it; |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1814 | } |
| 1815 | |
| 1816 | static PyObject * |
| 1817 | dequereviter_next(dequeiterobject *it) |
| 1818 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1819 | PyObject *item; |
| 1820 | if (it->counter == 0) |
| 1821 | return NULL; |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1822 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1823 | if (it->deque->state != it->state) { |
| 1824 | it->counter = 0; |
| 1825 | PyErr_SetString(PyExc_RuntimeError, |
| 1826 | "deque mutated during iteration"); |
| 1827 | return NULL; |
| 1828 | } |
| 1829 | assert (!(it->b == it->deque->leftblock && |
| 1830 | it->index < it->deque->leftindex)); |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1831 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1832 | item = it->b->data[it->index]; |
| 1833 | it->index--; |
| 1834 | it->counter--; |
Raymond Hettinger | d3d2b2c | 2015-09-21 23:41:56 -0700 | [diff] [blame] | 1835 | if (it->index < 0 && it->counter > 0) { |
Raymond Hettinger | 82df925 | 2013-07-07 01:43:42 -1000 | [diff] [blame] | 1836 | CHECK_NOT_END(it->b->leftlink); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1837 | it->b = it->b->leftlink; |
| 1838 | it->index = BLOCKLEN - 1; |
| 1839 | } |
| 1840 | Py_INCREF(item); |
| 1841 | return item; |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1842 | } |
| 1843 | |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1844 | static PyObject * |
| 1845 | dequereviter_new(PyTypeObject *type, PyObject *args, PyObject *kwds) |
| 1846 | { |
| 1847 | Py_ssize_t i, index=0; |
| 1848 | PyObject *deque; |
| 1849 | dequeiterobject *it; |
| 1850 | if (!PyArg_ParseTuple(args, "O!|n", &deque_type, &deque, &index)) |
| 1851 | return NULL; |
| 1852 | assert(type == &dequereviter_type); |
| 1853 | |
| 1854 | it = (dequeiterobject*)deque_reviter((dequeobject *)deque); |
| 1855 | if (!it) |
| 1856 | return NULL; |
| 1857 | /* consume items from the queue */ |
| 1858 | for(i=0; i<index; i++) { |
| 1859 | PyObject *item = dequereviter_next(it); |
| 1860 | if (item) { |
| 1861 | Py_DECREF(item); |
| 1862 | } else { |
| 1863 | if (it->counter) { |
| 1864 | Py_DECREF(it); |
| 1865 | return NULL; |
| 1866 | } else |
| 1867 | break; |
| 1868 | } |
| 1869 | } |
| 1870 | return (PyObject*)it; |
| 1871 | } |
| 1872 | |
Martin v. Löwis | 59683e8 | 2008-06-13 07:50:45 +0000 | [diff] [blame] | 1873 | static PyTypeObject dequereviter_type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1874 | PyVarObject_HEAD_INIT(NULL, 0) |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1875 | "_collections._deque_reverse_iterator", /* tp_name */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1876 | sizeof(dequeiterobject), /* tp_basicsize */ |
| 1877 | 0, /* tp_itemsize */ |
| 1878 | /* methods */ |
| 1879 | (destructor)dequeiter_dealloc, /* tp_dealloc */ |
| 1880 | 0, /* tp_print */ |
| 1881 | 0, /* tp_getattr */ |
| 1882 | 0, /* tp_setattr */ |
| 1883 | 0, /* tp_reserved */ |
| 1884 | 0, /* tp_repr */ |
| 1885 | 0, /* tp_as_number */ |
| 1886 | 0, /* tp_as_sequence */ |
| 1887 | 0, /* tp_as_mapping */ |
| 1888 | 0, /* tp_hash */ |
| 1889 | 0, /* tp_call */ |
| 1890 | 0, /* tp_str */ |
| 1891 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 1892 | 0, /* tp_setattro */ |
| 1893 | 0, /* tp_as_buffer */ |
Raymond Hettinger | 87e6912 | 2015-03-02 23:32:02 -0800 | [diff] [blame] | 1894 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC, /* tp_flags */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1895 | 0, /* tp_doc */ |
| 1896 | (traverseproc)dequeiter_traverse, /* tp_traverse */ |
| 1897 | 0, /* tp_clear */ |
| 1898 | 0, /* tp_richcompare */ |
| 1899 | 0, /* tp_weaklistoffset */ |
| 1900 | PyObject_SelfIter, /* tp_iter */ |
| 1901 | (iternextfunc)dequereviter_next, /* tp_iternext */ |
| 1902 | dequeiter_methods, /* tp_methods */ |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 1903 | 0, /* tp_members */ |
| 1904 | 0, /* tp_getset */ |
| 1905 | 0, /* tp_base */ |
| 1906 | 0, /* tp_dict */ |
| 1907 | 0, /* tp_descr_get */ |
| 1908 | 0, /* tp_descr_set */ |
| 1909 | 0, /* tp_dictoffset */ |
| 1910 | 0, /* tp_init */ |
| 1911 | 0, /* tp_alloc */ |
| 1912 | dequereviter_new, /* tp_new */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1913 | 0, |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 1914 | }; |
| 1915 | |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1916 | /* defaultdict type *********************************************************/ |
| 1917 | |
| 1918 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1919 | PyDictObject dict; |
| 1920 | PyObject *default_factory; |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1921 | } defdictobject; |
| 1922 | |
| 1923 | static PyTypeObject defdict_type; /* Forward */ |
| 1924 | |
| 1925 | PyDoc_STRVAR(defdict_missing_doc, |
| 1926 | "__missing__(key) # Called by __getitem__ for missing key; pseudo-code:\n\ |
Guido van Rossum | d8faa36 | 2007-04-27 19:54:29 +0000 | [diff] [blame] | 1927 | if self.default_factory is None: raise KeyError((key,))\n\ |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1928 | self[key] = value = self.default_factory()\n\ |
| 1929 | return value\n\ |
| 1930 | "); |
| 1931 | |
| 1932 | static PyObject * |
| 1933 | defdict_missing(defdictobject *dd, PyObject *key) |
| 1934 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1935 | PyObject *factory = dd->default_factory; |
| 1936 | PyObject *value; |
| 1937 | if (factory == NULL || factory == Py_None) { |
| 1938 | /* XXX Call dict.__missing__(key) */ |
| 1939 | PyObject *tup; |
| 1940 | tup = PyTuple_Pack(1, key); |
| 1941 | if (!tup) return NULL; |
| 1942 | PyErr_SetObject(PyExc_KeyError, tup); |
| 1943 | Py_DECREF(tup); |
| 1944 | return NULL; |
| 1945 | } |
| 1946 | value = PyEval_CallObject(factory, NULL); |
| 1947 | if (value == NULL) |
| 1948 | return value; |
| 1949 | if (PyObject_SetItem((PyObject *)dd, key, value) < 0) { |
| 1950 | Py_DECREF(value); |
| 1951 | return NULL; |
| 1952 | } |
| 1953 | return value; |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1954 | } |
| 1955 | |
| 1956 | PyDoc_STRVAR(defdict_copy_doc, "D.copy() -> a shallow copy of D."); |
| 1957 | |
| 1958 | static PyObject * |
| 1959 | defdict_copy(defdictobject *dd) |
| 1960 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1961 | /* This calls the object's class. That only works for subclasses |
| 1962 | whose class constructor has the same signature. Subclasses that |
| 1963 | define a different constructor signature must override copy(). |
| 1964 | */ |
Raymond Hettinger | 54628fa | 2009-08-04 19:16:39 +0000 | [diff] [blame] | 1965 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1966 | if (dd->default_factory == NULL) |
| 1967 | return PyObject_CallFunctionObjArgs((PyObject*)Py_TYPE(dd), Py_None, dd, NULL); |
| 1968 | return PyObject_CallFunctionObjArgs((PyObject*)Py_TYPE(dd), |
| 1969 | dd->default_factory, dd, NULL); |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1970 | } |
| 1971 | |
| 1972 | static PyObject * |
| 1973 | defdict_reduce(defdictobject *dd) |
| 1974 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1975 | /* __reduce__ must return a 5-tuple as follows: |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1976 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1977 | - factory function |
| 1978 | - tuple of args for the factory function |
| 1979 | - additional state (here None) |
| 1980 | - sequence iterator (here None) |
| 1981 | - dictionary iterator (yielding successive (key, value) pairs |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1982 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1983 | This API is used by pickle.py and copy.py. |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1984 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1985 | For this to be useful with pickle.py, the default_factory |
| 1986 | must be picklable; e.g., None, a built-in, or a global |
| 1987 | function in a module or package. |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1988 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1989 | Both shallow and deep copying are supported, but for deep |
| 1990 | copying, the default_factory must be deep-copyable; e.g. None, |
| 1991 | or a built-in (functions are not copyable at this time). |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 1992 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1993 | This only works for subclasses as long as their constructor |
| 1994 | signature is compatible; the first argument must be the |
| 1995 | optional default_factory, defaulting to None. |
| 1996 | */ |
| 1997 | PyObject *args; |
| 1998 | PyObject *items; |
| 1999 | PyObject *iter; |
| 2000 | PyObject *result; |
Martin v. Löwis | bd928fe | 2011-10-14 10:20:37 +0200 | [diff] [blame] | 2001 | _Py_IDENTIFIER(items); |
Martin v. Löwis | afe55bb | 2011-10-09 10:38:36 +0200 | [diff] [blame] | 2002 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2003 | if (dd->default_factory == NULL || dd->default_factory == Py_None) |
| 2004 | args = PyTuple_New(0); |
| 2005 | else |
| 2006 | args = PyTuple_Pack(1, dd->default_factory); |
| 2007 | if (args == NULL) |
| 2008 | return NULL; |
Martin v. Löwis | afe55bb | 2011-10-09 10:38:36 +0200 | [diff] [blame] | 2009 | items = _PyObject_CallMethodId((PyObject *)dd, &PyId_items, "()"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2010 | if (items == NULL) { |
| 2011 | Py_DECREF(args); |
| 2012 | return NULL; |
| 2013 | } |
| 2014 | iter = PyObject_GetIter(items); |
| 2015 | if (iter == NULL) { |
| 2016 | Py_DECREF(items); |
| 2017 | Py_DECREF(args); |
| 2018 | return NULL; |
| 2019 | } |
| 2020 | result = PyTuple_Pack(5, Py_TYPE(dd), args, |
| 2021 | Py_None, Py_None, iter); |
| 2022 | Py_DECREF(iter); |
| 2023 | Py_DECREF(items); |
| 2024 | Py_DECREF(args); |
| 2025 | return result; |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2026 | } |
| 2027 | |
| 2028 | static PyMethodDef defdict_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2029 | {"__missing__", (PyCFunction)defdict_missing, METH_O, |
| 2030 | defdict_missing_doc}, |
| 2031 | {"copy", (PyCFunction)defdict_copy, METH_NOARGS, |
| 2032 | defdict_copy_doc}, |
| 2033 | {"__copy__", (PyCFunction)defdict_copy, METH_NOARGS, |
| 2034 | defdict_copy_doc}, |
| 2035 | {"__reduce__", (PyCFunction)defdict_reduce, METH_NOARGS, |
| 2036 | reduce_doc}, |
| 2037 | {NULL} |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2038 | }; |
| 2039 | |
| 2040 | static PyMemberDef defdict_members[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2041 | {"default_factory", T_OBJECT, |
| 2042 | offsetof(defdictobject, default_factory), 0, |
| 2043 | PyDoc_STR("Factory for default value called by __missing__().")}, |
| 2044 | {NULL} |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2045 | }; |
| 2046 | |
| 2047 | static void |
| 2048 | defdict_dealloc(defdictobject *dd) |
| 2049 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2050 | Py_CLEAR(dd->default_factory); |
| 2051 | PyDict_Type.tp_dealloc((PyObject *)dd); |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2052 | } |
| 2053 | |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2054 | static PyObject * |
| 2055 | defdict_repr(defdictobject *dd) |
| 2056 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2057 | PyObject *baserepr; |
| 2058 | PyObject *defrepr; |
| 2059 | PyObject *result; |
| 2060 | baserepr = PyDict_Type.tp_repr((PyObject *)dd); |
| 2061 | if (baserepr == NULL) |
| 2062 | return NULL; |
| 2063 | if (dd->default_factory == NULL) |
| 2064 | defrepr = PyUnicode_FromString("None"); |
| 2065 | else |
| 2066 | { |
| 2067 | int status = Py_ReprEnter(dd->default_factory); |
| 2068 | if (status != 0) { |
Antoine Pitrou | f5f1fe0 | 2012-02-15 02:42:46 +0100 | [diff] [blame] | 2069 | if (status < 0) { |
| 2070 | Py_DECREF(baserepr); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2071 | return NULL; |
Antoine Pitrou | f5f1fe0 | 2012-02-15 02:42:46 +0100 | [diff] [blame] | 2072 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2073 | defrepr = PyUnicode_FromString("..."); |
| 2074 | } |
| 2075 | else |
| 2076 | defrepr = PyObject_Repr(dd->default_factory); |
| 2077 | Py_ReprLeave(dd->default_factory); |
| 2078 | } |
| 2079 | if (defrepr == NULL) { |
| 2080 | Py_DECREF(baserepr); |
| 2081 | return NULL; |
| 2082 | } |
| 2083 | result = PyUnicode_FromFormat("defaultdict(%U, %U)", |
| 2084 | defrepr, baserepr); |
| 2085 | Py_DECREF(defrepr); |
| 2086 | Py_DECREF(baserepr); |
| 2087 | return result; |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2088 | } |
| 2089 | |
| 2090 | static int |
| 2091 | defdict_traverse(PyObject *self, visitproc visit, void *arg) |
| 2092 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2093 | Py_VISIT(((defdictobject *)self)->default_factory); |
| 2094 | return PyDict_Type.tp_traverse(self, visit, arg); |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2095 | } |
| 2096 | |
| 2097 | static int |
| 2098 | defdict_tp_clear(defdictobject *dd) |
| 2099 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2100 | Py_CLEAR(dd->default_factory); |
| 2101 | return PyDict_Type.tp_clear((PyObject *)dd); |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2102 | } |
| 2103 | |
| 2104 | static int |
| 2105 | defdict_init(PyObject *self, PyObject *args, PyObject *kwds) |
| 2106 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2107 | defdictobject *dd = (defdictobject *)self; |
| 2108 | PyObject *olddefault = dd->default_factory; |
| 2109 | PyObject *newdefault = NULL; |
| 2110 | PyObject *newargs; |
| 2111 | int result; |
| 2112 | if (args == NULL || !PyTuple_Check(args)) |
| 2113 | newargs = PyTuple_New(0); |
| 2114 | else { |
| 2115 | Py_ssize_t n = PyTuple_GET_SIZE(args); |
| 2116 | if (n > 0) { |
| 2117 | newdefault = PyTuple_GET_ITEM(args, 0); |
| 2118 | if (!PyCallable_Check(newdefault) && newdefault != Py_None) { |
| 2119 | PyErr_SetString(PyExc_TypeError, |
Raymond Hettinger | 239aba7 | 2015-07-20 03:09:22 -0400 | [diff] [blame] | 2120 | "first argument must be callable or None"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2121 | return -1; |
| 2122 | } |
| 2123 | } |
| 2124 | newargs = PySequence_GetSlice(args, 1, n); |
| 2125 | } |
| 2126 | if (newargs == NULL) |
| 2127 | return -1; |
| 2128 | Py_XINCREF(newdefault); |
| 2129 | dd->default_factory = newdefault; |
| 2130 | result = PyDict_Type.tp_init(self, newargs, kwds); |
| 2131 | Py_DECREF(newargs); |
| 2132 | Py_XDECREF(olddefault); |
| 2133 | return result; |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2134 | } |
| 2135 | |
| 2136 | PyDoc_STRVAR(defdict_doc, |
Benjamin Peterson | 9cb33b7 | 2014-01-13 23:56:05 -0500 | [diff] [blame] | 2137 | "defaultdict(default_factory[, ...]) --> dict with default factory\n\ |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2138 | \n\ |
| 2139 | The default factory is called without arguments to produce\n\ |
| 2140 | a new value when a key is not present, in __getitem__ only.\n\ |
| 2141 | A defaultdict compares equal to a dict with the same items.\n\ |
Benjamin Peterson | 9cb33b7 | 2014-01-13 23:56:05 -0500 | [diff] [blame] | 2142 | All remaining arguments are treated the same as if they were\n\ |
| 2143 | passed to the dict constructor, including keyword arguments.\n\ |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2144 | "); |
| 2145 | |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 2146 | /* See comment in xxsubtype.c */ |
| 2147 | #define DEFERRED_ADDRESS(ADDR) 0 |
| 2148 | |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2149 | static PyTypeObject defdict_type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2150 | PyVarObject_HEAD_INIT(DEFERRED_ADDRESS(&PyType_Type), 0) |
| 2151 | "collections.defaultdict", /* tp_name */ |
| 2152 | sizeof(defdictobject), /* tp_basicsize */ |
| 2153 | 0, /* tp_itemsize */ |
| 2154 | /* methods */ |
| 2155 | (destructor)defdict_dealloc, /* tp_dealloc */ |
| 2156 | 0, /* tp_print */ |
| 2157 | 0, /* tp_getattr */ |
| 2158 | 0, /* tp_setattr */ |
| 2159 | 0, /* tp_reserved */ |
| 2160 | (reprfunc)defdict_repr, /* tp_repr */ |
| 2161 | 0, /* tp_as_number */ |
| 2162 | 0, /* tp_as_sequence */ |
| 2163 | 0, /* tp_as_mapping */ |
| 2164 | 0, /* tp_hash */ |
| 2165 | 0, /* tp_call */ |
| 2166 | 0, /* tp_str */ |
| 2167 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 2168 | 0, /* tp_setattro */ |
| 2169 | 0, /* tp_as_buffer */ |
| 2170 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | Py_TPFLAGS_HAVE_GC, |
| 2171 | /* tp_flags */ |
| 2172 | defdict_doc, /* tp_doc */ |
| 2173 | defdict_traverse, /* tp_traverse */ |
| 2174 | (inquiry)defdict_tp_clear, /* tp_clear */ |
| 2175 | 0, /* tp_richcompare */ |
| 2176 | 0, /* tp_weaklistoffset*/ |
| 2177 | 0, /* tp_iter */ |
| 2178 | 0, /* tp_iternext */ |
| 2179 | defdict_methods, /* tp_methods */ |
| 2180 | defdict_members, /* tp_members */ |
| 2181 | 0, /* tp_getset */ |
| 2182 | DEFERRED_ADDRESS(&PyDict_Type), /* tp_base */ |
| 2183 | 0, /* tp_dict */ |
| 2184 | 0, /* tp_descr_get */ |
| 2185 | 0, /* tp_descr_set */ |
| 2186 | 0, /* tp_dictoffset */ |
| 2187 | defdict_init, /* tp_init */ |
| 2188 | PyType_GenericAlloc, /* tp_alloc */ |
| 2189 | 0, /* tp_new */ |
| 2190 | PyObject_GC_Del, /* tp_free */ |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2191 | }; |
| 2192 | |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2193 | /* helper function for Counter *********************************************/ |
| 2194 | |
| 2195 | PyDoc_STRVAR(_count_elements_doc, |
| 2196 | "_count_elements(mapping, iterable) -> None\n\ |
| 2197 | \n\ |
| 2198 | Count elements in the iterable, updating the mappping"); |
| 2199 | |
| 2200 | static PyObject * |
| 2201 | _count_elements(PyObject *self, PyObject *args) |
| 2202 | { |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2203 | _Py_IDENTIFIER(get); |
Raymond Hettinger | 2ff2190 | 2013-10-01 00:55:43 -0700 | [diff] [blame] | 2204 | _Py_IDENTIFIER(__setitem__); |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2205 | PyObject *it, *iterable, *mapping, *oldval; |
| 2206 | PyObject *newval = NULL; |
| 2207 | PyObject *key = NULL; |
Raymond Hettinger | 224c87d | 2013-10-01 21:36:09 -0700 | [diff] [blame] | 2208 | PyObject *zero = NULL; |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2209 | PyObject *one = NULL; |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2210 | PyObject *bound_get = NULL; |
| 2211 | PyObject *mapping_get; |
| 2212 | PyObject *dict_get; |
Raymond Hettinger | 2ff2190 | 2013-10-01 00:55:43 -0700 | [diff] [blame] | 2213 | PyObject *mapping_setitem; |
Raymond Hettinger | 2ff2190 | 2013-10-01 00:55:43 -0700 | [diff] [blame] | 2214 | PyObject *dict_setitem; |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2215 | |
| 2216 | if (!PyArg_UnpackTuple(args, "_count_elements", 2, 2, &mapping, &iterable)) |
| 2217 | return NULL; |
| 2218 | |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2219 | it = PyObject_GetIter(iterable); |
| 2220 | if (it == NULL) |
| 2221 | return NULL; |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2222 | |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2223 | one = PyLong_FromLong(1); |
Raymond Hettinger | 224c87d | 2013-10-01 21:36:09 -0700 | [diff] [blame] | 2224 | if (one == NULL) |
| 2225 | goto done; |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2226 | |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2227 | /* Only take the fast path when get() and __setitem__() |
| 2228 | * have not been overridden. |
| 2229 | */ |
| 2230 | mapping_get = _PyType_LookupId(Py_TYPE(mapping), &PyId_get); |
| 2231 | dict_get = _PyType_LookupId(&PyDict_Type, &PyId_get); |
Raymond Hettinger | 2ff2190 | 2013-10-01 00:55:43 -0700 | [diff] [blame] | 2232 | mapping_setitem = _PyType_LookupId(Py_TYPE(mapping), &PyId___setitem__); |
| 2233 | dict_setitem = _PyType_LookupId(&PyDict_Type, &PyId___setitem__); |
| 2234 | |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2235 | if (mapping_get != NULL && mapping_get == dict_get && |
| 2236 | mapping_setitem != NULL && mapping_setitem == dict_setitem) { |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2237 | while (1) { |
Raymond Hettinger | 507d997 | 2014-05-18 21:32:40 +0100 | [diff] [blame] | 2238 | /* Fast path advantages: |
| 2239 | 1. Eliminate double hashing |
| 2240 | (by re-using the same hash for both the get and set) |
| 2241 | 2. Avoid argument overhead of PyObject_CallFunctionObjArgs |
| 2242 | (argument tuple creation and parsing) |
| 2243 | 3. Avoid indirection through a bound method object |
| 2244 | (creates another argument tuple) |
| 2245 | 4. Avoid initial increment from zero |
| 2246 | (reuse an existing one-object instead) |
| 2247 | */ |
Raymond Hettinger | 4b0b1ac | 2014-05-03 16:41:19 -0700 | [diff] [blame] | 2248 | Py_hash_t hash; |
| 2249 | |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2250 | key = PyIter_Next(it); |
Victor Stinner | a154b5c | 2011-04-20 23:23:52 +0200 | [diff] [blame] | 2251 | if (key == NULL) |
| 2252 | break; |
Raymond Hettinger | 4b0b1ac | 2014-05-03 16:41:19 -0700 | [diff] [blame] | 2253 | |
| 2254 | if (!PyUnicode_CheckExact(key) || |
| 2255 | (hash = ((PyASCIIObject *) key)->hash) == -1) |
| 2256 | { |
| 2257 | hash = PyObject_Hash(key); |
Raymond Hettinger | da2850f | 2015-02-27 12:42:54 -0800 | [diff] [blame] | 2258 | if (hash == -1) |
Raymond Hettinger | 4b0b1ac | 2014-05-03 16:41:19 -0700 | [diff] [blame] | 2259 | goto done; |
| 2260 | } |
| 2261 | |
| 2262 | oldval = _PyDict_GetItem_KnownHash(mapping, key, hash); |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2263 | if (oldval == NULL) { |
Raymond Hettinger | 28c995d | 2015-08-14 02:07:41 -0700 | [diff] [blame] | 2264 | if (_PyDict_SetItem_KnownHash(mapping, key, one, hash) < 0) |
Raymond Hettinger | 507d997 | 2014-05-18 21:32:40 +0100 | [diff] [blame] | 2265 | goto done; |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2266 | } else { |
| 2267 | newval = PyNumber_Add(oldval, one); |
| 2268 | if (newval == NULL) |
Raymond Hettinger | 507d997 | 2014-05-18 21:32:40 +0100 | [diff] [blame] | 2269 | goto done; |
Raymond Hettinger | 28c995d | 2015-08-14 02:07:41 -0700 | [diff] [blame] | 2270 | if (_PyDict_SetItem_KnownHash(mapping, key, newval, hash) < 0) |
Raymond Hettinger | 507d997 | 2014-05-18 21:32:40 +0100 | [diff] [blame] | 2271 | goto done; |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2272 | Py_CLEAR(newval); |
| 2273 | } |
| 2274 | Py_DECREF(key); |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2275 | } |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2276 | } else { |
Victor Stinner | e7f516c | 2013-11-06 23:52:55 +0100 | [diff] [blame] | 2277 | bound_get = _PyObject_GetAttrId(mapping, &PyId_get); |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2278 | if (bound_get == NULL) |
Raymond Hettinger | 224c87d | 2013-10-01 21:36:09 -0700 | [diff] [blame] | 2279 | goto done; |
| 2280 | |
| 2281 | zero = PyLong_FromLong(0); |
| 2282 | if (zero == NULL) |
| 2283 | goto done; |
| 2284 | |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2285 | while (1) { |
| 2286 | key = PyIter_Next(it); |
Victor Stinner | a154b5c | 2011-04-20 23:23:52 +0200 | [diff] [blame] | 2287 | if (key == NULL) |
| 2288 | break; |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2289 | oldval = PyObject_CallFunctionObjArgs(bound_get, key, zero, NULL); |
Raymond Hettinger | 224c87d | 2013-10-01 21:36:09 -0700 | [diff] [blame] | 2290 | if (oldval == NULL) |
| 2291 | break; |
| 2292 | newval = PyNumber_Add(oldval, one); |
| 2293 | Py_DECREF(oldval); |
| 2294 | if (newval == NULL) |
| 2295 | break; |
Raymond Hettinger | 28c995d | 2015-08-14 02:07:41 -0700 | [diff] [blame] | 2296 | if (PyObject_SetItem(mapping, key, newval) < 0) |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2297 | break; |
| 2298 | Py_CLEAR(newval); |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2299 | Py_DECREF(key); |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2300 | } |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2301 | } |
Raymond Hettinger | 426e052 | 2011-01-03 02:12:02 +0000 | [diff] [blame] | 2302 | |
Raymond Hettinger | 224c87d | 2013-10-01 21:36:09 -0700 | [diff] [blame] | 2303 | done: |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2304 | Py_DECREF(it); |
| 2305 | Py_XDECREF(key); |
| 2306 | Py_XDECREF(newval); |
Raymond Hettinger | cb1d96f | 2013-10-04 16:51:02 -0700 | [diff] [blame] | 2307 | Py_XDECREF(bound_get); |
Raymond Hettinger | 224c87d | 2013-10-01 21:36:09 -0700 | [diff] [blame] | 2308 | Py_XDECREF(zero); |
| 2309 | Py_XDECREF(one); |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2310 | if (PyErr_Occurred()) |
| 2311 | return NULL; |
| 2312 | Py_RETURN_NONE; |
| 2313 | } |
| 2314 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2315 | /* module level code ********************************************************/ |
| 2316 | |
| 2317 | PyDoc_STRVAR(module_doc, |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2318 | "High performance data structures.\n\ |
| 2319 | - deque: ordered collection accessible from endpoints only\n\ |
| 2320 | - defaultdict: dict subclass with a default value factory\n\ |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2321 | "); |
| 2322 | |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2323 | static struct PyMethodDef module_functions[] = { |
| 2324 | {"_count_elements", _count_elements, METH_VARARGS, _count_elements_doc}, |
| 2325 | {NULL, NULL} /* sentinel */ |
| 2326 | }; |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 2327 | |
| 2328 | static struct PyModuleDef _collectionsmodule = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2329 | PyModuleDef_HEAD_INIT, |
| 2330 | "_collections", |
| 2331 | module_doc, |
| 2332 | -1, |
Raymond Hettinger | 96f3410 | 2010-12-15 16:30:37 +0000 | [diff] [blame] | 2333 | module_functions, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2334 | NULL, |
| 2335 | NULL, |
| 2336 | NULL, |
| 2337 | NULL |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 2338 | }; |
| 2339 | |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2340 | PyMODINIT_FUNC |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 2341 | PyInit__collections(void) |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2342 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2343 | PyObject *m; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2344 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2345 | m = PyModule_Create(&_collectionsmodule); |
| 2346 | if (m == NULL) |
| 2347 | return NULL; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2348 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2349 | if (PyType_Ready(&deque_type) < 0) |
| 2350 | return NULL; |
| 2351 | Py_INCREF(&deque_type); |
| 2352 | PyModule_AddObject(m, "deque", (PyObject *)&deque_type); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2353 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2354 | defdict_type.tp_base = &PyDict_Type; |
| 2355 | if (PyType_Ready(&defdict_type) < 0) |
| 2356 | return NULL; |
| 2357 | Py_INCREF(&defdict_type); |
| 2358 | PyModule_AddObject(m, "defaultdict", (PyObject *)&defdict_type); |
Guido van Rossum | 1968ad3 | 2006-02-25 22:38:04 +0000 | [diff] [blame] | 2359 | |
Eric Snow | 47db717 | 2015-05-29 22:21:39 -0600 | [diff] [blame] | 2360 | Py_INCREF(&PyODict_Type); |
| 2361 | PyModule_AddObject(m, "OrderedDict", (PyObject *)&PyODict_Type); |
| 2362 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2363 | if (PyType_Ready(&dequeiter_type) < 0) |
| 2364 | return NULL; |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 2365 | Py_INCREF(&dequeiter_type); |
| 2366 | PyModule_AddObject(m, "_deque_iterator", (PyObject *)&dequeiter_type); |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2367 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2368 | if (PyType_Ready(&dequereviter_type) < 0) |
| 2369 | return NULL; |
Kristján Valur Jónsson | 31668b8 | 2012-04-03 10:49:41 +0000 | [diff] [blame] | 2370 | Py_INCREF(&dequereviter_type); |
| 2371 | PyModule_AddObject(m, "_deque_reverse_iterator", (PyObject *)&dequereviter_type); |
Raymond Hettinger | 1e5809f | 2004-03-18 11:04:57 +0000 | [diff] [blame] | 2372 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2373 | return m; |
Raymond Hettinger | 756b3f3 | 2004-01-29 06:37:52 +0000 | [diff] [blame] | 2374 | } |