Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1 | /* Array object implementation */ |
| 2 | |
| 3 | /* An array is a uniform list -- all items have the same type. |
| 4 | The item type is restricted to simple C types like int or float */ |
| 5 | |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 6 | #define PY_SSIZE_T_CLEAN |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 7 | #include "Python.h" |
Raymond Hettinger | cb87bc8 | 2004-05-31 00:35:52 +0000 | [diff] [blame] | 8 | #include "structmember.h" |
Roger E. Masse | 5817f8f | 1996-12-09 22:24:19 +0000 | [diff] [blame] | 9 | |
Guido van Rossum | 0c70954 | 1994-08-19 12:01:32 +0000 | [diff] [blame] | 10 | #ifdef STDC_HEADERS |
| 11 | #include <stddef.h> |
Guido van Rossum | 7f1de83 | 1999-08-27 20:33:52 +0000 | [diff] [blame] | 12 | #else /* !STDC_HEADERS */ |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 13 | #ifdef HAVE_SYS_TYPES_H |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 14 | #include <sys/types.h> /* For size_t */ |
Thomas Wouters | 0e3f591 | 2006-08-11 14:57:12 +0000 | [diff] [blame] | 15 | #endif /* HAVE_SYS_TYPES_H */ |
Guido van Rossum | 7f1de83 | 1999-08-27 20:33:52 +0000 | [diff] [blame] | 16 | #endif /* !STDC_HEADERS */ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 17 | |
| 18 | struct arrayobject; /* Forward */ |
| 19 | |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 20 | /* All possible arraydescr values are defined in the vector "descriptors" |
| 21 | * below. That's defined later because the appropriate get and set |
| 22 | * functions aren't visible yet. |
| 23 | */ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 24 | struct arraydescr { |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 25 | Py_UNICODE typecode; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 26 | int itemsize; |
| 27 | PyObject * (*getitem)(struct arrayobject *, Py_ssize_t); |
| 28 | int (*setitem)(struct arrayobject *, Py_ssize_t, PyObject *); |
| 29 | char *formats; |
| 30 | int is_integer_type; |
| 31 | int is_signed; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 32 | }; |
| 33 | |
| 34 | typedef struct arrayobject { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 35 | PyObject_VAR_HEAD |
| 36 | char *ob_item; |
| 37 | Py_ssize_t allocated; |
| 38 | struct arraydescr *ob_descr; |
| 39 | PyObject *weakreflist; /* List of weak references */ |
| 40 | int ob_exports; /* Number of exported buffers */ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 41 | } arrayobject; |
| 42 | |
Jeremy Hylton | 938ace6 | 2002-07-17 16:30:39 +0000 | [diff] [blame] | 43 | static PyTypeObject Arraytype; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 44 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 45 | #define array_Check(op) PyObject_TypeCheck(op, &Arraytype) |
Christian Heimes | 90aa764 | 2007-12-19 02:45:37 +0000 | [diff] [blame] | 46 | #define array_CheckExact(op) (Py_TYPE(op) == &Arraytype) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 47 | |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 48 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 49 | array_resize(arrayobject *self, Py_ssize_t newsize) |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 50 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 51 | char *items; |
| 52 | size_t _new_size; |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 53 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 54 | if (self->ob_exports > 0 && newsize != Py_SIZE(self)) { |
| 55 | PyErr_SetString(PyExc_BufferError, |
| 56 | "cannot resize an array that is exporting buffers"); |
| 57 | return -1; |
| 58 | } |
Antoine Pitrou | 3ad3a0d | 2008-12-18 17:08:32 +0000 | [diff] [blame] | 59 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 60 | /* Bypass realloc() when a previous overallocation is large enough |
| 61 | to accommodate the newsize. If the newsize is 16 smaller than the |
| 62 | current size, then proceed with the realloc() to shrink the array. |
| 63 | */ |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 64 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 65 | if (self->allocated >= newsize && |
| 66 | Py_SIZE(self) < newsize + 16 && |
| 67 | self->ob_item != NULL) { |
| 68 | Py_SIZE(self) = newsize; |
| 69 | return 0; |
| 70 | } |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 71 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 72 | if (newsize == 0) { |
| 73 | PyMem_FREE(self->ob_item); |
| 74 | self->ob_item = NULL; |
| 75 | Py_SIZE(self) = 0; |
| 76 | self->allocated = 0; |
| 77 | return 0; |
| 78 | } |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 79 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 80 | /* This over-allocates proportional to the array size, making room |
| 81 | * for additional growth. The over-allocation is mild, but is |
| 82 | * enough to give linear-time amortized behavior over a long |
| 83 | * sequence of appends() in the presence of a poorly-performing |
| 84 | * system realloc(). |
| 85 | * The growth pattern is: 0, 4, 8, 16, 25, 34, 46, 56, 67, 79, ... |
| 86 | * Note, the pattern starts out the same as for lists but then |
| 87 | * grows at a smaller rate so that larger arrays only overallocate |
| 88 | * by about 1/16th -- this is done because arrays are presumed to be more |
| 89 | * memory critical. |
| 90 | */ |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 91 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 92 | _new_size = (newsize >> 4) + (Py_SIZE(self) < 8 ? 3 : 7) + newsize; |
| 93 | items = self->ob_item; |
| 94 | /* XXX The following multiplication and division does not optimize away |
| 95 | like it does for lists since the size is not known at compile time */ |
| 96 | if (_new_size <= ((~(size_t)0) / self->ob_descr->itemsize)) |
| 97 | PyMem_RESIZE(items, char, (_new_size * self->ob_descr->itemsize)); |
| 98 | else |
| 99 | items = NULL; |
| 100 | if (items == NULL) { |
| 101 | PyErr_NoMemory(); |
| 102 | return -1; |
| 103 | } |
| 104 | self->ob_item = items; |
| 105 | Py_SIZE(self) = newsize; |
| 106 | self->allocated = _new_size; |
| 107 | return 0; |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 108 | } |
| 109 | |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 110 | /**************************************************************************** |
| 111 | Get and Set functions for each type. |
| 112 | A Get function takes an arrayobject* and an integer index, returning the |
| 113 | array value at that index wrapped in an appropriate PyObject*. |
| 114 | A Set function takes an arrayobject, integer index, and PyObject*; sets |
| 115 | the array value at that index to the raw C data extracted from the PyObject*, |
| 116 | and returns 0 if successful, else nonzero on failure (PyObject* not of an |
| 117 | appropriate type or value). |
| 118 | Note that the basic Get and Set functions do NOT check that the index is |
| 119 | in bounds; that's the responsibility of the caller. |
| 120 | ****************************************************************************/ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 121 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 122 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 123 | b_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 124 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 125 | long x = ((char *)ap->ob_item)[i]; |
| 126 | if (x >= 128) |
| 127 | x -= 256; |
| 128 | return PyLong_FromLong(x); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 129 | } |
| 130 | |
| 131 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 132 | b_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 133 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 134 | short x; |
| 135 | /* PyArg_Parse's 'b' formatter is for an unsigned char, therefore |
| 136 | must use the next size up that is signed ('h') and manually do |
| 137 | the overflow checking */ |
| 138 | if (!PyArg_Parse(v, "h;array item must be integer", &x)) |
| 139 | return -1; |
| 140 | else if (x < -128) { |
| 141 | PyErr_SetString(PyExc_OverflowError, |
| 142 | "signed char is less than minimum"); |
| 143 | return -1; |
| 144 | } |
| 145 | else if (x > 127) { |
| 146 | PyErr_SetString(PyExc_OverflowError, |
| 147 | "signed char is greater than maximum"); |
| 148 | return -1; |
| 149 | } |
| 150 | if (i >= 0) |
| 151 | ((char *)ap->ob_item)[i] = (char)x; |
| 152 | return 0; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 153 | } |
| 154 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 155 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 156 | BB_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 157 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 158 | long x = ((unsigned char *)ap->ob_item)[i]; |
| 159 | return PyLong_FromLong(x); |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 160 | } |
| 161 | |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 162 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 163 | BB_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 164 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 165 | unsigned char x; |
| 166 | /* 'B' == unsigned char, maps to PyArg_Parse's 'b' formatter */ |
| 167 | if (!PyArg_Parse(v, "b;array item must be integer", &x)) |
| 168 | return -1; |
| 169 | if (i >= 0) |
| 170 | ((char *)ap->ob_item)[i] = x; |
| 171 | return 0; |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 172 | } |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 173 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 174 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 175 | u_getitem(arrayobject *ap, Py_ssize_t i) |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 176 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 177 | return PyUnicode_FromUnicode(&((Py_UNICODE *) ap->ob_item)[i], 1); |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 178 | } |
| 179 | |
| 180 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 181 | u_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 182 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 183 | Py_UNICODE *p; |
| 184 | Py_ssize_t len; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 185 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 186 | if (!PyArg_Parse(v, "u#;array item must be unicode character", &p, &len)) |
| 187 | return -1; |
| 188 | if (len != 1) { |
| 189 | PyErr_SetString(PyExc_TypeError, |
| 190 | "array item must be unicode character"); |
| 191 | return -1; |
| 192 | } |
| 193 | if (i >= 0) |
| 194 | ((Py_UNICODE *)ap->ob_item)[i] = p[0]; |
| 195 | return 0; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 196 | } |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 197 | |
Travis E. Oliphant | d5c0add | 2007-10-12 22:05:15 +0000 | [diff] [blame] | 198 | |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 199 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 200 | h_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 201 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 202 | return PyLong_FromLong((long) ((short *)ap->ob_item)[i]); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 203 | } |
| 204 | |
Travis E. Oliphant | d5c0add | 2007-10-12 22:05:15 +0000 | [diff] [blame] | 205 | |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 206 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 207 | h_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 208 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 209 | short x; |
| 210 | /* 'h' == signed short, maps to PyArg_Parse's 'h' formatter */ |
| 211 | if (!PyArg_Parse(v, "h;array item must be integer", &x)) |
| 212 | return -1; |
| 213 | if (i >= 0) |
| 214 | ((short *)ap->ob_item)[i] = x; |
| 215 | return 0; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 216 | } |
| 217 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 218 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 219 | HH_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 220 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 221 | return PyLong_FromLong((long) ((unsigned short *)ap->ob_item)[i]); |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 222 | } |
| 223 | |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 224 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 225 | HH_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 226 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 227 | int x; |
| 228 | /* PyArg_Parse's 'h' formatter is for a signed short, therefore |
| 229 | must use the next size up and manually do the overflow checking */ |
| 230 | if (!PyArg_Parse(v, "i;array item must be integer", &x)) |
| 231 | return -1; |
| 232 | else if (x < 0) { |
| 233 | PyErr_SetString(PyExc_OverflowError, |
| 234 | "unsigned short is less than minimum"); |
| 235 | return -1; |
| 236 | } |
| 237 | else if (x > USHRT_MAX) { |
| 238 | PyErr_SetString(PyExc_OverflowError, |
| 239 | "unsigned short is greater than maximum"); |
| 240 | return -1; |
| 241 | } |
| 242 | if (i >= 0) |
| 243 | ((short *)ap->ob_item)[i] = (short)x; |
| 244 | return 0; |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 245 | } |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 246 | |
| 247 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 248 | i_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | e77a757 | 1993-11-03 15:01:26 +0000 | [diff] [blame] | 249 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 250 | return PyLong_FromLong((long) ((int *)ap->ob_item)[i]); |
Guido van Rossum | e77a757 | 1993-11-03 15:01:26 +0000 | [diff] [blame] | 251 | } |
| 252 | |
| 253 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 254 | i_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | e77a757 | 1993-11-03 15:01:26 +0000 | [diff] [blame] | 255 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 256 | int x; |
| 257 | /* 'i' == signed int, maps to PyArg_Parse's 'i' formatter */ |
| 258 | if (!PyArg_Parse(v, "i;array item must be integer", &x)) |
| 259 | return -1; |
| 260 | if (i >= 0) |
| 261 | ((int *)ap->ob_item)[i] = x; |
| 262 | return 0; |
Guido van Rossum | e77a757 | 1993-11-03 15:01:26 +0000 | [diff] [blame] | 263 | } |
| 264 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 265 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 266 | II_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 267 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 268 | return PyLong_FromUnsignedLong( |
| 269 | (unsigned long) ((unsigned int *)ap->ob_item)[i]); |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 270 | } |
| 271 | |
| 272 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 273 | II_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 274 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 275 | unsigned long x; |
| 276 | if (PyLong_Check(v)) { |
| 277 | x = PyLong_AsUnsignedLong(v); |
| 278 | if (x == (unsigned long) -1 && PyErr_Occurred()) |
| 279 | return -1; |
| 280 | } |
| 281 | else { |
| 282 | long y; |
| 283 | if (!PyArg_Parse(v, "l;array item must be integer", &y)) |
| 284 | return -1; |
| 285 | if (y < 0) { |
| 286 | PyErr_SetString(PyExc_OverflowError, |
| 287 | "unsigned int is less than minimum"); |
| 288 | return -1; |
| 289 | } |
| 290 | x = (unsigned long)y; |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 291 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 292 | } |
| 293 | if (x > UINT_MAX) { |
| 294 | PyErr_SetString(PyExc_OverflowError, |
| 295 | "unsigned int is greater than maximum"); |
| 296 | return -1; |
| 297 | } |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 298 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 299 | if (i >= 0) |
| 300 | ((unsigned int *)ap->ob_item)[i] = (unsigned int)x; |
| 301 | return 0; |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 302 | } |
| 303 | |
| 304 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 305 | l_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 306 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 307 | return PyLong_FromLong(((long *)ap->ob_item)[i]); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 308 | } |
| 309 | |
| 310 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 311 | l_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 312 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 313 | long x; |
| 314 | if (!PyArg_Parse(v, "l;array item must be integer", &x)) |
| 315 | return -1; |
| 316 | if (i >= 0) |
| 317 | ((long *)ap->ob_item)[i] = x; |
| 318 | return 0; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 319 | } |
| 320 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 321 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 322 | LL_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 323 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 324 | return PyLong_FromUnsignedLong(((unsigned long *)ap->ob_item)[i]); |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 325 | } |
| 326 | |
| 327 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 328 | LL_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 329 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 330 | unsigned long x; |
| 331 | if (PyLong_Check(v)) { |
| 332 | x = PyLong_AsUnsignedLong(v); |
| 333 | if (x == (unsigned long) -1 && PyErr_Occurred()) |
| 334 | return -1; |
| 335 | } |
| 336 | else { |
| 337 | long y; |
| 338 | if (!PyArg_Parse(v, "l;array item must be integer", &y)) |
| 339 | return -1; |
| 340 | if (y < 0) { |
| 341 | PyErr_SetString(PyExc_OverflowError, |
| 342 | "unsigned long is less than minimum"); |
| 343 | return -1; |
| 344 | } |
| 345 | x = (unsigned long)y; |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 346 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 347 | } |
| 348 | if (x > ULONG_MAX) { |
| 349 | PyErr_SetString(PyExc_OverflowError, |
| 350 | "unsigned long is greater than maximum"); |
| 351 | return -1; |
| 352 | } |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 353 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 354 | if (i >= 0) |
| 355 | ((unsigned long *)ap->ob_item)[i] = x; |
| 356 | return 0; |
Guido van Rossum | 549ab71 | 1997-01-03 19:09:47 +0000 | [diff] [blame] | 357 | } |
| 358 | |
| 359 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 360 | f_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 361 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 362 | return PyFloat_FromDouble((double) ((float *)ap->ob_item)[i]); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 363 | } |
| 364 | |
| 365 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 366 | f_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 367 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 368 | float x; |
| 369 | if (!PyArg_Parse(v, "f;array item must be float", &x)) |
| 370 | return -1; |
| 371 | if (i >= 0) |
| 372 | ((float *)ap->ob_item)[i] = x; |
| 373 | return 0; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 374 | } |
| 375 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 376 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 377 | d_getitem(arrayobject *ap, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 378 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 379 | return PyFloat_FromDouble(((double *)ap->ob_item)[i]); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 380 | } |
| 381 | |
| 382 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 383 | d_setitem(arrayobject *ap, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 384 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 385 | double x; |
| 386 | if (!PyArg_Parse(v, "d;array item must be float", &x)) |
| 387 | return -1; |
| 388 | if (i >= 0) |
| 389 | ((double *)ap->ob_item)[i] = x; |
| 390 | return 0; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 391 | } |
| 392 | |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 393 | |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 394 | /* Description of types. |
| 395 | * |
| 396 | * Don't forget to update typecode_to_mformat_code() if you add a new |
| 397 | * typecode. |
| 398 | */ |
Guido van Rossum | 234f942 | 1993-06-17 12:35:49 +0000 | [diff] [blame] | 399 | static struct arraydescr descriptors[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 400 | {'b', 1, b_getitem, b_setitem, "b", 1, 1}, |
| 401 | {'B', 1, BB_getitem, BB_setitem, "B", 1, 0}, |
| 402 | {'u', sizeof(Py_UNICODE), u_getitem, u_setitem, "u", 0, 0}, |
| 403 | {'h', sizeof(short), h_getitem, h_setitem, "h", 1, 1}, |
| 404 | {'H', sizeof(short), HH_getitem, HH_setitem, "H", 1, 0}, |
| 405 | {'i', sizeof(int), i_getitem, i_setitem, "i", 1, 1}, |
| 406 | {'I', sizeof(int), II_getitem, II_setitem, "I", 1, 0}, |
| 407 | {'l', sizeof(long), l_getitem, l_setitem, "l", 1, 1}, |
| 408 | {'L', sizeof(long), LL_getitem, LL_setitem, "L", 1, 0}, |
| 409 | {'f', sizeof(float), f_getitem, f_setitem, "f", 0, 0}, |
| 410 | {'d', sizeof(double), d_getitem, d_setitem, "d", 0, 0}, |
| 411 | {'\0', 0, 0, 0, 0, 0, 0} /* Sentinel */ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 412 | }; |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 413 | |
| 414 | /**************************************************************************** |
| 415 | Implementations of array object methods. |
| 416 | ****************************************************************************/ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 417 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 418 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 419 | newarrayobject(PyTypeObject *type, Py_ssize_t size, struct arraydescr *descr) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 420 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 421 | arrayobject *op; |
| 422 | size_t nbytes; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 423 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 424 | if (size < 0) { |
| 425 | PyErr_BadInternalCall(); |
| 426 | return NULL; |
| 427 | } |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 428 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 429 | nbytes = size * descr->itemsize; |
| 430 | /* Check for overflow */ |
| 431 | if (nbytes / descr->itemsize != (size_t)size) { |
| 432 | return PyErr_NoMemory(); |
| 433 | } |
| 434 | op = (arrayobject *) type->tp_alloc(type, 0); |
| 435 | if (op == NULL) { |
| 436 | return NULL; |
| 437 | } |
| 438 | op->ob_descr = descr; |
| 439 | op->allocated = size; |
| 440 | op->weakreflist = NULL; |
| 441 | Py_SIZE(op) = size; |
| 442 | if (size <= 0) { |
| 443 | op->ob_item = NULL; |
| 444 | } |
| 445 | else { |
| 446 | op->ob_item = PyMem_NEW(char, nbytes); |
| 447 | if (op->ob_item == NULL) { |
| 448 | Py_DECREF(op); |
| 449 | return PyErr_NoMemory(); |
| 450 | } |
| 451 | } |
| 452 | op->ob_exports = 0; |
| 453 | return (PyObject *) op; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 454 | } |
| 455 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 456 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 457 | getarrayitem(PyObject *op, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 458 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 459 | register arrayobject *ap; |
| 460 | assert(array_Check(op)); |
| 461 | ap = (arrayobject *)op; |
| 462 | assert(i>=0 && i<Py_SIZE(ap)); |
| 463 | return (*ap->ob_descr->getitem)(ap, i); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 464 | } |
| 465 | |
| 466 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 467 | ins1(arrayobject *self, Py_ssize_t where, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 468 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 469 | char *items; |
| 470 | Py_ssize_t n = Py_SIZE(self); |
| 471 | if (v == NULL) { |
| 472 | PyErr_BadInternalCall(); |
| 473 | return -1; |
| 474 | } |
| 475 | if ((*self->ob_descr->setitem)(self, -1, v) < 0) |
| 476 | return -1; |
Raymond Hettinger | 6e2ee86 | 2004-03-14 04:37:50 +0000 | [diff] [blame] | 477 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 478 | if (array_resize(self, n+1) == -1) |
| 479 | return -1; |
| 480 | items = self->ob_item; |
| 481 | if (where < 0) { |
| 482 | where += n; |
| 483 | if (where < 0) |
| 484 | where = 0; |
| 485 | } |
| 486 | if (where > n) |
| 487 | where = n; |
| 488 | /* appends don't need to call memmove() */ |
| 489 | if (where != n) |
| 490 | memmove(items + (where+1)*self->ob_descr->itemsize, |
| 491 | items + where*self->ob_descr->itemsize, |
| 492 | (n-where)*self->ob_descr->itemsize); |
| 493 | return (*self->ob_descr->setitem)(self, where, v); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 494 | } |
| 495 | |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 496 | /* Methods */ |
| 497 | |
| 498 | static void |
Peter Schneider-Kamp | 9656abd | 2000-07-13 21:10:57 +0000 | [diff] [blame] | 499 | array_dealloc(arrayobject *op) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 500 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 501 | if (op->weakreflist != NULL) |
| 502 | PyObject_ClearWeakRefs((PyObject *) op); |
| 503 | if (op->ob_item != NULL) |
| 504 | PyMem_DEL(op->ob_item); |
| 505 | Py_TYPE(op)->tp_free((PyObject *)op); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 506 | } |
| 507 | |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 508 | static PyObject * |
| 509 | array_richcompare(PyObject *v, PyObject *w, int op) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 510 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 511 | arrayobject *va, *wa; |
| 512 | PyObject *vi = NULL; |
| 513 | PyObject *wi = NULL; |
| 514 | Py_ssize_t i, k; |
| 515 | PyObject *res; |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 516 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 517 | if (!array_Check(v) || !array_Check(w)) { |
| 518 | Py_INCREF(Py_NotImplemented); |
| 519 | return Py_NotImplemented; |
| 520 | } |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 521 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 522 | va = (arrayobject *)v; |
| 523 | wa = (arrayobject *)w; |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 524 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 525 | if (Py_SIZE(va) != Py_SIZE(wa) && (op == Py_EQ || op == Py_NE)) { |
| 526 | /* Shortcut: if the lengths differ, the arrays differ */ |
| 527 | if (op == Py_EQ) |
| 528 | res = Py_False; |
| 529 | else |
| 530 | res = Py_True; |
| 531 | Py_INCREF(res); |
| 532 | return res; |
| 533 | } |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 534 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 535 | /* Search for the first index where items are different */ |
| 536 | k = 1; |
| 537 | for (i = 0; i < Py_SIZE(va) && i < Py_SIZE(wa); i++) { |
| 538 | vi = getarrayitem(v, i); |
| 539 | wi = getarrayitem(w, i); |
| 540 | if (vi == NULL || wi == NULL) { |
| 541 | Py_XDECREF(vi); |
| 542 | Py_XDECREF(wi); |
| 543 | return NULL; |
| 544 | } |
| 545 | k = PyObject_RichCompareBool(vi, wi, Py_EQ); |
| 546 | if (k == 0) |
| 547 | break; /* Keeping vi and wi alive! */ |
| 548 | Py_DECREF(vi); |
| 549 | Py_DECREF(wi); |
| 550 | if (k < 0) |
| 551 | return NULL; |
| 552 | } |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 553 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 554 | if (k) { |
| 555 | /* No more items to compare -- compare sizes */ |
| 556 | Py_ssize_t vs = Py_SIZE(va); |
| 557 | Py_ssize_t ws = Py_SIZE(wa); |
| 558 | int cmp; |
| 559 | switch (op) { |
| 560 | case Py_LT: cmp = vs < ws; break; |
| 561 | case Py_LE: cmp = vs <= ws; break; |
| 562 | case Py_EQ: cmp = vs == ws; break; |
| 563 | case Py_NE: cmp = vs != ws; break; |
| 564 | case Py_GT: cmp = vs > ws; break; |
| 565 | case Py_GE: cmp = vs >= ws; break; |
| 566 | default: return NULL; /* cannot happen */ |
| 567 | } |
| 568 | if (cmp) |
| 569 | res = Py_True; |
| 570 | else |
| 571 | res = Py_False; |
| 572 | Py_INCREF(res); |
| 573 | return res; |
| 574 | } |
Guido van Rossum | 9d19cb8 | 2001-01-18 01:02:55 +0000 | [diff] [blame] | 575 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 576 | /* We have an item that differs. First, shortcuts for EQ/NE */ |
| 577 | if (op == Py_EQ) { |
| 578 | Py_INCREF(Py_False); |
| 579 | res = Py_False; |
| 580 | } |
| 581 | else if (op == Py_NE) { |
| 582 | Py_INCREF(Py_True); |
| 583 | res = Py_True; |
| 584 | } |
| 585 | else { |
| 586 | /* Compare the final item again using the proper operator */ |
| 587 | res = PyObject_RichCompare(vi, wi, op); |
| 588 | } |
| 589 | Py_DECREF(vi); |
| 590 | Py_DECREF(wi); |
| 591 | return res; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 592 | } |
| 593 | |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 594 | static Py_ssize_t |
Peter Schneider-Kamp | 9656abd | 2000-07-13 21:10:57 +0000 | [diff] [blame] | 595 | array_length(arrayobject *a) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 596 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 597 | return Py_SIZE(a); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 598 | } |
| 599 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 600 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 601 | array_item(arrayobject *a, Py_ssize_t i) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 602 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 603 | if (i < 0 || i >= Py_SIZE(a)) { |
| 604 | PyErr_SetString(PyExc_IndexError, "array index out of range"); |
| 605 | return NULL; |
| 606 | } |
| 607 | return getarrayitem((PyObject *)a, i); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 608 | } |
| 609 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 610 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 611 | array_slice(arrayobject *a, Py_ssize_t ilow, Py_ssize_t ihigh) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 612 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 613 | arrayobject *np; |
| 614 | if (ilow < 0) |
| 615 | ilow = 0; |
| 616 | else if (ilow > Py_SIZE(a)) |
| 617 | ilow = Py_SIZE(a); |
| 618 | if (ihigh < 0) |
| 619 | ihigh = 0; |
| 620 | if (ihigh < ilow) |
| 621 | ihigh = ilow; |
| 622 | else if (ihigh > Py_SIZE(a)) |
| 623 | ihigh = Py_SIZE(a); |
| 624 | np = (arrayobject *) newarrayobject(&Arraytype, ihigh - ilow, a->ob_descr); |
| 625 | if (np == NULL) |
| 626 | return NULL; |
| 627 | memcpy(np->ob_item, a->ob_item + ilow * a->ob_descr->itemsize, |
| 628 | (ihigh-ilow) * a->ob_descr->itemsize); |
| 629 | return (PyObject *)np; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 630 | } |
| 631 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 632 | static PyObject * |
Raymond Hettinger | 3aa82c0 | 2004-03-13 18:18:51 +0000 | [diff] [blame] | 633 | array_copy(arrayobject *a, PyObject *unused) |
| 634 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 635 | return array_slice(a, 0, Py_SIZE(a)); |
Raymond Hettinger | 3aa82c0 | 2004-03-13 18:18:51 +0000 | [diff] [blame] | 636 | } |
| 637 | |
| 638 | PyDoc_STRVAR(copy_doc, |
| 639 | "copy(array)\n\ |
| 640 | \n\ |
| 641 | Return a copy of the array."); |
| 642 | |
| 643 | static PyObject * |
Peter Schneider-Kamp | 9656abd | 2000-07-13 21:10:57 +0000 | [diff] [blame] | 644 | array_concat(arrayobject *a, PyObject *bb) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 645 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 646 | Py_ssize_t size; |
| 647 | arrayobject *np; |
| 648 | if (!array_Check(bb)) { |
| 649 | PyErr_Format(PyExc_TypeError, |
| 650 | "can only append array (not \"%.200s\") to array", |
| 651 | Py_TYPE(bb)->tp_name); |
| 652 | return NULL; |
| 653 | } |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 654 | #define b ((arrayobject *)bb) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 655 | if (a->ob_descr != b->ob_descr) { |
| 656 | PyErr_BadArgument(); |
| 657 | return NULL; |
| 658 | } |
| 659 | if (Py_SIZE(a) > PY_SSIZE_T_MAX - Py_SIZE(b)) { |
| 660 | return PyErr_NoMemory(); |
| 661 | } |
| 662 | size = Py_SIZE(a) + Py_SIZE(b); |
| 663 | np = (arrayobject *) newarrayobject(&Arraytype, size, a->ob_descr); |
| 664 | if (np == NULL) { |
| 665 | return NULL; |
| 666 | } |
| 667 | memcpy(np->ob_item, a->ob_item, Py_SIZE(a)*a->ob_descr->itemsize); |
| 668 | memcpy(np->ob_item + Py_SIZE(a)*a->ob_descr->itemsize, |
| 669 | b->ob_item, Py_SIZE(b)*b->ob_descr->itemsize); |
| 670 | return (PyObject *)np; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 671 | #undef b |
| 672 | } |
| 673 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 674 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 675 | array_repeat(arrayobject *a, Py_ssize_t n) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 676 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 677 | Py_ssize_t size; |
| 678 | arrayobject *np; |
Georg Brandl | c29cc6a | 2010-12-04 11:02:04 +0000 | [diff] [blame] | 679 | Py_ssize_t oldbytes, newbytes; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 680 | if (n < 0) |
| 681 | n = 0; |
| 682 | if ((Py_SIZE(a) != 0) && (n > PY_SSIZE_T_MAX / Py_SIZE(a))) { |
| 683 | return PyErr_NoMemory(); |
| 684 | } |
| 685 | size = Py_SIZE(a) * n; |
| 686 | np = (arrayobject *) newarrayobject(&Arraytype, size, a->ob_descr); |
| 687 | if (np == NULL) |
| 688 | return NULL; |
Georg Brandl | c29cc6a | 2010-12-04 11:02:04 +0000 | [diff] [blame] | 689 | if (n == 0) |
| 690 | return (PyObject *)np; |
| 691 | oldbytes = Py_SIZE(a) * a->ob_descr->itemsize; |
| 692 | newbytes = oldbytes * n; |
| 693 | /* this follows the code in unicode_repeat */ |
| 694 | if (oldbytes == 1) { |
| 695 | memset(np->ob_item, a->ob_item[0], newbytes); |
| 696 | } else { |
| 697 | Py_ssize_t done = oldbytes; |
| 698 | Py_MEMCPY(np->ob_item, a->ob_item, oldbytes); |
| 699 | while (done < newbytes) { |
| 700 | Py_ssize_t ncopy = (done <= newbytes-done) ? done : newbytes-done; |
| 701 | Py_MEMCPY(np->ob_item+done, np->ob_item, ncopy); |
| 702 | done += ncopy; |
| 703 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 704 | } |
Georg Brandl | c29cc6a | 2010-12-04 11:02:04 +0000 | [diff] [blame] | 705 | return (PyObject *)np; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 706 | } |
| 707 | |
| 708 | static int |
Martin v. Löwis | ad0a462 | 2006-02-16 14:30:23 +0000 | [diff] [blame] | 709 | array_ass_slice(arrayobject *a, Py_ssize_t ilow, Py_ssize_t ihigh, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 710 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 711 | char *item; |
| 712 | Py_ssize_t n; /* Size of replacement array */ |
| 713 | Py_ssize_t d; /* Change in size */ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 714 | #define b ((arrayobject *)v) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 715 | if (v == NULL) |
| 716 | n = 0; |
| 717 | else if (array_Check(v)) { |
| 718 | n = Py_SIZE(b); |
| 719 | if (a == b) { |
| 720 | /* Special case "a[i:j] = a" -- copy b first */ |
| 721 | int ret; |
| 722 | v = array_slice(b, 0, n); |
| 723 | if (!v) |
| 724 | return -1; |
| 725 | ret = array_ass_slice(a, ilow, ihigh, v); |
| 726 | Py_DECREF(v); |
| 727 | return ret; |
| 728 | } |
| 729 | if (b->ob_descr != a->ob_descr) { |
| 730 | PyErr_BadArgument(); |
| 731 | return -1; |
| 732 | } |
| 733 | } |
| 734 | else { |
| 735 | PyErr_Format(PyExc_TypeError, |
| 736 | "can only assign array (not \"%.200s\") to array slice", |
| 737 | Py_TYPE(v)->tp_name); |
| 738 | return -1; |
| 739 | } |
| 740 | if (ilow < 0) |
| 741 | ilow = 0; |
| 742 | else if (ilow > Py_SIZE(a)) |
| 743 | ilow = Py_SIZE(a); |
| 744 | if (ihigh < 0) |
| 745 | ihigh = 0; |
| 746 | if (ihigh < ilow) |
| 747 | ihigh = ilow; |
| 748 | else if (ihigh > Py_SIZE(a)) |
| 749 | ihigh = Py_SIZE(a); |
| 750 | item = a->ob_item; |
| 751 | d = n - (ihigh-ilow); |
| 752 | /* Issue #4509: If the array has exported buffers and the slice |
| 753 | assignment would change the size of the array, fail early to make |
| 754 | sure we don't modify it. */ |
| 755 | if (d != 0 && a->ob_exports > 0) { |
| 756 | PyErr_SetString(PyExc_BufferError, |
| 757 | "cannot resize an array that is exporting buffers"); |
| 758 | return -1; |
| 759 | } |
| 760 | if (d < 0) { /* Delete -d items */ |
| 761 | memmove(item + (ihigh+d)*a->ob_descr->itemsize, |
| 762 | item + ihigh*a->ob_descr->itemsize, |
| 763 | (Py_SIZE(a)-ihigh)*a->ob_descr->itemsize); |
| 764 | if (array_resize(a, Py_SIZE(a) + d) == -1) |
| 765 | return -1; |
| 766 | } |
| 767 | else if (d > 0) { /* Insert d items */ |
| 768 | if (array_resize(a, Py_SIZE(a) + d)) |
| 769 | return -1; |
| 770 | memmove(item + (ihigh+d)*a->ob_descr->itemsize, |
| 771 | item + ihigh*a->ob_descr->itemsize, |
| 772 | (Py_SIZE(a)-ihigh)*a->ob_descr->itemsize); |
| 773 | } |
| 774 | if (n > 0) |
| 775 | memcpy(item + ilow*a->ob_descr->itemsize, b->ob_item, |
| 776 | n*b->ob_descr->itemsize); |
| 777 | return 0; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 778 | #undef b |
| 779 | } |
| 780 | |
| 781 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 782 | array_ass_item(arrayobject *a, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 783 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 784 | if (i < 0 || i >= Py_SIZE(a)) { |
| 785 | PyErr_SetString(PyExc_IndexError, |
| 786 | "array assignment index out of range"); |
| 787 | return -1; |
| 788 | } |
| 789 | if (v == NULL) |
| 790 | return array_ass_slice(a, i, i+1, v); |
| 791 | return (*a->ob_descr->setitem)(a, i, v); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 792 | } |
| 793 | |
| 794 | static int |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 795 | setarrayitem(PyObject *a, Py_ssize_t i, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 796 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 797 | assert(array_Check(a)); |
| 798 | return array_ass_item((arrayobject *)a, i, v); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 799 | } |
| 800 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 801 | static int |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 802 | array_iter_extend(arrayobject *self, PyObject *bb) |
| 803 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 804 | PyObject *it, *v; |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 805 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 806 | it = PyObject_GetIter(bb); |
| 807 | if (it == NULL) |
| 808 | return -1; |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 809 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 810 | while ((v = PyIter_Next(it)) != NULL) { |
Mark Dickinson | 346f0af | 2010-08-06 09:36:57 +0000 | [diff] [blame] | 811 | if (ins1(self, Py_SIZE(self), v) != 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 812 | Py_DECREF(v); |
| 813 | Py_DECREF(it); |
| 814 | return -1; |
| 815 | } |
| 816 | Py_DECREF(v); |
| 817 | } |
| 818 | Py_DECREF(it); |
| 819 | if (PyErr_Occurred()) |
| 820 | return -1; |
| 821 | return 0; |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 822 | } |
| 823 | |
| 824 | static int |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 825 | array_do_extend(arrayobject *self, PyObject *bb) |
| 826 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 827 | Py_ssize_t size, oldsize, bbsize; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 828 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 829 | if (!array_Check(bb)) |
| 830 | return array_iter_extend(self, bb); |
| 831 | #define b ((arrayobject *)bb) |
| 832 | if (self->ob_descr != b->ob_descr) { |
| 833 | PyErr_SetString(PyExc_TypeError, |
| 834 | "can only extend with array of same kind"); |
| 835 | return -1; |
| 836 | } |
| 837 | if ((Py_SIZE(self) > PY_SSIZE_T_MAX - Py_SIZE(b)) || |
| 838 | ((Py_SIZE(self) + Py_SIZE(b)) > PY_SSIZE_T_MAX / self->ob_descr->itemsize)) { |
| 839 | PyErr_NoMemory(); |
| 840 | return -1; |
| 841 | } |
| 842 | oldsize = Py_SIZE(self); |
| 843 | /* Get the size of bb before resizing the array since bb could be self. */ |
| 844 | bbsize = Py_SIZE(bb); |
| 845 | size = oldsize + Py_SIZE(b); |
| 846 | if (array_resize(self, size) == -1) |
| 847 | return -1; |
| 848 | memcpy(self->ob_item + oldsize * self->ob_descr->itemsize, |
| 849 | b->ob_item, bbsize * b->ob_descr->itemsize); |
| 850 | |
| 851 | return 0; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 852 | #undef b |
| 853 | } |
| 854 | |
| 855 | static PyObject * |
| 856 | array_inplace_concat(arrayobject *self, PyObject *bb) |
| 857 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 858 | if (!array_Check(bb)) { |
| 859 | PyErr_Format(PyExc_TypeError, |
| 860 | "can only extend array with array (not \"%.200s\")", |
| 861 | Py_TYPE(bb)->tp_name); |
| 862 | return NULL; |
| 863 | } |
| 864 | if (array_do_extend(self, bb) == -1) |
| 865 | return NULL; |
| 866 | Py_INCREF(self); |
| 867 | return (PyObject *)self; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 868 | } |
| 869 | |
| 870 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 871 | array_inplace_repeat(arrayobject *self, Py_ssize_t n) |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 872 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 873 | char *items, *p; |
| 874 | Py_ssize_t size, i; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 875 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 876 | if (Py_SIZE(self) > 0) { |
| 877 | if (n < 0) |
| 878 | n = 0; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 879 | if ((self->ob_descr->itemsize != 0) && |
| 880 | (Py_SIZE(self) > PY_SSIZE_T_MAX / self->ob_descr->itemsize)) { |
| 881 | return PyErr_NoMemory(); |
| 882 | } |
| 883 | size = Py_SIZE(self) * self->ob_descr->itemsize; |
| 884 | if (n > 0 && size > PY_SSIZE_T_MAX / n) { |
| 885 | return PyErr_NoMemory(); |
| 886 | } |
| 887 | if (array_resize(self, n * Py_SIZE(self)) == -1) |
| 888 | return NULL; |
| 889 | items = p = self->ob_item; |
| 890 | for (i = 1; i < n; i++) { |
| 891 | p += size; |
| 892 | memcpy(p, items, size); |
| 893 | } |
| 894 | } |
| 895 | Py_INCREF(self); |
| 896 | return (PyObject *)self; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 897 | } |
| 898 | |
| 899 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 900 | static PyObject * |
Martin v. Löwis | 18e1655 | 2006-02-15 17:27:45 +0000 | [diff] [blame] | 901 | ins(arrayobject *self, Py_ssize_t where, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 902 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 903 | if (ins1(self, where, v) != 0) |
| 904 | return NULL; |
| 905 | Py_INCREF(Py_None); |
| 906 | return Py_None; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 907 | } |
| 908 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 909 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 910 | array_count(arrayobject *self, PyObject *v) |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 911 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 912 | Py_ssize_t count = 0; |
| 913 | Py_ssize_t i; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 914 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 915 | for (i = 0; i < Py_SIZE(self); i++) { |
| 916 | PyObject *selfi = getarrayitem((PyObject *)self, i); |
| 917 | int cmp = PyObject_RichCompareBool(selfi, v, Py_EQ); |
| 918 | Py_DECREF(selfi); |
| 919 | if (cmp > 0) |
| 920 | count++; |
| 921 | else if (cmp < 0) |
| 922 | return NULL; |
| 923 | } |
| 924 | return PyLong_FromSsize_t(count); |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 925 | } |
| 926 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 927 | PyDoc_STRVAR(count_doc, |
Tim Peters | 077a11d | 2000-09-16 22:31:29 +0000 | [diff] [blame] | 928 | "count(x)\n\ |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 929 | \n\ |
Mark Dickinson | 934896d | 2009-02-21 20:59:32 +0000 | [diff] [blame] | 930 | Return number of occurrences of x in the array."); |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 931 | |
| 932 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 933 | array_index(arrayobject *self, PyObject *v) |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 934 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 935 | Py_ssize_t i; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 936 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 937 | for (i = 0; i < Py_SIZE(self); i++) { |
| 938 | PyObject *selfi = getarrayitem((PyObject *)self, i); |
| 939 | int cmp = PyObject_RichCompareBool(selfi, v, Py_EQ); |
| 940 | Py_DECREF(selfi); |
| 941 | if (cmp > 0) { |
| 942 | return PyLong_FromLong((long)i); |
| 943 | } |
| 944 | else if (cmp < 0) |
| 945 | return NULL; |
| 946 | } |
| 947 | PyErr_SetString(PyExc_ValueError, "array.index(x): x not in list"); |
| 948 | return NULL; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 949 | } |
| 950 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 951 | PyDoc_STRVAR(index_doc, |
Tim Peters | 077a11d | 2000-09-16 22:31:29 +0000 | [diff] [blame] | 952 | "index(x)\n\ |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 953 | \n\ |
Mark Dickinson | 934896d | 2009-02-21 20:59:32 +0000 | [diff] [blame] | 954 | Return index of first occurrence of x in the array."); |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 955 | |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 956 | static int |
| 957 | array_contains(arrayobject *self, PyObject *v) |
| 958 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 959 | Py_ssize_t i; |
| 960 | int cmp; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 961 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 962 | for (i = 0, cmp = 0 ; cmp == 0 && i < Py_SIZE(self); i++) { |
| 963 | PyObject *selfi = getarrayitem((PyObject *)self, i); |
| 964 | cmp = PyObject_RichCompareBool(selfi, v, Py_EQ); |
| 965 | Py_DECREF(selfi); |
| 966 | } |
| 967 | return cmp; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 968 | } |
| 969 | |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 970 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 971 | array_remove(arrayobject *self, PyObject *v) |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 972 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 973 | int i; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 974 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 975 | for (i = 0; i < Py_SIZE(self); i++) { |
| 976 | PyObject *selfi = getarrayitem((PyObject *)self,i); |
| 977 | int cmp = PyObject_RichCompareBool(selfi, v, Py_EQ); |
| 978 | Py_DECREF(selfi); |
| 979 | if (cmp > 0) { |
| 980 | if (array_ass_slice(self, i, i+1, |
| 981 | (PyObject *)NULL) != 0) |
| 982 | return NULL; |
| 983 | Py_INCREF(Py_None); |
| 984 | return Py_None; |
| 985 | } |
| 986 | else if (cmp < 0) |
| 987 | return NULL; |
| 988 | } |
| 989 | PyErr_SetString(PyExc_ValueError, "array.remove(x): x not in list"); |
| 990 | return NULL; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 991 | } |
| 992 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 993 | PyDoc_STRVAR(remove_doc, |
Tim Peters | 077a11d | 2000-09-16 22:31:29 +0000 | [diff] [blame] | 994 | "remove(x)\n\ |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 995 | \n\ |
Mark Dickinson | 934896d | 2009-02-21 20:59:32 +0000 | [diff] [blame] | 996 | Remove the first occurrence of x in the array."); |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 997 | |
| 998 | static PyObject * |
| 999 | array_pop(arrayobject *self, PyObject *args) |
| 1000 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1001 | Py_ssize_t i = -1; |
| 1002 | PyObject *v; |
| 1003 | if (!PyArg_ParseTuple(args, "|n:pop", &i)) |
| 1004 | return NULL; |
| 1005 | if (Py_SIZE(self) == 0) { |
| 1006 | /* Special-case most common failure cause */ |
| 1007 | PyErr_SetString(PyExc_IndexError, "pop from empty array"); |
| 1008 | return NULL; |
| 1009 | } |
| 1010 | if (i < 0) |
| 1011 | i += Py_SIZE(self); |
| 1012 | if (i < 0 || i >= Py_SIZE(self)) { |
| 1013 | PyErr_SetString(PyExc_IndexError, "pop index out of range"); |
| 1014 | return NULL; |
| 1015 | } |
| 1016 | v = getarrayitem((PyObject *)self,i); |
| 1017 | if (array_ass_slice(self, i, i+1, (PyObject *)NULL) != 0) { |
| 1018 | Py_DECREF(v); |
| 1019 | return NULL; |
| 1020 | } |
| 1021 | return v; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1022 | } |
| 1023 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1024 | PyDoc_STRVAR(pop_doc, |
Tim Peters | 077a11d | 2000-09-16 22:31:29 +0000 | [diff] [blame] | 1025 | "pop([i])\n\ |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1026 | \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1027 | Return the i-th element and delete it from the array. i defaults to -1."); |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1028 | |
| 1029 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1030 | array_extend(arrayobject *self, PyObject *bb) |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1031 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1032 | if (array_do_extend(self, bb) == -1) |
| 1033 | return NULL; |
| 1034 | Py_INCREF(Py_None); |
| 1035 | return Py_None; |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1036 | } |
| 1037 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1038 | PyDoc_STRVAR(extend_doc, |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 1039 | "extend(array or iterable)\n\ |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1040 | \n\ |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 1041 | Append items to the end of the array."); |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 1042 | |
| 1043 | static PyObject * |
Peter Schneider-Kamp | 9656abd | 2000-07-13 21:10:57 +0000 | [diff] [blame] | 1044 | array_insert(arrayobject *self, PyObject *args) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1045 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1046 | Py_ssize_t i; |
| 1047 | PyObject *v; |
| 1048 | if (!PyArg_ParseTuple(args, "nO:insert", &i, &v)) |
| 1049 | return NULL; |
| 1050 | return ins(self, i, v); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1051 | } |
| 1052 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1053 | PyDoc_STRVAR(insert_doc, |
Tim Peters | 077a11d | 2000-09-16 22:31:29 +0000 | [diff] [blame] | 1054 | "insert(i,x)\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1055 | \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1056 | Insert a new item x into the array before position i."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1057 | |
| 1058 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1059 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1060 | array_buffer_info(arrayobject *self, PyObject *unused) |
Guido van Rossum | de4a4ca | 1997-08-12 14:55:56 +0000 | [diff] [blame] | 1061 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1062 | PyObject* retval = NULL; |
| 1063 | retval = PyTuple_New(2); |
| 1064 | if (!retval) |
| 1065 | return NULL; |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 1066 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1067 | PyTuple_SET_ITEM(retval, 0, PyLong_FromVoidPtr(self->ob_item)); |
| 1068 | PyTuple_SET_ITEM(retval, 1, PyLong_FromLong((long)(Py_SIZE(self)))); |
Fred Drake | 541dc3b | 2000-06-28 17:49:30 +0000 | [diff] [blame] | 1069 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1070 | return retval; |
Guido van Rossum | de4a4ca | 1997-08-12 14:55:56 +0000 | [diff] [blame] | 1071 | } |
| 1072 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1073 | PyDoc_STRVAR(buffer_info_doc, |
Tim Peters | 077a11d | 2000-09-16 22:31:29 +0000 | [diff] [blame] | 1074 | "buffer_info() -> (address, length)\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1075 | \n\ |
| 1076 | Return a tuple (address, length) giving the current memory address and\n\ |
Guido van Rossum | 702d08e | 2001-07-27 16:05:32 +0000 | [diff] [blame] | 1077 | the length in items of the buffer used to hold array's contents\n\ |
| 1078 | The length should be multiplied by the itemsize attribute to calculate\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1079 | the buffer length in bytes."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1080 | |
| 1081 | |
Guido van Rossum | de4a4ca | 1997-08-12 14:55:56 +0000 | [diff] [blame] | 1082 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1083 | array_append(arrayobject *self, PyObject *v) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1084 | { |
Mark Dickinson | 346f0af | 2010-08-06 09:36:57 +0000 | [diff] [blame] | 1085 | return ins(self, Py_SIZE(self), v); |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1086 | } |
| 1087 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1088 | PyDoc_STRVAR(append_doc, |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1089 | "append(x)\n\ |
| 1090 | \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1091 | Append new value x to the end of the array."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1092 | |
| 1093 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1094 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1095 | array_byteswap(arrayobject *self, PyObject *unused) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1096 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1097 | char *p; |
| 1098 | Py_ssize_t i; |
Fred Drake | bf27298 | 1999-12-03 17:15:30 +0000 | [diff] [blame] | 1099 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1100 | switch (self->ob_descr->itemsize) { |
| 1101 | case 1: |
| 1102 | break; |
| 1103 | case 2: |
| 1104 | for (p = self->ob_item, i = Py_SIZE(self); --i >= 0; p += 2) { |
| 1105 | char p0 = p[0]; |
| 1106 | p[0] = p[1]; |
| 1107 | p[1] = p0; |
| 1108 | } |
| 1109 | break; |
| 1110 | case 4: |
| 1111 | for (p = self->ob_item, i = Py_SIZE(self); --i >= 0; p += 4) { |
| 1112 | char p0 = p[0]; |
| 1113 | char p1 = p[1]; |
| 1114 | p[0] = p[3]; |
| 1115 | p[1] = p[2]; |
| 1116 | p[2] = p1; |
| 1117 | p[3] = p0; |
| 1118 | } |
| 1119 | break; |
| 1120 | case 8: |
| 1121 | for (p = self->ob_item, i = Py_SIZE(self); --i >= 0; p += 8) { |
| 1122 | char p0 = p[0]; |
| 1123 | char p1 = p[1]; |
| 1124 | char p2 = p[2]; |
| 1125 | char p3 = p[3]; |
| 1126 | p[0] = p[7]; |
| 1127 | p[1] = p[6]; |
| 1128 | p[2] = p[5]; |
| 1129 | p[3] = p[4]; |
| 1130 | p[4] = p3; |
| 1131 | p[5] = p2; |
| 1132 | p[6] = p1; |
| 1133 | p[7] = p0; |
| 1134 | } |
| 1135 | break; |
| 1136 | default: |
| 1137 | PyErr_SetString(PyExc_RuntimeError, |
| 1138 | "don't know how to byteswap this array type"); |
| 1139 | return NULL; |
| 1140 | } |
| 1141 | Py_INCREF(Py_None); |
| 1142 | return Py_None; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1143 | } |
| 1144 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1145 | PyDoc_STRVAR(byteswap_doc, |
Fred Drake | bf27298 | 1999-12-03 17:15:30 +0000 | [diff] [blame] | 1146 | "byteswap()\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1147 | \n\ |
Fred Drake | bf27298 | 1999-12-03 17:15:30 +0000 | [diff] [blame] | 1148 | Byteswap all items of the array. If the items in the array are not 1, 2,\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1149 | 4, or 8 bytes in size, RuntimeError is raised."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1150 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1151 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1152 | array_reverse(arrayobject *self, PyObject *unused) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1153 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1154 | register Py_ssize_t itemsize = self->ob_descr->itemsize; |
| 1155 | register char *p, *q; |
| 1156 | /* little buffer to hold items while swapping */ |
| 1157 | char tmp[256]; /* 8 is probably enough -- but why skimp */ |
| 1158 | assert((size_t)itemsize <= sizeof(tmp)); |
Guido van Rossum | e77a757 | 1993-11-03 15:01:26 +0000 | [diff] [blame] | 1159 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1160 | if (Py_SIZE(self) > 1) { |
| 1161 | for (p = self->ob_item, |
| 1162 | q = self->ob_item + (Py_SIZE(self) - 1)*itemsize; |
| 1163 | p < q; |
| 1164 | p += itemsize, q -= itemsize) { |
| 1165 | /* memory areas guaranteed disjoint, so memcpy |
| 1166 | * is safe (& memmove may be slower). |
| 1167 | */ |
| 1168 | memcpy(tmp, p, itemsize); |
| 1169 | memcpy(p, q, itemsize); |
| 1170 | memcpy(q, tmp, itemsize); |
| 1171 | } |
| 1172 | } |
Tim Peters | bb30734 | 2000-09-10 05:22:54 +0000 | [diff] [blame] | 1173 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1174 | Py_INCREF(Py_None); |
| 1175 | return Py_None; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1176 | } |
Guido van Rossum | e77a757 | 1993-11-03 15:01:26 +0000 | [diff] [blame] | 1177 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1178 | PyDoc_STRVAR(reverse_doc, |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1179 | "reverse()\n\ |
| 1180 | \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1181 | Reverse the order of the items in the array."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1182 | |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1183 | |
| 1184 | /* Forward */ |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1185 | static PyObject *array_frombytes(arrayobject *self, PyObject *args); |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1186 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1187 | static PyObject * |
Peter Schneider-Kamp | 9656abd | 2000-07-13 21:10:57 +0000 | [diff] [blame] | 1188 | array_fromfile(arrayobject *self, PyObject *args) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1189 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1190 | PyObject *f, *b, *res; |
| 1191 | Py_ssize_t itemsize = self->ob_descr->itemsize; |
| 1192 | Py_ssize_t n, nbytes; |
| 1193 | int not_enough_bytes; |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1194 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1195 | if (!PyArg_ParseTuple(args, "On:fromfile", &f, &n)) |
| 1196 | return NULL; |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1197 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1198 | nbytes = n * itemsize; |
| 1199 | if (nbytes < 0 || nbytes/itemsize != n) { |
| 1200 | PyErr_NoMemory(); |
| 1201 | return NULL; |
| 1202 | } |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1203 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1204 | b = PyObject_CallMethod(f, "read", "n", nbytes); |
| 1205 | if (b == NULL) |
| 1206 | return NULL; |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1207 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1208 | if (!PyBytes_Check(b)) { |
| 1209 | PyErr_SetString(PyExc_TypeError, |
| 1210 | "read() didn't return bytes"); |
| 1211 | Py_DECREF(b); |
| 1212 | return NULL; |
| 1213 | } |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1214 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1215 | not_enough_bytes = (PyBytes_GET_SIZE(b) != nbytes); |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1216 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1217 | args = Py_BuildValue("(O)", b); |
| 1218 | Py_DECREF(b); |
| 1219 | if (args == NULL) |
| 1220 | return NULL; |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1221 | |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1222 | res = array_frombytes(self, args); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1223 | Py_DECREF(args); |
| 1224 | if (res == NULL) |
| 1225 | return NULL; |
Hirokazu Yamamoto | 54d0df6 | 2009-03-06 03:04:07 +0000 | [diff] [blame] | 1226 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1227 | if (not_enough_bytes) { |
| 1228 | PyErr_SetString(PyExc_EOFError, |
| 1229 | "read() didn't return enough bytes"); |
| 1230 | Py_DECREF(res); |
| 1231 | return NULL; |
| 1232 | } |
Guido van Rossum | 2c94aa5 | 2007-05-24 19:02:32 +0000 | [diff] [blame] | 1233 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1234 | return res; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1235 | } |
| 1236 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1237 | PyDoc_STRVAR(fromfile_doc, |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1238 | "fromfile(f, n)\n\ |
| 1239 | \n\ |
| 1240 | Read n objects from the file object f and append them to the end of the\n\ |
Georg Brandl | f25ef50 | 2008-02-01 11:30:18 +0000 | [diff] [blame] | 1241 | array."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1242 | |
| 1243 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1244 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1245 | array_tofile(arrayobject *self, PyObject *f) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1246 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1247 | Py_ssize_t nbytes = Py_SIZE(self) * self->ob_descr->itemsize; |
| 1248 | /* Write 64K blocks at a time */ |
| 1249 | /* XXX Make the block size settable */ |
| 1250 | int BLOCKSIZE = 64*1024; |
| 1251 | Py_ssize_t nblocks = (nbytes + BLOCKSIZE - 1) / BLOCKSIZE; |
| 1252 | Py_ssize_t i; |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1253 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1254 | if (Py_SIZE(self) == 0) |
| 1255 | goto done; |
Guido van Rossum | b5ddcfd | 2007-04-11 17:08:28 +0000 | [diff] [blame] | 1256 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1257 | for (i = 0; i < nblocks; i++) { |
| 1258 | char* ptr = self->ob_item + i*BLOCKSIZE; |
| 1259 | Py_ssize_t size = BLOCKSIZE; |
| 1260 | PyObject *bytes, *res; |
| 1261 | if (i*BLOCKSIZE + size > nbytes) |
| 1262 | size = nbytes - i*BLOCKSIZE; |
| 1263 | bytes = PyBytes_FromStringAndSize(ptr, size); |
| 1264 | if (bytes == NULL) |
| 1265 | return NULL; |
| 1266 | res = PyObject_CallMethod(f, "write", "O", bytes); |
| 1267 | Py_DECREF(bytes); |
| 1268 | if (res == NULL) |
| 1269 | return NULL; |
| 1270 | Py_DECREF(res); /* drop write result */ |
| 1271 | } |
Guido van Rossum | b5ddcfd | 2007-04-11 17:08:28 +0000 | [diff] [blame] | 1272 | |
| 1273 | done: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1274 | Py_INCREF(Py_None); |
| 1275 | return Py_None; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1276 | } |
| 1277 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1278 | PyDoc_STRVAR(tofile_doc, |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1279 | "tofile(f)\n\ |
| 1280 | \n\ |
Georg Brandl | f25ef50 | 2008-02-01 11:30:18 +0000 | [diff] [blame] | 1281 | Write all items (as machine values) to the file object f."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1282 | |
| 1283 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1284 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1285 | array_fromlist(arrayobject *self, PyObject *list) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1286 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1287 | Py_ssize_t n; |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1288 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1289 | if (!PyList_Check(list)) { |
| 1290 | PyErr_SetString(PyExc_TypeError, "arg must be list"); |
| 1291 | return NULL; |
| 1292 | } |
| 1293 | n = PyList_Size(list); |
| 1294 | if (n > 0) { |
| 1295 | Py_ssize_t i, old_size; |
| 1296 | old_size = Py_SIZE(self); |
| 1297 | if (array_resize(self, old_size + n) == -1) |
| 1298 | return NULL; |
| 1299 | for (i = 0; i < n; i++) { |
| 1300 | PyObject *v = PyList_GetItem(list, i); |
| 1301 | if ((*self->ob_descr->setitem)(self, |
| 1302 | Py_SIZE(self) - n + i, v) != 0) { |
| 1303 | array_resize(self, old_size); |
| 1304 | return NULL; |
| 1305 | } |
| 1306 | } |
| 1307 | } |
| 1308 | Py_INCREF(Py_None); |
| 1309 | return Py_None; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1310 | } |
| 1311 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1312 | PyDoc_STRVAR(fromlist_doc, |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1313 | "fromlist(list)\n\ |
| 1314 | \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1315 | Append items to array from list."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1316 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1317 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1318 | array_tolist(arrayobject *self, PyObject *unused) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1319 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1320 | PyObject *list = PyList_New(Py_SIZE(self)); |
| 1321 | Py_ssize_t i; |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1322 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1323 | if (list == NULL) |
| 1324 | return NULL; |
| 1325 | for (i = 0; i < Py_SIZE(self); i++) { |
| 1326 | PyObject *v = getarrayitem((PyObject *)self, i); |
| 1327 | if (v == NULL) { |
| 1328 | Py_DECREF(list); |
| 1329 | return NULL; |
| 1330 | } |
| 1331 | PyList_SetItem(list, i, v); |
| 1332 | } |
| 1333 | return list; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1334 | } |
| 1335 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1336 | PyDoc_STRVAR(tolist_doc, |
Guido van Rossum | fc6aba5 | 1998-10-14 02:52:31 +0000 | [diff] [blame] | 1337 | "tolist() -> list\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1338 | \n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1339 | Convert array to an ordinary list with the same items."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1340 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1341 | static PyObject * |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1342 | frombytes(arrayobject *self, Py_buffer *buffer) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1343 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1344 | int itemsize = self->ob_descr->itemsize; |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1345 | Py_ssize_t n; |
| 1346 | if (buffer->itemsize != 1) { |
| 1347 | PyBuffer_Release(buffer); |
| 1348 | PyErr_SetString(PyExc_TypeError, "string/buffer of bytes required."); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1349 | return NULL; |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1350 | } |
| 1351 | n = buffer->len; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1352 | if (n % itemsize != 0) { |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1353 | PyBuffer_Release(buffer); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1354 | PyErr_SetString(PyExc_ValueError, |
| 1355 | "string length not a multiple of item size"); |
| 1356 | return NULL; |
| 1357 | } |
| 1358 | n = n / itemsize; |
| 1359 | if (n > 0) { |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1360 | Py_ssize_t old_size = Py_SIZE(self); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1361 | if ((n > PY_SSIZE_T_MAX - old_size) || |
| 1362 | ((old_size + n) > PY_SSIZE_T_MAX / itemsize)) { |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1363 | PyBuffer_Release(buffer); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1364 | return PyErr_NoMemory(); |
| 1365 | } |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1366 | if (array_resize(self, old_size + n) == -1) { |
| 1367 | PyBuffer_Release(buffer); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1368 | return NULL; |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1369 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1370 | memcpy(self->ob_item + old_size * itemsize, |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1371 | buffer->buf, n * itemsize); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1372 | } |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1373 | PyBuffer_Release(buffer); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1374 | Py_INCREF(Py_None); |
| 1375 | return Py_None; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1376 | } |
| 1377 | |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1378 | static PyObject * |
| 1379 | array_fromstring(arrayobject *self, PyObject *args) |
| 1380 | { |
| 1381 | Py_buffer buffer; |
| 1382 | if (PyErr_WarnEx(PyExc_DeprecationWarning, |
| 1383 | "fromstring() is deprecated. Use frombytes() instead.", 2) != 0) |
| 1384 | return NULL; |
| 1385 | if (!PyArg_ParseTuple(args, "s*:fromstring", &buffer)) |
| 1386 | return NULL; |
| 1387 | else |
| 1388 | return frombytes(self, &buffer); |
| 1389 | } |
| 1390 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1391 | PyDoc_STRVAR(fromstring_doc, |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1392 | "fromstring(string)\n\ |
| 1393 | \n\ |
| 1394 | Appends items from the string, interpreting it as an array of machine\n\ |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1395 | values, as if it had been read from a file using the fromfile() method).\n\ |
| 1396 | \n\ |
| 1397 | This method is deprecated. Use frombytes instead."); |
| 1398 | |
| 1399 | |
| 1400 | static PyObject * |
| 1401 | array_frombytes(arrayobject *self, PyObject *args) |
| 1402 | { |
| 1403 | Py_buffer buffer; |
| 1404 | if (!PyArg_ParseTuple(args, "y*:frombytes", &buffer)) |
| 1405 | return NULL; |
| 1406 | else |
| 1407 | return frombytes(self, &buffer); |
| 1408 | } |
| 1409 | |
| 1410 | PyDoc_STRVAR(frombytes_doc, |
| 1411 | "frombytes(bytestring)\n\ |
| 1412 | \n\ |
| 1413 | Appends items from the string, interpreting it as an array of machine\n\ |
Walter Dörwald | 93b30b5 | 2007-06-22 12:21:53 +0000 | [diff] [blame] | 1414 | values, as if it had been read from a file using the fromfile() method)."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1415 | |
| 1416 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 1417 | static PyObject * |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1418 | array_tobytes(arrayobject *self, PyObject *unused) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1419 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1420 | if (Py_SIZE(self) <= PY_SSIZE_T_MAX / self->ob_descr->itemsize) { |
| 1421 | return PyBytes_FromStringAndSize(self->ob_item, |
| 1422 | Py_SIZE(self) * self->ob_descr->itemsize); |
| 1423 | } else { |
| 1424 | return PyErr_NoMemory(); |
| 1425 | } |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 1426 | } |
| 1427 | |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1428 | PyDoc_STRVAR(tobytes_doc, |
| 1429 | "tobytes() -> bytes\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1430 | \n\ |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1431 | Convert the array to an array of machine values and return the bytes\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1432 | representation."); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 1433 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1434 | |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1435 | static PyObject * |
| 1436 | array_tostring(arrayobject *self, PyObject *unused) |
| 1437 | { |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 1438 | if (PyErr_WarnEx(PyExc_DeprecationWarning, |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1439 | "tostring() is deprecated. Use tobytes() instead.", 2) != 0) |
| 1440 | return NULL; |
| 1441 | return array_tobytes(self, unused); |
| 1442 | } |
| 1443 | |
| 1444 | PyDoc_STRVAR(tostring_doc, |
| 1445 | "tostring() -> bytes\n\ |
| 1446 | \n\ |
| 1447 | Convert the array to an array of machine values and return the bytes\n\ |
| 1448 | representation.\n\ |
| 1449 | \n\ |
| 1450 | This method is deprecated. Use tobytes instead."); |
| 1451 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1452 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1453 | static PyObject * |
| 1454 | array_fromunicode(arrayobject *self, PyObject *args) |
| 1455 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1456 | Py_UNICODE *ustr; |
| 1457 | Py_ssize_t n; |
Amaury Forgeot d'Arc | 24aa26b | 2010-11-25 08:13:35 +0000 | [diff] [blame] | 1458 | Py_UNICODE typecode; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1459 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1460 | if (!PyArg_ParseTuple(args, "u#:fromunicode", &ustr, &n)) |
| 1461 | return NULL; |
| 1462 | typecode = self->ob_descr->typecode; |
| 1463 | if ((typecode != 'u')) { |
| 1464 | PyErr_SetString(PyExc_ValueError, |
| 1465 | "fromunicode() may only be called on " |
| 1466 | "unicode type arrays"); |
| 1467 | return NULL; |
| 1468 | } |
| 1469 | if (n > 0) { |
| 1470 | Py_ssize_t old_size = Py_SIZE(self); |
| 1471 | if (array_resize(self, old_size + n) == -1) |
| 1472 | return NULL; |
| 1473 | memcpy(self->ob_item + old_size * sizeof(Py_UNICODE), |
| 1474 | ustr, n * sizeof(Py_UNICODE)); |
| 1475 | } |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1476 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1477 | Py_INCREF(Py_None); |
| 1478 | return Py_None; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1479 | } |
| 1480 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1481 | PyDoc_STRVAR(fromunicode_doc, |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1482 | "fromunicode(ustr)\n\ |
| 1483 | \n\ |
| 1484 | Extends this array with data from the unicode string ustr.\n\ |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 1485 | The array must be a unicode type array; otherwise a ValueError\n\ |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1486 | is raised. Use array.frombytes(ustr.decode(...)) to\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1487 | append Unicode data to an array of some other type."); |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1488 | |
| 1489 | |
| 1490 | static PyObject * |
Raymond Hettinger | 36cd2bf | 2003-01-03 08:24:58 +0000 | [diff] [blame] | 1491 | array_tounicode(arrayobject *self, PyObject *unused) |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1492 | { |
Amaury Forgeot d'Arc | 24aa26b | 2010-11-25 08:13:35 +0000 | [diff] [blame] | 1493 | Py_UNICODE typecode; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1494 | typecode = self->ob_descr->typecode; |
| 1495 | if ((typecode != 'u')) { |
| 1496 | PyErr_SetString(PyExc_ValueError, |
| 1497 | "tounicode() may only be called on unicode type arrays"); |
| 1498 | return NULL; |
| 1499 | } |
| 1500 | return PyUnicode_FromUnicode((Py_UNICODE *) self->ob_item, Py_SIZE(self)); |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1501 | } |
| 1502 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1503 | PyDoc_STRVAR(tounicode_doc, |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1504 | "tounicode() -> unicode\n\ |
| 1505 | \n\ |
| 1506 | Convert the array to a unicode string. The array must be\n\ |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 1507 | a unicode type array; otherwise a ValueError is raised. Use\n\ |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1508 | array.tostring().decode() to obtain a unicode string from\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 1509 | an array of some other type."); |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1510 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 1511 | |
| 1512 | |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1513 | /*********************** Pickling support ************************/ |
| 1514 | |
| 1515 | enum machine_format_code { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1516 | UNKNOWN_FORMAT = -1, |
| 1517 | /* UNKNOWN_FORMAT is used to indicate that the machine format for an |
| 1518 | * array type code cannot be interpreted. When this occurs, a list of |
| 1519 | * Python objects is used to represent the content of the array |
| 1520 | * instead of using the memory content of the array directly. In that |
| 1521 | * case, the array_reconstructor mechanism is bypassed completely, and |
| 1522 | * the standard array constructor is used instead. |
| 1523 | * |
| 1524 | * This is will most likely occur when the machine doesn't use IEEE |
| 1525 | * floating-point numbers. |
| 1526 | */ |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1527 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1528 | UNSIGNED_INT8 = 0, |
| 1529 | SIGNED_INT8 = 1, |
| 1530 | UNSIGNED_INT16_LE = 2, |
| 1531 | UNSIGNED_INT16_BE = 3, |
| 1532 | SIGNED_INT16_LE = 4, |
| 1533 | SIGNED_INT16_BE = 5, |
| 1534 | UNSIGNED_INT32_LE = 6, |
| 1535 | UNSIGNED_INT32_BE = 7, |
| 1536 | SIGNED_INT32_LE = 8, |
| 1537 | SIGNED_INT32_BE = 9, |
| 1538 | UNSIGNED_INT64_LE = 10, |
| 1539 | UNSIGNED_INT64_BE = 11, |
| 1540 | SIGNED_INT64_LE = 12, |
| 1541 | SIGNED_INT64_BE = 13, |
| 1542 | IEEE_754_FLOAT_LE = 14, |
| 1543 | IEEE_754_FLOAT_BE = 15, |
| 1544 | IEEE_754_DOUBLE_LE = 16, |
| 1545 | IEEE_754_DOUBLE_BE = 17, |
| 1546 | UTF16_LE = 18, |
| 1547 | UTF16_BE = 19, |
| 1548 | UTF32_LE = 20, |
| 1549 | UTF32_BE = 21 |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1550 | }; |
| 1551 | #define MACHINE_FORMAT_CODE_MIN 0 |
| 1552 | #define MACHINE_FORMAT_CODE_MAX 21 |
| 1553 | |
| 1554 | static const struct mformatdescr { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1555 | size_t size; |
| 1556 | int is_signed; |
| 1557 | int is_big_endian; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1558 | } mformat_descriptors[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1559 | {1, 0, 0}, /* 0: UNSIGNED_INT8 */ |
| 1560 | {1, 1, 0}, /* 1: SIGNED_INT8 */ |
| 1561 | {2, 0, 0}, /* 2: UNSIGNED_INT16_LE */ |
| 1562 | {2, 0, 1}, /* 3: UNSIGNED_INT16_BE */ |
| 1563 | {2, 1, 0}, /* 4: SIGNED_INT16_LE */ |
| 1564 | {2, 1, 1}, /* 5: SIGNED_INT16_BE */ |
| 1565 | {4, 0, 0}, /* 6: UNSIGNED_INT32_LE */ |
| 1566 | {4, 0, 1}, /* 7: UNSIGNED_INT32_BE */ |
| 1567 | {4, 1, 0}, /* 8: SIGNED_INT32_LE */ |
| 1568 | {4, 1, 1}, /* 9: SIGNED_INT32_BE */ |
| 1569 | {8, 0, 0}, /* 10: UNSIGNED_INT64_LE */ |
| 1570 | {8, 0, 1}, /* 11: UNSIGNED_INT64_BE */ |
| 1571 | {8, 1, 0}, /* 12: SIGNED_INT64_LE */ |
| 1572 | {8, 1, 1}, /* 13: SIGNED_INT64_BE */ |
| 1573 | {4, 0, 0}, /* 14: IEEE_754_FLOAT_LE */ |
| 1574 | {4, 0, 1}, /* 15: IEEE_754_FLOAT_BE */ |
| 1575 | {8, 0, 0}, /* 16: IEEE_754_DOUBLE_LE */ |
| 1576 | {8, 0, 1}, /* 17: IEEE_754_DOUBLE_BE */ |
| 1577 | {4, 0, 0}, /* 18: UTF16_LE */ |
| 1578 | {4, 0, 1}, /* 19: UTF16_BE */ |
| 1579 | {8, 0, 0}, /* 20: UTF32_LE */ |
| 1580 | {8, 0, 1} /* 21: UTF32_BE */ |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1581 | }; |
| 1582 | |
| 1583 | |
| 1584 | /* |
| 1585 | * Internal: This function is used to find the machine format of a given |
| 1586 | * array type code. This returns UNKNOWN_FORMAT when the machine format cannot |
| 1587 | * be found. |
| 1588 | */ |
| 1589 | static enum machine_format_code |
| 1590 | typecode_to_mformat_code(int typecode) |
| 1591 | { |
Alexandre Vassalotti | 7aaa770 | 2009-07-17 03:51:27 +0000 | [diff] [blame] | 1592 | #ifdef WORDS_BIGENDIAN |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1593 | const int is_big_endian = 1; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1594 | #else |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1595 | const int is_big_endian = 0; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1596 | #endif |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1597 | size_t intsize; |
| 1598 | int is_signed; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1599 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1600 | switch (typecode) { |
| 1601 | case 'b': |
| 1602 | return SIGNED_INT8; |
| 1603 | case 'B': |
| 1604 | return UNSIGNED_INT8; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1605 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1606 | case 'u': |
| 1607 | if (sizeof(Py_UNICODE) == 2) { |
| 1608 | return UTF16_LE + is_big_endian; |
| 1609 | } |
| 1610 | if (sizeof(Py_UNICODE) == 4) { |
| 1611 | return UTF32_LE + is_big_endian; |
| 1612 | } |
| 1613 | return UNKNOWN_FORMAT; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1614 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1615 | case 'f': |
| 1616 | if (sizeof(float) == 4) { |
| 1617 | const float y = 16711938.0; |
| 1618 | if (memcmp(&y, "\x4b\x7f\x01\x02", 4) == 0) |
| 1619 | return IEEE_754_FLOAT_BE; |
| 1620 | if (memcmp(&y, "\x02\x01\x7f\x4b", 4) == 0) |
| 1621 | return IEEE_754_FLOAT_LE; |
| 1622 | } |
| 1623 | return UNKNOWN_FORMAT; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1624 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1625 | case 'd': |
| 1626 | if (sizeof(double) == 8) { |
| 1627 | const double x = 9006104071832581.0; |
| 1628 | if (memcmp(&x, "\x43\x3f\xff\x01\x02\x03\x04\x05", 8) == 0) |
| 1629 | return IEEE_754_DOUBLE_BE; |
| 1630 | if (memcmp(&x, "\x05\x04\x03\x02\x01\xff\x3f\x43", 8) == 0) |
| 1631 | return IEEE_754_DOUBLE_LE; |
| 1632 | } |
| 1633 | return UNKNOWN_FORMAT; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1634 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1635 | /* Integers */ |
| 1636 | case 'h': |
| 1637 | intsize = sizeof(short); |
| 1638 | is_signed = 1; |
| 1639 | break; |
| 1640 | case 'H': |
| 1641 | intsize = sizeof(short); |
| 1642 | is_signed = 0; |
| 1643 | break; |
| 1644 | case 'i': |
| 1645 | intsize = sizeof(int); |
| 1646 | is_signed = 1; |
| 1647 | break; |
| 1648 | case 'I': |
| 1649 | intsize = sizeof(int); |
| 1650 | is_signed = 0; |
| 1651 | break; |
| 1652 | case 'l': |
| 1653 | intsize = sizeof(long); |
| 1654 | is_signed = 1; |
| 1655 | break; |
| 1656 | case 'L': |
| 1657 | intsize = sizeof(long); |
| 1658 | is_signed = 0; |
| 1659 | break; |
| 1660 | default: |
| 1661 | return UNKNOWN_FORMAT; |
| 1662 | } |
| 1663 | switch (intsize) { |
| 1664 | case 2: |
| 1665 | return UNSIGNED_INT16_LE + is_big_endian + (2 * is_signed); |
| 1666 | case 4: |
| 1667 | return UNSIGNED_INT32_LE + is_big_endian + (2 * is_signed); |
| 1668 | case 8: |
| 1669 | return UNSIGNED_INT64_LE + is_big_endian + (2 * is_signed); |
| 1670 | default: |
| 1671 | return UNKNOWN_FORMAT; |
| 1672 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1673 | } |
| 1674 | |
| 1675 | /* Forward declaration. */ |
| 1676 | static PyObject *array_new(PyTypeObject *type, PyObject *args, PyObject *kwds); |
| 1677 | |
| 1678 | /* |
| 1679 | * Internal: This function wraps the array constructor--i.e., array_new()--to |
| 1680 | * allow the creation of array objects from C code without having to deal |
| 1681 | * directly the tuple argument of array_new(). The typecode argument is a |
| 1682 | * Unicode character value, like 'i' or 'f' for example, representing an array |
| 1683 | * type code. The items argument is a bytes or a list object from which |
| 1684 | * contains the initial value of the array. |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1685 | * |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1686 | * On success, this functions returns the array object created. Otherwise, |
| 1687 | * NULL is returned to indicate a failure. |
| 1688 | */ |
| 1689 | static PyObject * |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 1690 | make_array(PyTypeObject *arraytype, Py_UNICODE typecode, PyObject *items) |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1691 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1692 | PyObject *new_args; |
| 1693 | PyObject *array_obj; |
| 1694 | PyObject *typecode_obj; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1695 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1696 | assert(arraytype != NULL); |
| 1697 | assert(items != NULL); |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1698 | |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 1699 | typecode_obj = PyUnicode_FromUnicode(&typecode, 1); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1700 | if (typecode_obj == NULL) |
| 1701 | return NULL; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1702 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1703 | new_args = PyTuple_New(2); |
| 1704 | if (new_args == NULL) |
| 1705 | return NULL; |
| 1706 | Py_INCREF(items); |
| 1707 | PyTuple_SET_ITEM(new_args, 0, typecode_obj); |
| 1708 | PyTuple_SET_ITEM(new_args, 1, items); |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1709 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1710 | array_obj = array_new(arraytype, new_args, NULL); |
| 1711 | Py_DECREF(new_args); |
| 1712 | if (array_obj == NULL) |
| 1713 | return NULL; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1714 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1715 | return array_obj; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1716 | } |
| 1717 | |
| 1718 | /* |
| 1719 | * This functions is a special constructor used when unpickling an array. It |
| 1720 | * provides a portable way to rebuild an array from its memory representation. |
| 1721 | */ |
| 1722 | static PyObject * |
| 1723 | array_reconstructor(PyObject *self, PyObject *args) |
| 1724 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1725 | PyTypeObject *arraytype; |
| 1726 | PyObject *items; |
| 1727 | PyObject *converted_items; |
| 1728 | PyObject *result; |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 1729 | int typecode_int; |
| 1730 | Py_UNICODE typecode; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1731 | enum machine_format_code mformat_code; |
| 1732 | struct arraydescr *descr; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1733 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1734 | if (!PyArg_ParseTuple(args, "OCiO:array._array_reconstructor", |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 1735 | &arraytype, &typecode_int, &mformat_code, &items)) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1736 | return NULL; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1737 | |
Victor Stinner | 9f0b51e | 2010-11-09 09:38:30 +0000 | [diff] [blame] | 1738 | typecode = (Py_UNICODE)typecode_int; |
| 1739 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1740 | if (!PyType_Check(arraytype)) { |
| 1741 | PyErr_Format(PyExc_TypeError, |
| 1742 | "first argument must a type object, not %.200s", |
| 1743 | Py_TYPE(arraytype)->tp_name); |
| 1744 | return NULL; |
| 1745 | } |
| 1746 | if (!PyType_IsSubtype(arraytype, &Arraytype)) { |
| 1747 | PyErr_Format(PyExc_TypeError, |
| 1748 | "%.200s is not a subtype of %.200s", |
| 1749 | arraytype->tp_name, Arraytype.tp_name); |
| 1750 | return NULL; |
| 1751 | } |
| 1752 | for (descr = descriptors; descr->typecode != '\0'; descr++) { |
| 1753 | if (descr->typecode == typecode) |
| 1754 | break; |
| 1755 | } |
| 1756 | if (descr->typecode == '\0') { |
| 1757 | PyErr_SetString(PyExc_ValueError, |
| 1758 | "second argument must be a valid type code"); |
| 1759 | return NULL; |
| 1760 | } |
| 1761 | if (mformat_code < MACHINE_FORMAT_CODE_MIN || |
| 1762 | mformat_code > MACHINE_FORMAT_CODE_MAX) { |
| 1763 | PyErr_SetString(PyExc_ValueError, |
| 1764 | "third argument must be a valid machine format code."); |
| 1765 | return NULL; |
| 1766 | } |
| 1767 | if (!PyBytes_Check(items)) { |
| 1768 | PyErr_Format(PyExc_TypeError, |
| 1769 | "fourth argument should be bytes, not %.200s", |
| 1770 | Py_TYPE(items)->tp_name); |
| 1771 | return NULL; |
| 1772 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1773 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1774 | /* Fast path: No decoding has to be done. */ |
| 1775 | if (mformat_code == typecode_to_mformat_code(typecode) || |
| 1776 | mformat_code == UNKNOWN_FORMAT) { |
| 1777 | return make_array(arraytype, typecode, items); |
| 1778 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1779 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1780 | /* Slow path: Decode the byte string according to the given machine |
| 1781 | * format code. This occurs when the computer unpickling the array |
| 1782 | * object is architecturally different from the one that pickled the |
| 1783 | * array. |
| 1784 | */ |
| 1785 | if (Py_SIZE(items) % mformat_descriptors[mformat_code].size != 0) { |
| 1786 | PyErr_SetString(PyExc_ValueError, |
| 1787 | "string length not a multiple of item size"); |
| 1788 | return NULL; |
| 1789 | } |
| 1790 | switch (mformat_code) { |
| 1791 | case IEEE_754_FLOAT_LE: |
| 1792 | case IEEE_754_FLOAT_BE: { |
| 1793 | int i; |
| 1794 | int le = (mformat_code == IEEE_754_FLOAT_LE) ? 1 : 0; |
| 1795 | Py_ssize_t itemcount = Py_SIZE(items) / 4; |
| 1796 | const unsigned char *memstr = |
| 1797 | (unsigned char *)PyBytes_AS_STRING(items); |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1798 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1799 | converted_items = PyList_New(itemcount); |
| 1800 | if (converted_items == NULL) |
| 1801 | return NULL; |
| 1802 | for (i = 0; i < itemcount; i++) { |
| 1803 | PyObject *pyfloat = PyFloat_FromDouble( |
| 1804 | _PyFloat_Unpack4(&memstr[i * 4], le)); |
| 1805 | if (pyfloat == NULL) { |
| 1806 | Py_DECREF(converted_items); |
| 1807 | return NULL; |
| 1808 | } |
| 1809 | PyList_SET_ITEM(converted_items, i, pyfloat); |
| 1810 | } |
| 1811 | break; |
| 1812 | } |
| 1813 | case IEEE_754_DOUBLE_LE: |
| 1814 | case IEEE_754_DOUBLE_BE: { |
| 1815 | int i; |
| 1816 | int le = (mformat_code == IEEE_754_DOUBLE_LE) ? 1 : 0; |
| 1817 | Py_ssize_t itemcount = Py_SIZE(items) / 8; |
| 1818 | const unsigned char *memstr = |
| 1819 | (unsigned char *)PyBytes_AS_STRING(items); |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1820 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1821 | converted_items = PyList_New(itemcount); |
| 1822 | if (converted_items == NULL) |
| 1823 | return NULL; |
| 1824 | for (i = 0; i < itemcount; i++) { |
| 1825 | PyObject *pyfloat = PyFloat_FromDouble( |
| 1826 | _PyFloat_Unpack8(&memstr[i * 8], le)); |
| 1827 | if (pyfloat == NULL) { |
| 1828 | Py_DECREF(converted_items); |
| 1829 | return NULL; |
| 1830 | } |
| 1831 | PyList_SET_ITEM(converted_items, i, pyfloat); |
| 1832 | } |
| 1833 | break; |
| 1834 | } |
| 1835 | case UTF16_LE: |
| 1836 | case UTF16_BE: { |
| 1837 | int byteorder = (mformat_code == UTF16_LE) ? -1 : 1; |
| 1838 | converted_items = PyUnicode_DecodeUTF16( |
| 1839 | PyBytes_AS_STRING(items), Py_SIZE(items), |
| 1840 | "strict", &byteorder); |
| 1841 | if (converted_items == NULL) |
| 1842 | return NULL; |
| 1843 | break; |
| 1844 | } |
| 1845 | case UTF32_LE: |
| 1846 | case UTF32_BE: { |
| 1847 | int byteorder = (mformat_code == UTF32_LE) ? -1 : 1; |
| 1848 | converted_items = PyUnicode_DecodeUTF32( |
| 1849 | PyBytes_AS_STRING(items), Py_SIZE(items), |
| 1850 | "strict", &byteorder); |
| 1851 | if (converted_items == NULL) |
| 1852 | return NULL; |
| 1853 | break; |
| 1854 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1855 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1856 | case UNSIGNED_INT8: |
| 1857 | case SIGNED_INT8: |
| 1858 | case UNSIGNED_INT16_LE: |
| 1859 | case UNSIGNED_INT16_BE: |
| 1860 | case SIGNED_INT16_LE: |
| 1861 | case SIGNED_INT16_BE: |
| 1862 | case UNSIGNED_INT32_LE: |
| 1863 | case UNSIGNED_INT32_BE: |
| 1864 | case SIGNED_INT32_LE: |
| 1865 | case SIGNED_INT32_BE: |
| 1866 | case UNSIGNED_INT64_LE: |
| 1867 | case UNSIGNED_INT64_BE: |
| 1868 | case SIGNED_INT64_LE: |
| 1869 | case SIGNED_INT64_BE: { |
| 1870 | int i; |
| 1871 | const struct mformatdescr mf_descr = |
| 1872 | mformat_descriptors[mformat_code]; |
| 1873 | Py_ssize_t itemcount = Py_SIZE(items) / mf_descr.size; |
| 1874 | const unsigned char *memstr = |
| 1875 | (unsigned char *)PyBytes_AS_STRING(items); |
| 1876 | struct arraydescr *descr; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1877 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1878 | /* If possible, try to pack array's items using a data type |
| 1879 | * that fits better. This may result in an array with narrower |
| 1880 | * or wider elements. |
| 1881 | * |
| 1882 | * For example, if a 32-bit machine pickles a L-code array of |
| 1883 | * unsigned longs, then the array will be unpickled by 64-bit |
| 1884 | * machine as an I-code array of unsigned ints. |
| 1885 | * |
| 1886 | * XXX: Is it possible to write a unit test for this? |
| 1887 | */ |
| 1888 | for (descr = descriptors; descr->typecode != '\0'; descr++) { |
| 1889 | if (descr->is_integer_type && |
| 1890 | descr->itemsize == mf_descr.size && |
| 1891 | descr->is_signed == mf_descr.is_signed) |
| 1892 | typecode = descr->typecode; |
| 1893 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1894 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1895 | converted_items = PyList_New(itemcount); |
| 1896 | if (converted_items == NULL) |
| 1897 | return NULL; |
| 1898 | for (i = 0; i < itemcount; i++) { |
| 1899 | PyObject *pylong; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1900 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1901 | pylong = _PyLong_FromByteArray( |
| 1902 | &memstr[i * mf_descr.size], |
| 1903 | mf_descr.size, |
| 1904 | !mf_descr.is_big_endian, |
| 1905 | mf_descr.is_signed); |
| 1906 | if (pylong == NULL) { |
| 1907 | Py_DECREF(converted_items); |
| 1908 | return NULL; |
| 1909 | } |
| 1910 | PyList_SET_ITEM(converted_items, i, pylong); |
| 1911 | } |
| 1912 | break; |
| 1913 | } |
| 1914 | case UNKNOWN_FORMAT: |
| 1915 | /* Impossible, but needed to shut up GCC about the unhandled |
| 1916 | * enumeration value. |
| 1917 | */ |
| 1918 | default: |
| 1919 | PyErr_BadArgument(); |
| 1920 | return NULL; |
| 1921 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1922 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1923 | result = make_array(arraytype, typecode, converted_items); |
| 1924 | Py_DECREF(converted_items); |
| 1925 | return result; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1926 | } |
| 1927 | |
| 1928 | static PyObject * |
| 1929 | array_reduce_ex(arrayobject *array, PyObject *value) |
| 1930 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1931 | PyObject *dict; |
| 1932 | PyObject *result; |
| 1933 | PyObject *array_str; |
| 1934 | int typecode = array->ob_descr->typecode; |
| 1935 | int mformat_code; |
| 1936 | static PyObject *array_reconstructor = NULL; |
| 1937 | long protocol; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1938 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1939 | if (array_reconstructor == NULL) { |
| 1940 | PyObject *array_module = PyImport_ImportModule("array"); |
| 1941 | if (array_module == NULL) |
| 1942 | return NULL; |
| 1943 | array_reconstructor = PyObject_GetAttrString( |
| 1944 | array_module, |
| 1945 | "_array_reconstructor"); |
| 1946 | Py_DECREF(array_module); |
| 1947 | if (array_reconstructor == NULL) |
| 1948 | return NULL; |
| 1949 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1950 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1951 | if (!PyLong_Check(value)) { |
| 1952 | PyErr_SetString(PyExc_TypeError, |
| 1953 | "__reduce_ex__ argument should an integer"); |
| 1954 | return NULL; |
| 1955 | } |
| 1956 | protocol = PyLong_AsLong(value); |
| 1957 | if (protocol == -1 && PyErr_Occurred()) |
| 1958 | return NULL; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1959 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1960 | dict = PyObject_GetAttrString((PyObject *)array, "__dict__"); |
| 1961 | if (dict == NULL) { |
| 1962 | if (!PyErr_ExceptionMatches(PyExc_AttributeError)) |
| 1963 | return NULL; |
| 1964 | PyErr_Clear(); |
| 1965 | dict = Py_None; |
| 1966 | Py_INCREF(dict); |
| 1967 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1968 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1969 | mformat_code = typecode_to_mformat_code(typecode); |
| 1970 | if (mformat_code == UNKNOWN_FORMAT || protocol < 3) { |
| 1971 | /* Convert the array to a list if we got something weird |
| 1972 | * (e.g., non-IEEE floats), or we are pickling the array using |
| 1973 | * a Python 2.x compatible protocol. |
| 1974 | * |
| 1975 | * It is necessary to use a list representation for Python 2.x |
| 1976 | * compatible pickle protocol, since Python 2's str objects |
| 1977 | * are unpickled as unicode by Python 3. Thus it is impossible |
| 1978 | * to make arrays unpicklable by Python 3 by using their memory |
| 1979 | * representation, unless we resort to ugly hacks such as |
| 1980 | * coercing unicode objects to bytes in array_reconstructor. |
| 1981 | */ |
| 1982 | PyObject *list; |
| 1983 | list = array_tolist(array, NULL); |
| 1984 | if (list == NULL) { |
| 1985 | Py_DECREF(dict); |
| 1986 | return NULL; |
| 1987 | } |
| 1988 | result = Py_BuildValue( |
| 1989 | "O(CO)O", Py_TYPE(array), typecode, list, dict); |
| 1990 | Py_DECREF(list); |
| 1991 | Py_DECREF(dict); |
| 1992 | return result; |
| 1993 | } |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 1994 | |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 1995 | array_str = array_tobytes(array, NULL); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1996 | if (array_str == NULL) { |
| 1997 | Py_DECREF(dict); |
| 1998 | return NULL; |
| 1999 | } |
| 2000 | result = Py_BuildValue( |
| 2001 | "O(OCiN)O", array_reconstructor, Py_TYPE(array), typecode, |
| 2002 | mformat_code, array_str, dict); |
| 2003 | Py_DECREF(dict); |
| 2004 | return result; |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 2005 | } |
| 2006 | |
| 2007 | PyDoc_STRVAR(reduce_doc, "Return state information for pickling."); |
| 2008 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2009 | static PyObject * |
| 2010 | array_get_typecode(arrayobject *a, void *closure) |
| 2011 | { |
Amaury Forgeot d'Arc | 24aa26b | 2010-11-25 08:13:35 +0000 | [diff] [blame] | 2012 | Py_UNICODE tc = a->ob_descr->typecode; |
| 2013 | return PyUnicode_FromUnicode(&tc, 1); |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2014 | } |
| 2015 | |
| 2016 | static PyObject * |
| 2017 | array_get_itemsize(arrayobject *a, void *closure) |
| 2018 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2019 | return PyLong_FromLong((long)a->ob_descr->itemsize); |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2020 | } |
| 2021 | |
| 2022 | static PyGetSetDef array_getsets [] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2023 | {"typecode", (getter) array_get_typecode, NULL, |
| 2024 | "the typecode character used to create the array"}, |
| 2025 | {"itemsize", (getter) array_get_itemsize, NULL, |
| 2026 | "the size, in bytes, of one array item"}, |
| 2027 | {NULL} |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2028 | }; |
| 2029 | |
Martin v. Löwis | 59683e8 | 2008-06-13 07:50:45 +0000 | [diff] [blame] | 2030 | static PyMethodDef array_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2031 | {"append", (PyCFunction)array_append, METH_O, |
| 2032 | append_doc}, |
| 2033 | {"buffer_info", (PyCFunction)array_buffer_info, METH_NOARGS, |
| 2034 | buffer_info_doc}, |
| 2035 | {"byteswap", (PyCFunction)array_byteswap, METH_NOARGS, |
| 2036 | byteswap_doc}, |
| 2037 | {"__copy__", (PyCFunction)array_copy, METH_NOARGS, |
| 2038 | copy_doc}, |
| 2039 | {"count", (PyCFunction)array_count, METH_O, |
| 2040 | count_doc}, |
| 2041 | {"__deepcopy__",(PyCFunction)array_copy, METH_O, |
| 2042 | copy_doc}, |
| 2043 | {"extend", (PyCFunction)array_extend, METH_O, |
| 2044 | extend_doc}, |
| 2045 | {"fromfile", (PyCFunction)array_fromfile, METH_VARARGS, |
| 2046 | fromfile_doc}, |
| 2047 | {"fromlist", (PyCFunction)array_fromlist, METH_O, |
| 2048 | fromlist_doc}, |
| 2049 | {"fromstring", (PyCFunction)array_fromstring, METH_VARARGS, |
| 2050 | fromstring_doc}, |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 2051 | {"frombytes", (PyCFunction)array_frombytes, METH_VARARGS, |
| 2052 | frombytes_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2053 | {"fromunicode", (PyCFunction)array_fromunicode, METH_VARARGS, |
| 2054 | fromunicode_doc}, |
| 2055 | {"index", (PyCFunction)array_index, METH_O, |
| 2056 | index_doc}, |
| 2057 | {"insert", (PyCFunction)array_insert, METH_VARARGS, |
| 2058 | insert_doc}, |
| 2059 | {"pop", (PyCFunction)array_pop, METH_VARARGS, |
| 2060 | pop_doc}, |
| 2061 | {"__reduce_ex__", (PyCFunction)array_reduce_ex, METH_O, |
| 2062 | reduce_doc}, |
| 2063 | {"remove", (PyCFunction)array_remove, METH_O, |
| 2064 | remove_doc}, |
| 2065 | {"reverse", (PyCFunction)array_reverse, METH_NOARGS, |
| 2066 | reverse_doc}, |
| 2067 | /* {"sort", (PyCFunction)array_sort, METH_VARARGS, |
| 2068 | sort_doc},*/ |
| 2069 | {"tofile", (PyCFunction)array_tofile, METH_O, |
| 2070 | tofile_doc}, |
| 2071 | {"tolist", (PyCFunction)array_tolist, METH_NOARGS, |
| 2072 | tolist_doc}, |
| 2073 | {"tostring", (PyCFunction)array_tostring, METH_NOARGS, |
| 2074 | tostring_doc}, |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 2075 | {"tobytes", (PyCFunction)array_tobytes, METH_NOARGS, |
| 2076 | tobytes_doc}, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2077 | {"tounicode", (PyCFunction)array_tounicode, METH_NOARGS, |
| 2078 | tounicode_doc}, |
| 2079 | {NULL, NULL} /* sentinel */ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2080 | }; |
| 2081 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 2082 | static PyObject * |
Peter Schneider-Kamp | 9656abd | 2000-07-13 21:10:57 +0000 | [diff] [blame] | 2083 | array_repr(arrayobject *a) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2084 | { |
Amaury Forgeot d'Arc | 24aa26b | 2010-11-25 08:13:35 +0000 | [diff] [blame] | 2085 | Py_UNICODE typecode; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2086 | PyObject *s, *v = NULL; |
| 2087 | Py_ssize_t len; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2088 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2089 | len = Py_SIZE(a); |
| 2090 | typecode = a->ob_descr->typecode; |
| 2091 | if (len == 0) { |
Amaury Forgeot d'Arc | 24aa26b | 2010-11-25 08:13:35 +0000 | [diff] [blame] | 2092 | return PyUnicode_FromFormat("array('%c')", (int)typecode); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2093 | } |
Brett Cannon | 4a5e5de | 2011-06-07 20:09:32 -0700 | [diff] [blame] | 2094 | if (typecode == 'u') |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2095 | v = array_tounicode(a, NULL); |
| 2096 | else |
| 2097 | v = array_tolist(a, NULL); |
Raymond Hettinger | 88ba1e3 | 2003-04-23 17:27:00 +0000 | [diff] [blame] | 2098 | |
Amaury Forgeot d'Arc | 24aa26b | 2010-11-25 08:13:35 +0000 | [diff] [blame] | 2099 | s = PyUnicode_FromFormat("array('%c', %R)", (int)typecode, v); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2100 | Py_DECREF(v); |
| 2101 | return s; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2102 | } |
| 2103 | |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2104 | static PyObject* |
| 2105 | array_subscr(arrayobject* self, PyObject* item) |
| 2106 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2107 | if (PyIndex_Check(item)) { |
| 2108 | Py_ssize_t i = PyNumber_AsSsize_t(item, PyExc_IndexError); |
| 2109 | if (i==-1 && PyErr_Occurred()) { |
| 2110 | return NULL; |
| 2111 | } |
| 2112 | if (i < 0) |
| 2113 | i += Py_SIZE(self); |
| 2114 | return array_item(self, i); |
| 2115 | } |
| 2116 | else if (PySlice_Check(item)) { |
| 2117 | Py_ssize_t start, stop, step, slicelength, cur, i; |
| 2118 | PyObject* result; |
| 2119 | arrayobject* ar; |
| 2120 | int itemsize = self->ob_descr->itemsize; |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2121 | |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 2122 | if (PySlice_GetIndicesEx(item, Py_SIZE(self), |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2123 | &start, &stop, &step, &slicelength) < 0) { |
| 2124 | return NULL; |
| 2125 | } |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2126 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2127 | if (slicelength <= 0) { |
| 2128 | return newarrayobject(&Arraytype, 0, self->ob_descr); |
| 2129 | } |
| 2130 | else if (step == 1) { |
| 2131 | PyObject *result = newarrayobject(&Arraytype, |
| 2132 | slicelength, self->ob_descr); |
| 2133 | if (result == NULL) |
| 2134 | return NULL; |
| 2135 | memcpy(((arrayobject *)result)->ob_item, |
| 2136 | self->ob_item + start * itemsize, |
| 2137 | slicelength * itemsize); |
| 2138 | return result; |
| 2139 | } |
| 2140 | else { |
| 2141 | result = newarrayobject(&Arraytype, slicelength, self->ob_descr); |
| 2142 | if (!result) return NULL; |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2143 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2144 | ar = (arrayobject*)result; |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2145 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2146 | for (cur = start, i = 0; i < slicelength; |
| 2147 | cur += step, i++) { |
| 2148 | memcpy(ar->ob_item + i*itemsize, |
| 2149 | self->ob_item + cur*itemsize, |
| 2150 | itemsize); |
| 2151 | } |
| 2152 | |
| 2153 | return result; |
| 2154 | } |
| 2155 | } |
| 2156 | else { |
| 2157 | PyErr_SetString(PyExc_TypeError, |
| 2158 | "array indices must be integers"); |
| 2159 | return NULL; |
| 2160 | } |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2161 | } |
| 2162 | |
| 2163 | static int |
| 2164 | array_ass_subscr(arrayobject* self, PyObject* item, PyObject* value) |
| 2165 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2166 | Py_ssize_t start, stop, step, slicelength, needed; |
| 2167 | arrayobject* other; |
| 2168 | int itemsize; |
Thomas Wouters | ed03b41 | 2007-08-28 21:37:11 +0000 | [diff] [blame] | 2169 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2170 | if (PyIndex_Check(item)) { |
| 2171 | Py_ssize_t i = PyNumber_AsSsize_t(item, PyExc_IndexError); |
Alexandre Vassalotti | 4713725 | 2009-07-05 19:57:00 +0000 | [diff] [blame] | 2172 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2173 | if (i == -1 && PyErr_Occurred()) |
| 2174 | return -1; |
| 2175 | if (i < 0) |
| 2176 | i += Py_SIZE(self); |
| 2177 | if (i < 0 || i >= Py_SIZE(self)) { |
| 2178 | PyErr_SetString(PyExc_IndexError, |
| 2179 | "array assignment index out of range"); |
| 2180 | return -1; |
| 2181 | } |
| 2182 | if (value == NULL) { |
| 2183 | /* Fall through to slice assignment */ |
| 2184 | start = i; |
| 2185 | stop = i + 1; |
| 2186 | step = 1; |
| 2187 | slicelength = 1; |
| 2188 | } |
| 2189 | else |
| 2190 | return (*self->ob_descr->setitem)(self, i, value); |
| 2191 | } |
| 2192 | else if (PySlice_Check(item)) { |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 2193 | if (PySlice_GetIndicesEx(item, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2194 | Py_SIZE(self), &start, &stop, |
| 2195 | &step, &slicelength) < 0) { |
| 2196 | return -1; |
| 2197 | } |
| 2198 | } |
| 2199 | else { |
| 2200 | PyErr_SetString(PyExc_TypeError, |
| 2201 | "array indices must be integer"); |
| 2202 | return -1; |
| 2203 | } |
| 2204 | if (value == NULL) { |
| 2205 | other = NULL; |
| 2206 | needed = 0; |
| 2207 | } |
| 2208 | else if (array_Check(value)) { |
| 2209 | other = (arrayobject *)value; |
| 2210 | needed = Py_SIZE(other); |
| 2211 | if (self == other) { |
| 2212 | /* Special case "self[i:j] = self" -- copy self first */ |
| 2213 | int ret; |
| 2214 | value = array_slice(other, 0, needed); |
| 2215 | if (value == NULL) |
| 2216 | return -1; |
| 2217 | ret = array_ass_subscr(self, item, value); |
| 2218 | Py_DECREF(value); |
| 2219 | return ret; |
| 2220 | } |
| 2221 | if (other->ob_descr != self->ob_descr) { |
| 2222 | PyErr_BadArgument(); |
| 2223 | return -1; |
| 2224 | } |
| 2225 | } |
| 2226 | else { |
| 2227 | PyErr_Format(PyExc_TypeError, |
| 2228 | "can only assign array (not \"%.200s\") to array slice", |
| 2229 | Py_TYPE(value)->tp_name); |
| 2230 | return -1; |
| 2231 | } |
| 2232 | itemsize = self->ob_descr->itemsize; |
| 2233 | /* for 'a[2:1] = ...', the insertion point is 'start', not 'stop' */ |
| 2234 | if ((step > 0 && stop < start) || |
| 2235 | (step < 0 && stop > start)) |
| 2236 | stop = start; |
Alexandre Vassalotti | 4713725 | 2009-07-05 19:57:00 +0000 | [diff] [blame] | 2237 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2238 | /* Issue #4509: If the array has exported buffers and the slice |
| 2239 | assignment would change the size of the array, fail early to make |
| 2240 | sure we don't modify it. */ |
| 2241 | if ((needed == 0 || slicelength != needed) && self->ob_exports > 0) { |
| 2242 | PyErr_SetString(PyExc_BufferError, |
| 2243 | "cannot resize an array that is exporting buffers"); |
| 2244 | return -1; |
| 2245 | } |
Mark Dickinson | bc09964 | 2010-01-29 17:27:24 +0000 | [diff] [blame] | 2246 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2247 | if (step == 1) { |
| 2248 | if (slicelength > needed) { |
| 2249 | memmove(self->ob_item + (start + needed) * itemsize, |
| 2250 | self->ob_item + stop * itemsize, |
| 2251 | (Py_SIZE(self) - stop) * itemsize); |
| 2252 | if (array_resize(self, Py_SIZE(self) + |
| 2253 | needed - slicelength) < 0) |
| 2254 | return -1; |
| 2255 | } |
| 2256 | else if (slicelength < needed) { |
| 2257 | if (array_resize(self, Py_SIZE(self) + |
| 2258 | needed - slicelength) < 0) |
| 2259 | return -1; |
| 2260 | memmove(self->ob_item + (start + needed) * itemsize, |
| 2261 | self->ob_item + stop * itemsize, |
| 2262 | (Py_SIZE(self) - start - needed) * itemsize); |
| 2263 | } |
| 2264 | if (needed > 0) |
| 2265 | memcpy(self->ob_item + start * itemsize, |
| 2266 | other->ob_item, needed * itemsize); |
| 2267 | return 0; |
| 2268 | } |
| 2269 | else if (needed == 0) { |
| 2270 | /* Delete slice */ |
| 2271 | size_t cur; |
| 2272 | Py_ssize_t i; |
Thomas Wouters | ed03b41 | 2007-08-28 21:37:11 +0000 | [diff] [blame] | 2273 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2274 | if (step < 0) { |
| 2275 | stop = start + 1; |
| 2276 | start = stop + step * (slicelength - 1) - 1; |
| 2277 | step = -step; |
| 2278 | } |
| 2279 | for (cur = start, i = 0; i < slicelength; |
| 2280 | cur += step, i++) { |
| 2281 | Py_ssize_t lim = step - 1; |
Thomas Wouters | ed03b41 | 2007-08-28 21:37:11 +0000 | [diff] [blame] | 2282 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2283 | if (cur + step >= (size_t)Py_SIZE(self)) |
| 2284 | lim = Py_SIZE(self) - cur - 1; |
| 2285 | memmove(self->ob_item + (cur - i) * itemsize, |
| 2286 | self->ob_item + (cur + 1) * itemsize, |
| 2287 | lim * itemsize); |
| 2288 | } |
| 2289 | cur = start + slicelength * step; |
| 2290 | if (cur < (size_t)Py_SIZE(self)) { |
| 2291 | memmove(self->ob_item + (cur-slicelength) * itemsize, |
| 2292 | self->ob_item + cur * itemsize, |
| 2293 | (Py_SIZE(self) - cur) * itemsize); |
| 2294 | } |
| 2295 | if (array_resize(self, Py_SIZE(self) - slicelength) < 0) |
| 2296 | return -1; |
| 2297 | return 0; |
| 2298 | } |
| 2299 | else { |
| 2300 | Py_ssize_t cur, i; |
| 2301 | |
| 2302 | if (needed != slicelength) { |
| 2303 | PyErr_Format(PyExc_ValueError, |
| 2304 | "attempt to assign array of size %zd " |
| 2305 | "to extended slice of size %zd", |
| 2306 | needed, slicelength); |
| 2307 | return -1; |
| 2308 | } |
| 2309 | for (cur = start, i = 0; i < slicelength; |
| 2310 | cur += step, i++) { |
| 2311 | memcpy(self->ob_item + cur * itemsize, |
| 2312 | other->ob_item + i * itemsize, |
| 2313 | itemsize); |
| 2314 | } |
| 2315 | return 0; |
| 2316 | } |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2317 | } |
| 2318 | |
| 2319 | static PyMappingMethods array_as_mapping = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2320 | (lenfunc)array_length, |
| 2321 | (binaryfunc)array_subscr, |
| 2322 | (objobjargproc)array_ass_subscr |
Michael W. Hudson | 9c14bad | 2002-06-19 15:44:15 +0000 | [diff] [blame] | 2323 | }; |
| 2324 | |
Guido van Rossum | d8faa36 | 2007-04-27 19:54:29 +0000 | [diff] [blame] | 2325 | static const void *emptybuf = ""; |
| 2326 | |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 2327 | |
| 2328 | static int |
Travis E. Oliphant | 8ae62b6 | 2007-09-23 02:00:13 +0000 | [diff] [blame] | 2329 | array_buffer_getbuf(arrayobject *self, Py_buffer *view, int flags) |
Guido van Rossum | fdf95dd | 1997-05-05 22:15:02 +0000 | [diff] [blame] | 2330 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2331 | if (view==NULL) goto finish; |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 2332 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2333 | view->buf = (void *)self->ob_item; |
| 2334 | view->obj = (PyObject*)self; |
| 2335 | Py_INCREF(self); |
| 2336 | if (view->buf == NULL) |
| 2337 | view->buf = (void *)emptybuf; |
| 2338 | view->len = (Py_SIZE(self)) * self->ob_descr->itemsize; |
| 2339 | view->readonly = 0; |
| 2340 | view->ndim = 1; |
| 2341 | view->itemsize = self->ob_descr->itemsize; |
| 2342 | view->suboffsets = NULL; |
| 2343 | view->shape = NULL; |
| 2344 | if ((flags & PyBUF_ND)==PyBUF_ND) { |
| 2345 | view->shape = &((Py_SIZE(self))); |
| 2346 | } |
| 2347 | view->strides = NULL; |
| 2348 | if ((flags & PyBUF_STRIDES)==PyBUF_STRIDES) |
| 2349 | view->strides = &(view->itemsize); |
| 2350 | view->format = NULL; |
| 2351 | view->internal = NULL; |
| 2352 | if ((flags & PyBUF_FORMAT) == PyBUF_FORMAT) { |
| 2353 | view->format = self->ob_descr->formats; |
Travis E. Oliphant | ddacf96 | 2007-10-13 21:03:27 +0000 | [diff] [blame] | 2354 | #ifdef Py_UNICODE_WIDE |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2355 | if (self->ob_descr->typecode == 'u') { |
| 2356 | view->format = "w"; |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 2357 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2358 | #endif |
| 2359 | } |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 2360 | |
| 2361 | finish: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2362 | self->ob_exports++; |
| 2363 | return 0; |
Guido van Rossum | fdf95dd | 1997-05-05 22:15:02 +0000 | [diff] [blame] | 2364 | } |
| 2365 | |
Travis E. Oliphant | b99f762 | 2007-08-18 11:21:56 +0000 | [diff] [blame] | 2366 | static void |
Travis E. Oliphant | 8ae62b6 | 2007-09-23 02:00:13 +0000 | [diff] [blame] | 2367 | array_buffer_relbuf(arrayobject *self, Py_buffer *view) |
Guido van Rossum | fdf95dd | 1997-05-05 22:15:02 +0000 | [diff] [blame] | 2368 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2369 | self->ob_exports--; |
Guido van Rossum | fdf95dd | 1997-05-05 22:15:02 +0000 | [diff] [blame] | 2370 | } |
| 2371 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 2372 | static PySequenceMethods array_as_sequence = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2373 | (lenfunc)array_length, /*sq_length*/ |
| 2374 | (binaryfunc)array_concat, /*sq_concat*/ |
| 2375 | (ssizeargfunc)array_repeat, /*sq_repeat*/ |
| 2376 | (ssizeargfunc)array_item, /*sq_item*/ |
| 2377 | 0, /*sq_slice*/ |
| 2378 | (ssizeobjargproc)array_ass_item, /*sq_ass_item*/ |
| 2379 | 0, /*sq_ass_slice*/ |
| 2380 | (objobjproc)array_contains, /*sq_contains*/ |
| 2381 | (binaryfunc)array_inplace_concat, /*sq_inplace_concat*/ |
| 2382 | (ssizeargfunc)array_inplace_repeat /*sq_inplace_repeat*/ |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2383 | }; |
| 2384 | |
Guido van Rossum | fdf95dd | 1997-05-05 22:15:02 +0000 | [diff] [blame] | 2385 | static PyBufferProcs array_as_buffer = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2386 | (getbufferproc)array_buffer_getbuf, |
| 2387 | (releasebufferproc)array_buffer_relbuf |
Guido van Rossum | fdf95dd | 1997-05-05 22:15:02 +0000 | [diff] [blame] | 2388 | }; |
| 2389 | |
Roger E. Masse | 2919eaa | 1996-12-09 20:10:36 +0000 | [diff] [blame] | 2390 | static PyObject * |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2391 | array_new(PyTypeObject *type, PyObject *args, PyObject *kwds) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2392 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2393 | int c; |
| 2394 | PyObject *initial = NULL, *it = NULL; |
| 2395 | struct arraydescr *descr; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2396 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2397 | if (type == &Arraytype && !_PyArg_NoKeywords("array.array()", kwds)) |
| 2398 | return NULL; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2399 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2400 | if (!PyArg_ParseTuple(args, "C|O:array", &c, &initial)) |
| 2401 | return NULL; |
Raymond Hettinger | 84fc9aa | 2003-04-24 10:41:55 +0000 | [diff] [blame] | 2402 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2403 | if (!(initial == NULL || PyList_Check(initial) |
| 2404 | || PyByteArray_Check(initial) |
| 2405 | || PyBytes_Check(initial) |
| 2406 | || PyTuple_Check(initial) |
Alexander Belopolsky | ef4a03f | 2011-01-11 21:44:00 +0000 | [diff] [blame] | 2407 | || ((c=='u') && PyUnicode_Check(initial)) |
| 2408 | || (array_Check(initial) |
| 2409 | && c == ((arrayobject*)initial)->ob_descr->typecode))) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2410 | it = PyObject_GetIter(initial); |
| 2411 | if (it == NULL) |
| 2412 | return NULL; |
| 2413 | /* We set initial to NULL so that the subsequent code |
| 2414 | will create an empty array of the appropriate type |
| 2415 | and afterwards we can use array_iter_extend to populate |
| 2416 | the array. |
| 2417 | */ |
| 2418 | initial = NULL; |
| 2419 | } |
| 2420 | for (descr = descriptors; descr->typecode != '\0'; descr++) { |
| 2421 | if (descr->typecode == c) { |
| 2422 | PyObject *a; |
| 2423 | Py_ssize_t len; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2424 | |
Alexander Belopolsky | ef4a03f | 2011-01-11 21:44:00 +0000 | [diff] [blame] | 2425 | if (initial == NULL) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2426 | len = 0; |
Alexander Belopolsky | ef4a03f | 2011-01-11 21:44:00 +0000 | [diff] [blame] | 2427 | else if (PyList_Check(initial)) |
| 2428 | len = PyList_GET_SIZE(initial); |
| 2429 | else if (PyTuple_Check(initial) || array_Check(initial)) |
| 2430 | len = Py_SIZE(initial); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2431 | else |
Alexander Belopolsky | ef4a03f | 2011-01-11 21:44:00 +0000 | [diff] [blame] | 2432 | len = 0; |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2433 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2434 | a = newarrayobject(type, len, descr); |
| 2435 | if (a == NULL) |
| 2436 | return NULL; |
| 2437 | |
Alexander Belopolsky | ef4a03f | 2011-01-11 21:44:00 +0000 | [diff] [blame] | 2438 | if (len > 0 && !array_Check(initial)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2439 | Py_ssize_t i; |
| 2440 | for (i = 0; i < len; i++) { |
| 2441 | PyObject *v = |
| 2442 | PySequence_GetItem(initial, i); |
| 2443 | if (v == NULL) { |
| 2444 | Py_DECREF(a); |
| 2445 | return NULL; |
| 2446 | } |
| 2447 | if (setarrayitem(a, i, v) != 0) { |
| 2448 | Py_DECREF(v); |
| 2449 | Py_DECREF(a); |
| 2450 | return NULL; |
| 2451 | } |
| 2452 | Py_DECREF(v); |
| 2453 | } |
| 2454 | } |
| 2455 | else if (initial != NULL && (PyByteArray_Check(initial) || |
| 2456 | PyBytes_Check(initial))) { |
| 2457 | PyObject *t_initial, *v; |
| 2458 | t_initial = PyTuple_Pack(1, initial); |
| 2459 | if (t_initial == NULL) { |
| 2460 | Py_DECREF(a); |
| 2461 | return NULL; |
| 2462 | } |
Antoine Pitrou | 1ce3eb5 | 2010-09-01 20:29:34 +0000 | [diff] [blame] | 2463 | v = array_frombytes((arrayobject *)a, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2464 | t_initial); |
| 2465 | Py_DECREF(t_initial); |
| 2466 | if (v == NULL) { |
| 2467 | Py_DECREF(a); |
| 2468 | return NULL; |
| 2469 | } |
| 2470 | Py_DECREF(v); |
| 2471 | } |
| 2472 | else if (initial != NULL && PyUnicode_Check(initial)) { |
| 2473 | Py_ssize_t n = PyUnicode_GET_DATA_SIZE(initial); |
| 2474 | if (n > 0) { |
| 2475 | arrayobject *self = (arrayobject *)a; |
| 2476 | char *item = self->ob_item; |
| 2477 | item = (char *)PyMem_Realloc(item, n); |
| 2478 | if (item == NULL) { |
| 2479 | PyErr_NoMemory(); |
| 2480 | Py_DECREF(a); |
| 2481 | return NULL; |
| 2482 | } |
| 2483 | self->ob_item = item; |
| 2484 | Py_SIZE(self) = n / sizeof(Py_UNICODE); |
| 2485 | memcpy(item, PyUnicode_AS_DATA(initial), n); |
| 2486 | self->allocated = Py_SIZE(self); |
| 2487 | } |
| 2488 | } |
Alexander Belopolsky | ef4a03f | 2011-01-11 21:44:00 +0000 | [diff] [blame] | 2489 | else if (initial != NULL && array_Check(initial)) { |
| 2490 | arrayobject *self = (arrayobject *)a; |
| 2491 | arrayobject *other = (arrayobject *)initial; |
| 2492 | memcpy(self->ob_item, other->ob_item, len * other->ob_descr->itemsize); |
| 2493 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2494 | if (it != NULL) { |
| 2495 | if (array_iter_extend((arrayobject *)a, it) == -1) { |
| 2496 | Py_DECREF(it); |
| 2497 | Py_DECREF(a); |
| 2498 | return NULL; |
| 2499 | } |
| 2500 | Py_DECREF(it); |
| 2501 | } |
| 2502 | return a; |
| 2503 | } |
| 2504 | } |
| 2505 | PyErr_SetString(PyExc_ValueError, |
| 2506 | "bad typecode (must be b, B, u, h, H, i, I, l, L, f or d)"); |
| 2507 | return NULL; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2508 | } |
| 2509 | |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2510 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 2511 | PyDoc_STRVAR(module_doc, |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2512 | "This module defines an object type which can efficiently represent\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2513 | an array of basic values: characters, integers, floating point\n\ |
| 2514 | numbers. Arrays are sequence types and behave very much like lists,\n\ |
| 2515 | except that the type of objects stored in them is constrained. The\n\ |
| 2516 | type is specified at object creation time by using a type code, which\n\ |
| 2517 | is a single character. The following type codes are defined:\n\ |
| 2518 | \n\ |
| 2519 | Type code C Type Minimum size in bytes \n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2520 | 'b' signed integer 1 \n\ |
| 2521 | 'B' unsigned integer 1 \n\ |
Travis E. Oliphant | d5c0add | 2007-10-12 22:05:15 +0000 | [diff] [blame] | 2522 | 'u' Unicode character 2 (see note) \n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2523 | 'h' signed integer 2 \n\ |
| 2524 | 'H' unsigned integer 2 \n\ |
| 2525 | 'i' signed integer 2 \n\ |
| 2526 | 'I' unsigned integer 2 \n\ |
| 2527 | 'l' signed integer 4 \n\ |
| 2528 | 'L' unsigned integer 4 \n\ |
| 2529 | 'f' floating point 4 \n\ |
| 2530 | 'd' floating point 8 \n\ |
| 2531 | \n\ |
Travis E. Oliphant | d5c0add | 2007-10-12 22:05:15 +0000 | [diff] [blame] | 2532 | NOTE: The 'u' typecode corresponds to Python's unicode character. On \n\ |
| 2533 | narrow builds this is 2-bytes on wide builds this is 4-bytes.\n\ |
| 2534 | \n\ |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2535 | The constructor is:\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2536 | \n\ |
| 2537 | array(typecode [, initializer]) -- create a new array\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 2538 | "); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2539 | |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 2540 | PyDoc_STRVAR(arraytype_doc, |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2541 | "array(typecode [, initializer]) -> array\n\ |
| 2542 | \n\ |
| 2543 | Return a new array whose items are restricted by typecode, and\n\ |
Raymond Hettinger | 6ab78cd | 2004-08-29 07:50:43 +0000 | [diff] [blame] | 2544 | initialized from the optional initializer value, which must be a list,\n\ |
| 2545 | string. or iterable over elements of the appropriate type.\n\ |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2546 | \n\ |
| 2547 | Arrays represent basic values and behave very much like lists, except\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2548 | the type of objects stored in them is constrained.\n\ |
| 2549 | \n\ |
| 2550 | Methods:\n\ |
| 2551 | \n\ |
| 2552 | append() -- append a new item to the end of the array\n\ |
| 2553 | buffer_info() -- return information giving the current memory info\n\ |
| 2554 | byteswap() -- byteswap all the items of the array\n\ |
Mark Dickinson | 934896d | 2009-02-21 20:59:32 +0000 | [diff] [blame] | 2555 | count() -- return number of occurrences of an object\n\ |
Raymond Hettinger | 49f9bd1 | 2004-03-14 05:43:59 +0000 | [diff] [blame] | 2556 | extend() -- extend array by appending multiple elements from an iterable\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2557 | fromfile() -- read items from a file object\n\ |
| 2558 | fromlist() -- append items from the list\n\ |
| 2559 | fromstring() -- append items from the string\n\ |
Mark Dickinson | 934896d | 2009-02-21 20:59:32 +0000 | [diff] [blame] | 2560 | index() -- return index of first occurrence of an object\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2561 | insert() -- insert a new item into the array at a provided position\n\ |
Peter Schneider-Kamp | 5a65c2d | 2000-07-31 20:52:21 +0000 | [diff] [blame] | 2562 | pop() -- remove and return item (default last)\n\ |
Mark Dickinson | 934896d | 2009-02-21 20:59:32 +0000 | [diff] [blame] | 2563 | remove() -- remove first occurrence of an object\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2564 | reverse() -- reverse the order of the items in the array\n\ |
| 2565 | tofile() -- write all items to a file object\n\ |
| 2566 | tolist() -- return the array converted to an ordinary list\n\ |
| 2567 | tostring() -- return the array converted to a string\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2568 | \n\ |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2569 | Attributes:\n\ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2570 | \n\ |
| 2571 | typecode -- the typecode character used to create the array\n\ |
| 2572 | itemsize -- the length in bytes of one array item\n\ |
Martin v. Löwis | 14f8b4c | 2002-06-13 20:33:02 +0000 | [diff] [blame] | 2573 | "); |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2574 | |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2575 | static PyObject *array_iter(arrayobject *ao); |
| 2576 | |
Tim Peters | 0c32279 | 2002-07-17 16:49:03 +0000 | [diff] [blame] | 2577 | static PyTypeObject Arraytype = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2578 | PyVarObject_HEAD_INIT(NULL, 0) |
| 2579 | "array.array", |
| 2580 | sizeof(arrayobject), |
| 2581 | 0, |
| 2582 | (destructor)array_dealloc, /* tp_dealloc */ |
| 2583 | 0, /* tp_print */ |
| 2584 | 0, /* tp_getattr */ |
| 2585 | 0, /* tp_setattr */ |
| 2586 | 0, /* tp_reserved */ |
| 2587 | (reprfunc)array_repr, /* tp_repr */ |
| 2588 | 0, /* tp_as_number*/ |
| 2589 | &array_as_sequence, /* tp_as_sequence*/ |
| 2590 | &array_as_mapping, /* tp_as_mapping*/ |
| 2591 | 0, /* tp_hash */ |
| 2592 | 0, /* tp_call */ |
| 2593 | 0, /* tp_str */ |
| 2594 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 2595 | 0, /* tp_setattro */ |
| 2596 | &array_as_buffer, /* tp_as_buffer*/ |
| 2597 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ |
| 2598 | arraytype_doc, /* tp_doc */ |
| 2599 | 0, /* tp_traverse */ |
| 2600 | 0, /* tp_clear */ |
| 2601 | array_richcompare, /* tp_richcompare */ |
| 2602 | offsetof(arrayobject, weakreflist), /* tp_weaklistoffset */ |
| 2603 | (getiterfunc)array_iter, /* tp_iter */ |
| 2604 | 0, /* tp_iternext */ |
| 2605 | array_methods, /* tp_methods */ |
| 2606 | 0, /* tp_members */ |
| 2607 | array_getsets, /* tp_getset */ |
| 2608 | 0, /* tp_base */ |
| 2609 | 0, /* tp_dict */ |
| 2610 | 0, /* tp_descr_get */ |
| 2611 | 0, /* tp_descr_set */ |
| 2612 | 0, /* tp_dictoffset */ |
| 2613 | 0, /* tp_init */ |
| 2614 | PyType_GenericAlloc, /* tp_alloc */ |
| 2615 | array_new, /* tp_new */ |
| 2616 | PyObject_Del, /* tp_free */ |
Guido van Rossum | b39b90d | 1998-10-13 14:27:22 +0000 | [diff] [blame] | 2617 | }; |
| 2618 | |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2619 | |
| 2620 | /*********************** Array Iterator **************************/ |
| 2621 | |
| 2622 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2623 | PyObject_HEAD |
| 2624 | Py_ssize_t index; |
| 2625 | arrayobject *ao; |
| 2626 | PyObject * (*getitem)(struct arrayobject *, Py_ssize_t); |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2627 | } arrayiterobject; |
| 2628 | |
| 2629 | static PyTypeObject PyArrayIter_Type; |
| 2630 | |
| 2631 | #define PyArrayIter_Check(op) PyObject_TypeCheck(op, &PyArrayIter_Type) |
| 2632 | |
| 2633 | static PyObject * |
| 2634 | array_iter(arrayobject *ao) |
| 2635 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2636 | arrayiterobject *it; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2637 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2638 | if (!array_Check(ao)) { |
| 2639 | PyErr_BadInternalCall(); |
| 2640 | return NULL; |
| 2641 | } |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2642 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2643 | it = PyObject_GC_New(arrayiterobject, &PyArrayIter_Type); |
| 2644 | if (it == NULL) |
| 2645 | return NULL; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2646 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2647 | Py_INCREF(ao); |
| 2648 | it->ao = ao; |
| 2649 | it->index = 0; |
| 2650 | it->getitem = ao->ob_descr->getitem; |
| 2651 | PyObject_GC_Track(it); |
| 2652 | return (PyObject *)it; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2653 | } |
| 2654 | |
| 2655 | static PyObject * |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2656 | arrayiter_next(arrayiterobject *it) |
| 2657 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2658 | assert(PyArrayIter_Check(it)); |
| 2659 | if (it->index < Py_SIZE(it->ao)) |
| 2660 | return (*it->getitem)(it->ao, it->index++); |
| 2661 | return NULL; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2662 | } |
| 2663 | |
| 2664 | static void |
| 2665 | arrayiter_dealloc(arrayiterobject *it) |
| 2666 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2667 | PyObject_GC_UnTrack(it); |
| 2668 | Py_XDECREF(it->ao); |
| 2669 | PyObject_GC_Del(it); |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2670 | } |
| 2671 | |
| 2672 | static int |
| 2673 | arrayiter_traverse(arrayiterobject *it, visitproc visit, void *arg) |
| 2674 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2675 | Py_VISIT(it->ao); |
| 2676 | return 0; |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2677 | } |
| 2678 | |
| 2679 | static PyTypeObject PyArrayIter_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2680 | PyVarObject_HEAD_INIT(NULL, 0) |
| 2681 | "arrayiterator", /* tp_name */ |
| 2682 | sizeof(arrayiterobject), /* tp_basicsize */ |
| 2683 | 0, /* tp_itemsize */ |
| 2684 | /* methods */ |
| 2685 | (destructor)arrayiter_dealloc, /* tp_dealloc */ |
| 2686 | 0, /* tp_print */ |
| 2687 | 0, /* tp_getattr */ |
| 2688 | 0, /* tp_setattr */ |
| 2689 | 0, /* tp_reserved */ |
| 2690 | 0, /* tp_repr */ |
| 2691 | 0, /* tp_as_number */ |
| 2692 | 0, /* tp_as_sequence */ |
| 2693 | 0, /* tp_as_mapping */ |
| 2694 | 0, /* tp_hash */ |
| 2695 | 0, /* tp_call */ |
| 2696 | 0, /* tp_str */ |
| 2697 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 2698 | 0, /* tp_setattro */ |
| 2699 | 0, /* tp_as_buffer */ |
| 2700 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_HAVE_GC,/* tp_flags */ |
| 2701 | 0, /* tp_doc */ |
| 2702 | (traverseproc)arrayiter_traverse, /* tp_traverse */ |
| 2703 | 0, /* tp_clear */ |
| 2704 | 0, /* tp_richcompare */ |
| 2705 | 0, /* tp_weaklistoffset */ |
| 2706 | PyObject_SelfIter, /* tp_iter */ |
| 2707 | (iternextfunc)arrayiter_next, /* tp_iternext */ |
| 2708 | 0, /* tp_methods */ |
Raymond Hettinger | 625812f | 2003-01-07 01:58:52 +0000 | [diff] [blame] | 2709 | }; |
| 2710 | |
| 2711 | |
| 2712 | /*********************** Install Module **************************/ |
| 2713 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2714 | /* No functions in array module. */ |
| 2715 | static PyMethodDef a_methods[] = { |
Alexandre Vassalotti | ad07715 | 2009-07-15 17:49:23 +0000 | [diff] [blame] | 2716 | {"_array_reconstructor", array_reconstructor, METH_VARARGS, |
| 2717 | PyDoc_STR("Internal. Used for pickling support.")}, |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2718 | {NULL, NULL, 0, NULL} /* Sentinel */ |
| 2719 | }; |
| 2720 | |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 2721 | static struct PyModuleDef arraymodule = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2722 | PyModuleDef_HEAD_INIT, |
| 2723 | "array", |
| 2724 | module_doc, |
| 2725 | -1, |
| 2726 | a_methods, |
| 2727 | NULL, |
| 2728 | NULL, |
| 2729 | NULL, |
| 2730 | NULL |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 2731 | }; |
| 2732 | |
Martin v. Löwis | 9986633 | 2002-03-01 10:27:01 +0000 | [diff] [blame] | 2733 | |
Mark Hammond | fe51c6d | 2002-08-02 02:27:13 +0000 | [diff] [blame] | 2734 | PyMODINIT_FUNC |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 2735 | PyInit_array(void) |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2736 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2737 | PyObject *m; |
| 2738 | PyObject *typecodes; |
| 2739 | Py_ssize_t size = 0; |
| 2740 | register Py_UNICODE *p; |
| 2741 | struct arraydescr *descr; |
Fred Drake | 0d40ba4 | 2000-02-04 20:33:49 +0000 | [diff] [blame] | 2742 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2743 | if (PyType_Ready(&Arraytype) < 0) |
| 2744 | return NULL; |
| 2745 | Py_TYPE(&PyArrayIter_Type) = &PyType_Type; |
| 2746 | m = PyModule_Create(&arraymodule); |
| 2747 | if (m == NULL) |
| 2748 | return NULL; |
Fred Drake | f4e3484 | 2002-04-01 03:45:06 +0000 | [diff] [blame] | 2749 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2750 | Py_INCREF((PyObject *)&Arraytype); |
| 2751 | PyModule_AddObject(m, "ArrayType", (PyObject *)&Arraytype); |
| 2752 | Py_INCREF((PyObject *)&Arraytype); |
| 2753 | PyModule_AddObject(m, "array", (PyObject *)&Arraytype); |
Travis E. Oliphant | d5c0add | 2007-10-12 22:05:15 +0000 | [diff] [blame] | 2754 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2755 | for (descr=descriptors; descr->typecode != '\0'; descr++) { |
| 2756 | size++; |
| 2757 | } |
Travis E. Oliphant | d5c0add | 2007-10-12 22:05:15 +0000 | [diff] [blame] | 2758 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 2759 | typecodes = PyUnicode_FromStringAndSize(NULL, size); |
| 2760 | p = PyUnicode_AS_UNICODE(typecodes); |
| 2761 | for (descr = descriptors; descr->typecode != '\0'; descr++) { |
| 2762 | *p++ = (char)descr->typecode; |
| 2763 | } |
| 2764 | |
| 2765 | PyModule_AddObject(m, "typecodes", (PyObject *)typecodes); |
| 2766 | |
| 2767 | if (PyErr_Occurred()) { |
| 2768 | Py_DECREF(m); |
| 2769 | m = NULL; |
| 2770 | } |
| 2771 | return m; |
Guido van Rossum | 778983b | 1993-02-19 15:55:02 +0000 | [diff] [blame] | 2772 | } |