home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 4 / AACD04.ISO / AACD / Programming / Python / Source / Modules / arraymodule.c < prev    next >
Encoding:
C/C++ Source or Header  |  1999-04-25  |  31.6 KB  |  1,478 lines
  1. /***********************************************************
  2. Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
  3. The Netherlands.
  4.  
  5.                         All Rights Reserved
  6.  
  7. Permission to use, copy, modify, and distribute this software and its
  8. documentation for any purpose and without fee is hereby granted,
  9. provided that the above copyright notice appear in all copies and that
  10. both that copyright notice and this permission notice appear in
  11. supporting documentation, and that the names of Stichting Mathematisch
  12. Centrum or CWI or Corporation for National Research Initiatives or
  13. CNRI not be used in advertising or publicity pertaining to
  14. distribution of the software without specific, written prior
  15. permission.
  16.  
  17. While CWI is the initial source for this software, a modified version
  18. is made available by the Corporation for National Research Initiatives
  19. (CNRI) at the Internet address ftp://ftp.python.org.
  20.  
  21. STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
  22. REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
  23. MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
  24. CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
  25. DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  26. PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
  27. TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
  28. PERFORMANCE OF THIS SOFTWARE.
  29.  
  30. ******************************************************************/
  31.  
  32. /* Array object implementation */
  33.  
  34. /* An array is a uniform list -- all items have the same type.
  35.    The item type is restricted to simple C types like int or float */
  36.  
  37. #include "Python.h"
  38.  
  39. #ifdef STDC_HEADERS
  40. #include <stddef.h>
  41. #else
  42. #include <sys/types.h>        /* For size_t */
  43. #endif
  44.  
  45. struct arrayobject; /* Forward */
  46.  
  47. struct arraydescr {
  48.     int typecode;
  49.     int itemsize;
  50.     PyObject * (*getitem) Py_FPROTO((struct arrayobject *, int));
  51.     int (*setitem) Py_FPROTO((struct arrayobject *, int, PyObject *));
  52. };
  53.  
  54. typedef struct arrayobject {
  55.     PyObject_VAR_HEAD
  56.     char *ob_item;
  57.     struct arraydescr *ob_descr;
  58. } arrayobject;
  59.  
  60. staticforward PyTypeObject Arraytype;
  61.  
  62. #define is_arrayobject(op) ((op)->ob_type == &Arraytype)
  63.  
  64. /* Forward */
  65. #include "protos/arraymodule.h"
  66. static PyObject *newarrayobject Py_PROTO((int, struct arraydescr *));
  67. #if 0
  68. static int getarraysize Py_PROTO((PyObject *));
  69. #endif
  70. static PyObject *getarrayitem Py_PROTO((PyObject *, int));
  71. static int setarrayitem Py_PROTO((PyObject *, int, PyObject *));
  72. #if 0
  73. static int insarrayitem Py_PROTO((PyObject *, int, PyObject *));
  74. static int addarrayitem Py_PROTO((PyObject *, PyObject *));
  75. #endif
  76.  
  77. static PyObject *
  78. c_getitem(ap, i)
  79.     arrayobject *ap;
  80.     int i;
  81. {
  82.     return PyString_FromStringAndSize(&((char *)ap->ob_item)[i], 1);
  83. }
  84.  
  85. static int
  86. c_setitem(ap, i, v)
  87.     arrayobject *ap;
  88.     int i;
  89.     PyObject *v;
  90. {
  91.     char x;
  92.     if (!PyArg_Parse(v, "c;array item must be char", &x))
  93.         return -1;
  94.     if (i >= 0)
  95.              ((char *)ap->ob_item)[i] = x;
  96.     return 0;
  97. }
  98.  
  99. static PyObject *
  100. b_getitem(ap, i)
  101.     arrayobject *ap;
  102.     int i;
  103. {
  104.     long x = ((char *)ap->ob_item)[i];
  105.     if (x >= 128)
  106.         x -= 256;
  107.     return PyInt_FromLong(x);
  108. }
  109.  
  110. static int
  111. b_setitem(ap, i, v)
  112.     arrayobject *ap;
  113.     int i;
  114.     PyObject *v;
  115. {
  116.     char x;
  117.     if (!PyArg_Parse(v, "b;array item must be integer", &x))
  118.         return -1;
  119.     if (i >= 0)
  120.              ((char *)ap->ob_item)[i] = x;
  121.     return 0;
  122. }
  123.  
  124. static PyObject *
  125. BB_getitem(ap, i)
  126.     arrayobject *ap;
  127.     int i;
  128. {
  129.     long x = ((unsigned char *)ap->ob_item)[i];
  130.     return PyInt_FromLong(x);
  131. }
  132.  
  133. #define BB_setitem b_setitem
  134.  
  135. static PyObject *
  136. h_getitem(ap, i)
  137.     arrayobject *ap;
  138.     int i;
  139. {
  140.     return PyInt_FromLong((long) ((short *)ap->ob_item)[i]);
  141. }
  142.  
  143. static int
  144. h_setitem(ap, i, v)
  145.     arrayobject *ap;
  146.     int i;
  147.     PyObject *v;
  148. {
  149.     short x;
  150.     if (!PyArg_Parse(v, "h;array item must be integer", &x))
  151.         return -1;
  152.     if (i >= 0)
  153.              ((short *)ap->ob_item)[i] = x;
  154.     return 0;
  155. }
  156.  
  157. static PyObject *
  158. HH_getitem(ap, i)
  159.     arrayobject *ap;
  160.     int i;
  161. {
  162.     return PyInt_FromLong((long) ((unsigned short *)ap->ob_item)[i]);
  163. }
  164.  
  165. #define HH_setitem h_setitem
  166.  
  167. static PyObject *
  168. i_getitem(ap, i)
  169.     arrayobject *ap;
  170.     int i;
  171. {
  172.     return PyInt_FromLong((long) ((int *)ap->ob_item)[i]);
  173. }
  174.  
  175. static int
  176. i_setitem(ap, i, v)
  177.     arrayobject *ap;
  178.     int i;
  179.     PyObject *v;
  180. {
  181.     int x;
  182.     if (!PyArg_Parse(v, "i;array item must be integer", &x))
  183.         return -1;
  184.     if (i >= 0)
  185.              ((int *)ap->ob_item)[i] = x;
  186.     return 0;
  187. }
  188.  
  189. static PyObject *
  190. II_getitem(ap, i)
  191.     arrayobject *ap;
  192.     int i;
  193. {
  194.     return PyLong_FromUnsignedLong(
  195.         (unsigned long) ((unsigned int *)ap->ob_item)[i]);
  196. }
  197.  
  198. static int
  199. II_setitem(ap, i, v)
  200.     arrayobject *ap;
  201.     int i;
  202.     PyObject *v;
  203. {
  204.     unsigned long x;
  205.     if (PyLong_Check(v)) {
  206.         x = PyLong_AsUnsignedLong(v);
  207.         if (x == (unsigned long) -1 && PyErr_Occurred())
  208.             return -1;
  209.     }
  210.     else {
  211.         if (!PyArg_Parse(v, "l;array item must be integer", &x))
  212.             return -1;
  213.     }
  214.     if (i >= 0)
  215.         ((unsigned int *)ap->ob_item)[i] = x;
  216.     return 0;
  217. }
  218.  
  219. static PyObject *
  220. l_getitem(ap, i)
  221.     arrayobject *ap;
  222.     int i;
  223. {
  224.     return PyInt_FromLong(((long *)ap->ob_item)[i]);
  225. }
  226.  
  227. static int
  228. l_setitem(ap, i, v)
  229.     arrayobject *ap;
  230.     int i;
  231.     PyObject *v;
  232. {
  233.     long x;
  234.     if (!PyArg_Parse(v, "l;array item must be integer", &x))
  235.         return -1;
  236.     if (i >= 0)
  237.              ((long *)ap->ob_item)[i] = x;
  238.     return 0;
  239. }
  240.  
  241. static PyObject *
  242. LL_getitem(ap, i)
  243.     arrayobject *ap;
  244.     int i;
  245. {
  246.     return PyLong_FromUnsignedLong(((unsigned long *)ap->ob_item)[i]);
  247. }
  248.  
  249. static int
  250. LL_setitem(ap, i, v)
  251.     arrayobject *ap;
  252.     int i;
  253.     PyObject *v;
  254. {
  255.     unsigned long x;
  256.     if (PyLong_Check(v)) {
  257.         x = PyLong_AsUnsignedLong(v);
  258.         if (x == (unsigned long) -1 && PyErr_Occurred())
  259.             return -1;
  260.     }
  261.     else {
  262.         if (!PyArg_Parse(v, "l;array item must be integer", &x))
  263.             return -1;
  264.     }
  265.     if (i >= 0)
  266.         ((unsigned long *)ap->ob_item)[i] = x;
  267.     return 0;
  268. }
  269.  
  270. static PyObject *
  271. f_getitem(ap, i)
  272.     arrayobject *ap;
  273.     int i;
  274. {
  275.     return PyFloat_FromDouble((double) ((float *)ap->ob_item)[i]);
  276. }
  277.  
  278. static int
  279. f_setitem(ap, i, v)
  280.     arrayobject *ap;
  281.     int i;
  282.     PyObject *v;
  283. {
  284.     float x;
  285.     if (!PyArg_Parse(v, "f;array item must be float", &x))
  286.         return -1;
  287.     if (i >= 0)
  288.              ((float *)ap->ob_item)[i] = x;
  289.     return 0;
  290. }
  291.  
  292. static PyObject *
  293. d_getitem(ap, i)
  294.     arrayobject *ap;
  295.     int i;
  296. {
  297.     return PyFloat_FromDouble(((double *)ap->ob_item)[i]);
  298. }
  299.  
  300. static int
  301. d_setitem(ap, i, v)
  302.     arrayobject *ap;
  303.     int i;
  304.     PyObject *v;
  305. {
  306.     double x;
  307.     if (!PyArg_Parse(v, "d;array item must be float", &x))
  308.         return -1;
  309.     if (i >= 0)
  310.              ((double *)ap->ob_item)[i] = x;
  311.     return 0;
  312. }
  313.  
  314. /* Description of types */
  315. static struct arraydescr descriptors[] = {
  316.     {'c', sizeof(char), c_getitem, c_setitem},
  317.     {'b', sizeof(char), b_getitem, b_setitem},
  318.     {'B', sizeof(char), BB_getitem, BB_setitem},
  319.     {'h', sizeof(short), h_getitem, h_setitem},
  320.     {'H', sizeof(short), HH_getitem, HH_setitem},
  321.     {'i', sizeof(int), i_getitem, i_setitem},
  322.     {'I', sizeof(int), II_getitem, II_setitem},
  323.     {'l', sizeof(long), l_getitem, l_setitem},
  324.     {'L', sizeof(long), LL_getitem, LL_setitem},
  325.     {'f', sizeof(float), f_getitem, f_setitem},
  326.     {'d', sizeof(double), d_getitem, d_setitem},
  327.     {'\0', 0, 0, 0} /* Sentinel */
  328. };
  329. /* If we ever allow items larger than double, we must change reverse()! */
  330.     
  331.  
  332. static PyObject *
  333. newarrayobject(size, descr)
  334.     int size;
  335.     struct arraydescr *descr;
  336. {
  337.     arrayobject *op;
  338.     size_t nbytes;
  339.     if (size < 0) {
  340.         PyErr_BadInternalCall();
  341.         return NULL;
  342.     }
  343.     nbytes = size * descr->itemsize;
  344.     /* Check for overflow */
  345.     if (nbytes / descr->itemsize != (size_t)size) {
  346.         return PyErr_NoMemory();
  347.     }
  348.     op = PyMem_NEW(arrayobject, 1);
  349.     if (op == NULL) {
  350.         return PyErr_NoMemory();
  351.     }
  352.     if (size <= 0) {
  353.         op->ob_item = NULL;
  354.     }
  355.     else {
  356.         op->ob_item = PyMem_NEW(char, nbytes);
  357.         if (op->ob_item == NULL) {
  358.             PyMem_DEL(op);
  359.             return PyErr_NoMemory();
  360.         }
  361.     }
  362.     op->ob_type = &Arraytype;
  363.     op->ob_size = size;
  364.     op->ob_descr = descr;
  365.     _Py_NewReference(op);
  366.     return (PyObject *) op;
  367. }
  368.  
  369. #if 0
  370. static int
  371. getarraysize(op)
  372.     PyObject *op;
  373. {
  374.     if (!is_arrayobject(op)) {
  375.         PyErr_BadInternalCall();
  376.         return -1;
  377.     }
  378.     return ((arrayobject *)op) -> ob_size;
  379. }
  380. #endif
  381.  
  382. static PyObject *
  383. getarrayitem(op, i)
  384.     PyObject *op;
  385.     int i;
  386. {
  387.     register arrayobject *ap;
  388.     if (!is_arrayobject(op)) {
  389.         PyErr_BadInternalCall();
  390.         return NULL;
  391.     }
  392.     ap = (arrayobject *)op;
  393.     if (i < 0 || i >= ap->ob_size) {
  394.         PyErr_SetString(PyExc_IndexError, "array index out of range");
  395.         return NULL;
  396.     }
  397.     return (*ap->ob_descr->getitem)(ap, i);
  398. }
  399.  
  400. static int
  401. ins1(self, where, v)
  402.     arrayobject *self;
  403.     int where;
  404.     PyObject *v;
  405. {
  406.     char *items;
  407.     if (v == NULL) {
  408.         PyErr_BadInternalCall();
  409.         return -1;
  410.     }
  411.     if ((*self->ob_descr->setitem)(self, -1, v) < 0)
  412.         return -1;
  413.     items = self->ob_item;
  414.     PyMem_RESIZE(items, char,
  415.              (self->ob_size+1) * self->ob_descr->itemsize);
  416.     if (items == NULL) {
  417.         PyErr_NoMemory();
  418.         return -1;
  419.     }
  420.     if (where < 0)
  421.         where = 0;
  422.     if (where > self->ob_size)
  423.         where = self->ob_size;
  424.     memmove(items + (where+1)*self->ob_descr->itemsize,
  425.         items + where*self->ob_descr->itemsize,
  426.         (self->ob_size-where)*self->ob_descr->itemsize);
  427.     self->ob_item = items;
  428.     self->ob_size++;
  429.     return (*self->ob_descr->setitem)(self, where, v);
  430. }
  431.  
  432. #if 0
  433. static int
  434. insarrayitem(op, where, newitem)
  435.     PyObject *op;
  436.     int where;
  437.     PyObject *newitem;
  438. {
  439.     if (!is_arrayobject(op)) {
  440.         PyErr_BadInternalCall();
  441.         return -1;
  442.     }
  443.     return ins1((arrayobject *)op, where, newitem);
  444. }
  445.  
  446. static int
  447. addarrayitem(op, newitem)
  448.     PyObject *op;
  449.     PyObject *newitem;
  450. {
  451.     if (!is_arrayobject(op)) {
  452.         PyErr_BadInternalCall();
  453.         return -1;
  454.     }
  455.     return ins1((arrayobject *)op,
  456.         (int) ((arrayobject *)op)->ob_size, newitem);
  457. }
  458. #endif
  459.  
  460. /* Methods */
  461.  
  462. static void
  463. array_dealloc(op)
  464.     arrayobject *op;
  465. {
  466.     if (op->ob_item != NULL)
  467.         PyMem_DEL(op->ob_item);
  468.     PyMem_DEL(op);
  469. }
  470.  
  471. static int
  472. array_compare(v, w)
  473.     arrayobject *v, *w;
  474. {
  475.     int len = (v->ob_size < w->ob_size) ? v->ob_size : w->ob_size;
  476.     int i;
  477.     for (i = 0; i < len; i++) {
  478.         PyObject *ai, *bi;
  479.         int cmp;
  480.         ai = getarrayitem((PyObject *)v, i);
  481.         bi = getarrayitem((PyObject *)w, i);
  482.         if (ai && bi)
  483.             cmp = PyObject_Compare(ai, bi);
  484.         else
  485.             cmp = -1;
  486.         Py_XDECREF(ai);
  487.         Py_XDECREF(bi);
  488.         if (cmp != 0)
  489.             return cmp;
  490.     }
  491.     return v->ob_size - w->ob_size;
  492. }
  493.  
  494. static int
  495. array_length(a)
  496.     arrayobject *a;
  497. {
  498.     return a->ob_size;
  499. }
  500.  
  501. static PyObject *
  502. array_item(a, i)
  503.     arrayobject *a;
  504.     int i;
  505. {
  506.     if (i < 0 || i >= a->ob_size) {
  507.         PyErr_SetString(PyExc_IndexError, "array index out of range");
  508.         return NULL;
  509.     }
  510.     return getarrayitem((PyObject *)a, i);
  511. }
  512.  
  513. static PyObject *
  514. array_slice(a, ilow, ihigh)
  515.     arrayobject *a;
  516.     int ilow, ihigh;
  517. {
  518.     arrayobject *np;
  519.     if (ilow < 0)
  520.         ilow = 0;
  521.     else if (ilow > a->ob_size)
  522.         ilow = a->ob_size;
  523.     if (ihigh < 0)
  524.         ihigh = 0;
  525.     if (ihigh < ilow)
  526.         ihigh = ilow;
  527.     else if (ihigh > a->ob_size)
  528.         ihigh = a->ob_size;
  529.     np = (arrayobject *) newarrayobject(ihigh - ilow, a->ob_descr);
  530.     if (np == NULL)
  531.         return NULL;
  532.     memcpy(np->ob_item, a->ob_item + ilow * a->ob_descr->itemsize,
  533.            (ihigh-ilow) * a->ob_descr->itemsize);
  534.     return (PyObject *)np;
  535. }
  536.  
  537. static PyObject *
  538. array_concat(a, bb)
  539.     arrayobject *a;
  540.     PyObject *bb;
  541. {
  542.     int size;
  543.     arrayobject *np;
  544.     if (!is_arrayobject(bb)) {
  545.         PyErr_BadArgument();
  546.         return NULL;
  547.     }
  548. #define b ((arrayobject *)bb)
  549.     if (a->ob_descr != b->ob_descr) {
  550.         PyErr_BadArgument();
  551.         return NULL;
  552.     }
  553.     size = a->ob_size + b->ob_size;
  554.     np = (arrayobject *) newarrayobject(size, a->ob_descr);
  555.     if (np == NULL) {
  556.         return NULL;
  557.     }
  558.     memcpy(np->ob_item, a->ob_item, a->ob_size*a->ob_descr->itemsize);
  559.     memcpy(np->ob_item + a->ob_size*a->ob_descr->itemsize,
  560.            b->ob_item, b->ob_size*b->ob_descr->itemsize);
  561.     return (PyObject *)np;
  562. #undef b
  563. }
  564.  
  565. static PyObject *
  566. array_repeat(a, n)
  567.     arrayobject *a;
  568.     int n;
  569. {
  570.     int i;
  571.     int size;
  572.     arrayobject *np;
  573.     char *p;
  574.     int nbytes;
  575.     if (n < 0)
  576.         n = 0;
  577.     size = a->ob_size * n;
  578.     np = (arrayobject *) newarrayobject(size, a->ob_descr);
  579.     if (np == NULL)
  580.         return NULL;
  581.     p = np->ob_item;
  582.     nbytes = a->ob_size * a->ob_descr->itemsize;
  583.     for (i = 0; i < n; i++) {
  584.         memcpy(p, a->ob_item, nbytes);
  585.         p += nbytes;
  586.     }
  587.     return (PyObject *) np;
  588. }
  589.  
  590. static int
  591. array_ass_slice(a, ilow, ihigh, v)
  592.     arrayobject *a;
  593.     int ilow, ihigh;
  594.     PyObject *v;
  595. {
  596.     char *item;
  597.     int n; /* Size of replacement array */
  598.     int d; /* Change in size */
  599. #define b ((arrayobject *)v)
  600.     if (v == NULL)
  601.         n = 0;
  602.     else if (is_arrayobject(v)) {
  603.         n = b->ob_size;
  604.         if (a == b) {
  605.             /* Special case "a[i:j] = a" -- copy b first */
  606.             int ret;
  607.             v = array_slice(b, 0, n);
  608.             ret = array_ass_slice(a, ilow, ihigh, v);
  609.             Py_DECREF(v);
  610.             return ret;
  611.         }
  612.         if (b->ob_descr != a->ob_descr) {
  613.             PyErr_BadArgument();
  614.             return -1;
  615.         }
  616.     }
  617.     else {
  618.         PyErr_BadArgument();
  619.         return -1;
  620.     }
  621.     if (ilow < 0)
  622.         ilow = 0;
  623.     else if (ilow > a->ob_size)
  624.         ilow = a->ob_size;
  625.     if (ihigh < 0)
  626.         ihigh = 0;
  627.     if (ihigh < ilow)
  628.         ihigh = ilow;
  629.     else if (ihigh > a->ob_size)
  630.         ihigh = a->ob_size;
  631.     item = a->ob_item;
  632.     d = n - (ihigh-ilow);
  633.     if (d < 0) { /* Delete -d items */
  634.         memmove(item + (ihigh+d)*a->ob_descr->itemsize,
  635.             item + ihigh*a->ob_descr->itemsize,
  636.             (a->ob_size-ihigh)*a->ob_descr->itemsize);
  637.         a->ob_size += d;
  638.         PyMem_RESIZE(item, char, a->ob_size*a->ob_descr->itemsize);
  639.                         /* Can't fail */
  640.         a->ob_item = item;
  641.     }
  642.     else if (d > 0) { /* Insert d items */
  643.         PyMem_RESIZE(item, char,
  644.                  (a->ob_size + d)*a->ob_descr->itemsize);
  645.         if (item == NULL) {
  646.             PyErr_NoMemory();
  647.             return -1;
  648.         }
  649.         memmove(item + (ihigh+d)*a->ob_descr->itemsize,
  650.             item + ihigh*a->ob_descr->itemsize,
  651.             (a->ob_size-ihigh)*a->ob_descr->itemsize);
  652.         a->ob_item = item;
  653.         a->ob_size += d;
  654.     }
  655.     if (n > 0)
  656.         memcpy(item + ilow*a->ob_descr->itemsize, b->ob_item,
  657.                n*b->ob_descr->itemsize);
  658.     return 0;
  659. #undef b
  660. }
  661.  
  662. static int
  663. array_ass_item(a, i, v)
  664.     arrayobject *a;
  665.     int i;
  666.     PyObject *v;
  667. {
  668.     if (i < 0 || i >= a->ob_size) {
  669.         PyErr_SetString(PyExc_IndexError,
  670.                      "array assignment index out of range");
  671.         return -1;
  672.     }
  673.     if (v == NULL)
  674.         return array_ass_slice(a, i, i+1, v);
  675.     return (*a->ob_descr->setitem)(a, i, v);
  676. }
  677.  
  678. static int
  679. setarrayitem(a, i, v)
  680.     PyObject *a;
  681.     int i;
  682.     PyObject *v;
  683. {
  684.     if (!is_arrayobject(a)) {
  685.         PyErr_BadInternalCall();
  686.         return -1;
  687.     }
  688.     return array_ass_item((arrayobject *)a, i, v);
  689. }
  690.  
  691. static PyObject *
  692. ins(self, where, v)
  693.     arrayobject *self;
  694.     int where;
  695.     PyObject *v;
  696. {
  697.     if (ins1(self, where, v) != 0)
  698.         return NULL;
  699.     Py_INCREF(Py_None);
  700.     return Py_None;
  701. }
  702.  
  703. static PyObject *
  704. array_insert(self, args)
  705.     arrayobject *self;
  706.     PyObject *args;
  707. {
  708.     int i;
  709.     PyObject *v;
  710.     if (!PyArg_Parse(args, "(iO)", &i, &v))
  711.         return NULL;
  712.     return ins(self, i, v);
  713. }
  714.  
  715. static char insert_doc [] =
  716. "insert (i,x)\n\
  717. \n\
  718. Insert a new item x into the array before position i.";
  719.  
  720.  
  721. static PyObject *
  722. array_buffer_info(self, args)
  723.     arrayobject *self;
  724.     PyObject *args;
  725. {
  726.     return Py_BuildValue("ll",
  727.                  (long)(self->ob_item), (long)(self->ob_size));
  728. }
  729.  
  730. static char buffer_info_doc [] =
  731. "buffer_info -> (address, length)\n\
  732. \n\
  733. Return a tuple (address, length) giving the current memory address and\n\
  734. the length in bytes of the buffer used to hold array's contents.";
  735.  
  736.  
  737. static PyObject *
  738. array_append(self, args)
  739.     arrayobject *self;
  740.     PyObject *args;
  741. {
  742.     PyObject *v;
  743.     if (!PyArg_Parse(args, "O", &v))
  744.         return NULL;
  745.     return ins(self, (int) self->ob_size, v);
  746. }
  747.  
  748. static char append_doc [] =
  749. "append(x)\n\
  750. \n\
  751. Append new value x to the end of the array.";
  752.  
  753.  
  754. static PyObject *
  755. array_byteswap(self, args)
  756.     arrayobject *self;
  757.     PyObject *args;
  758. {
  759.     char *p;
  760.     int i;
  761.     switch (self->ob_descr->itemsize) {
  762.     case 1:
  763.         break;
  764.     case 2:
  765.         for (p = self->ob_item, i = self->ob_size; --i >= 0; p += 2) {
  766.             char p0 = p[0];
  767.             p[0] = p[1];
  768.             p[1] = p0;
  769.         }
  770.         break;
  771.     case 4:
  772.         for (p = self->ob_item, i = self->ob_size; --i >= 0; p += 4) {
  773.             char p0 = p[0];
  774.             char p1 = p[1];
  775.             p[0] = p[3];
  776.             p[1] = p[2];
  777.             p[2] = p1;
  778.             p[3] = p0;
  779.         }
  780.         break;
  781.     case 8:
  782.         for (p = self->ob_item, i = self->ob_size; --i >= 0; p += 8) {
  783.             char p0 = p[0];
  784.             char p1 = p[1];
  785.             char p2 = p[2];
  786.             char p3 = p[3];
  787.             p[0] = p[7];
  788.             p[1] = p[6];
  789.             p[2] = p[5];
  790.             p[3] = p[4];
  791.             p[4] = p3;
  792.             p[5] = p2;
  793.             p[6] = p1;
  794.             p[7] = p0;
  795.         }
  796.         break;
  797.     default:
  798.         PyErr_SetString(PyExc_RuntimeError,
  799.                "don't know how to byteswap this array type");
  800.         return NULL;
  801.     }
  802.     Py_INCREF(Py_None);
  803.     return Py_None;
  804. }
  805.  
  806. static char byteswap_doc [] =
  807. "byteswap(x)\n\
  808. \n\
  809. Byteswap all items of the array.  This is only supported for integer\n\
  810. values of x, which determines the size of the blocks swapped.";
  811.  
  812. static PyObject *
  813. array_reverse(self, args)
  814.     arrayobject *self;
  815.     PyObject *args;
  816. {
  817.     register int itemsize = self->ob_descr->itemsize;
  818.     register char *p, *q;
  819.     char tmp[sizeof(double)]; /* Assume that's the max item size */
  820.  
  821.     if (args != NULL) {
  822.         PyErr_BadArgument();
  823.         return NULL;
  824.     }
  825.  
  826.     if (self->ob_size > 1) {
  827.         for (p = self->ob_item,
  828.              q = self->ob_item + (self->ob_size - 1)*itemsize;
  829.              p < q;
  830.              p += itemsize, q -= itemsize) {
  831.             memmove(tmp, p, itemsize);
  832.             memmove(p, q, itemsize);
  833.             memmove(q, tmp, itemsize);
  834.         }
  835.     }
  836.     
  837.     Py_INCREF(Py_None);
  838.     return Py_None;
  839. }
  840.  
  841. static char reverse_doc [] =
  842. "reverse()\n\
  843. \n\
  844. Reverse the order of the items in the array.";
  845.  
  846. /* The following routines were adapted from listobject.c but not converted.
  847.    To make them work you will have to work! */
  848.  
  849. #if 0
  850. static PyObject *
  851. array_index(self, args)
  852.     arrayobject *self;
  853.     PyObject *args;
  854. {
  855.     int i;
  856.     
  857.     if (args == NULL) {
  858.         PyErr_BadArgument();
  859.         return NULL;
  860.     }
  861.     for (i = 0; i < self->ob_size; i++) {
  862.         if (PyObject_Compare(self->ob_item[i], args) == 0)
  863.             return PyInt_FromLong((long)i);
  864.         /* XXX PyErr_Occurred */
  865.     }
  866.     PyErr_SetString(PyExc_ValueError, "array.index(x): x not in array");
  867.     return NULL;
  868. }
  869. #endif
  870.  
  871. #if 0
  872. static PyObject *
  873. array_count(self, args)
  874.     arrayobject *self;
  875.     PyObject *args;
  876. {
  877.     int count = 0;
  878.     int i;
  879.     
  880.     if (args == NULL) {
  881.         PyErr_BadArgument();
  882.         return NULL;
  883.     }
  884.     for (i = 0; i < self->ob_size; i++) {
  885.         if (PyObject_Compare(self->ob_item[i], args) == 0)
  886.             count++;
  887.         /* XXX PyErr_Occurred */
  888.     }
  889.     return PyInt_FromLong((long)count);
  890. }
  891. #endif
  892.  
  893. #if 0
  894. static PyObject *
  895. array_remove(self, args)
  896.     arrayobject *self;
  897.     PyObject *args;
  898. {
  899.     int i;
  900.     
  901.     if (args == NULL) {
  902.         PyErr_BadArgument();
  903.         return NULL;
  904.     }
  905.     for (i = 0; i < self->ob_size; i++) {
  906.         if (PyObject_Compare(self->ob_item[i], args) == 0) {
  907.             if (array_ass_slice(self, i, i+1,
  908.                         (PyObject *)NULL) != 0)
  909.                 return NULL;
  910.             Py_INCREF(Py_None);
  911.             return Py_None;
  912.         }
  913.         /* XXX PyErr_Occurred */
  914.     }
  915.     PyErr_SetString(PyExc_ValueError, "array.remove(x): x not in array");
  916.     return NULL;
  917. }
  918. #endif
  919.  
  920. static PyObject *
  921. array_fromfile(self, args)
  922.     arrayobject *self;
  923.     PyObject *args;
  924. {
  925.     PyObject *f;
  926.     int n;
  927.     FILE *fp;
  928.     if (!PyArg_Parse(args, "(Oi)", &f, &n))
  929.         return NULL;
  930.     fp = PyFile_AsFile(f);
  931.     if (fp == NULL) {
  932.         PyErr_SetString(PyExc_TypeError, "arg1 must be open file");
  933.         return NULL;
  934.     }
  935.     if (n > 0) {
  936.         char *item = self->ob_item;
  937.         int itemsize = self->ob_descr->itemsize;
  938.         int nread;
  939.         int newlength;
  940.         size_t newbytes;
  941.         /* Be careful here about overflow */
  942.         if ((newlength = self->ob_size + n) <= 0 ||
  943.             (newbytes = newlength * itemsize) / itemsize !=
  944.             (size_t)newlength)
  945.             goto nomem;
  946.         PyMem_RESIZE(item, char, newbytes);
  947.         if (item == NULL) {
  948.           nomem:
  949.             PyErr_NoMemory();
  950.             return NULL;
  951.         }
  952.         self->ob_item = item;
  953.         self->ob_size += n;
  954.         nread = fread(item + (self->ob_size - n) * itemsize,
  955.                   itemsize, n, fp);
  956.         if (nread < n) {
  957.             self->ob_size -= (n - nread);
  958.             PyMem_RESIZE(item, char, self->ob_size*itemsize);
  959.             self->ob_item = item;
  960.             PyErr_SetString(PyExc_EOFError,
  961.                          "not enough items in file");
  962.             return NULL;
  963.         }
  964.     }
  965.     Py_INCREF(Py_None);
  966.     return Py_None;
  967. }
  968.  
  969. static char fromfile_doc [] =
  970. "fromfile(f, n)\n\
  971. \n\
  972. Read n objects from the file object f and append them to the end of the\n\
  973. array.  Also called as read.";
  974.  
  975.  
  976. static PyObject *
  977. array_tofile(self, args)
  978.     arrayobject *self;
  979.     PyObject *args;
  980. {
  981.     PyObject *f;
  982.     FILE *fp;
  983.     if (!PyArg_Parse(args, "O", &f))
  984.         return NULL;
  985.     fp = PyFile_AsFile(f);
  986.     if (fp == NULL) {
  987.         PyErr_SetString(PyExc_TypeError, "arg must be open file");
  988.         return NULL;
  989.     }
  990.     if (self->ob_size > 0) {
  991.         if ((int)fwrite(self->ob_item, self->ob_descr->itemsize,
  992.                self->ob_size, fp) != self->ob_size) {
  993.             PyErr_SetFromErrno(PyExc_IOError);
  994.             clearerr(fp);
  995.             return NULL;
  996.         }
  997.     }
  998.     Py_INCREF(Py_None);
  999.     return Py_None;
  1000. }
  1001.  
  1002. static char tofile_doc [] =
  1003. "tofile(f)\n\
  1004. \n\
  1005. Write all items (as machine values) to the file object f.  Also called as\n\
  1006. write.";
  1007.  
  1008.  
  1009. static PyObject *
  1010. array_fromlist(self, args)
  1011.     arrayobject *self;
  1012.     PyObject *args;
  1013. {
  1014.     int n;
  1015.     PyObject *list;
  1016.     int itemsize = self->ob_descr->itemsize;
  1017.     if (!PyArg_Parse(args, "O", &list))
  1018.         return NULL;
  1019.     if (!PyList_Check(list)) {
  1020.         PyErr_SetString(PyExc_TypeError, "arg must be list");
  1021.         return NULL;
  1022.     }
  1023.     n = PyList_Size(list);
  1024.     if (n > 0) {
  1025.         char *item = self->ob_item;
  1026.         int i;
  1027.         PyMem_RESIZE(item, char, (self->ob_size + n) * itemsize);
  1028.         if (item == NULL) {
  1029.             PyErr_NoMemory();
  1030.             return NULL;
  1031.         }
  1032.         self->ob_item = item;
  1033.         self->ob_size += n;
  1034.         for (i = 0; i < n; i++) {
  1035.             PyObject *v = PyList_GetItem(list, i);
  1036.             if ((*self->ob_descr->setitem)(self,
  1037.                     self->ob_size - n + i, v) != 0) {
  1038.                 self->ob_size -= n;
  1039.                 PyMem_RESIZE(item, char,
  1040.                               self->ob_size * itemsize);
  1041.                 self->ob_item = item;
  1042.                 return NULL;
  1043.             }
  1044.         }
  1045.     }
  1046.     Py_INCREF(Py_None);
  1047.     return Py_None;
  1048. }
  1049.  
  1050. static char fromlist_doc [] =
  1051. "fromlist(list)\n\
  1052. \n\
  1053. Append items to array from list.";
  1054.  
  1055.  
  1056. static PyObject *
  1057. array_tolist(self, args)
  1058.     arrayobject *self;
  1059.     PyObject *args;
  1060. {
  1061.     PyObject *list = PyList_New(self->ob_size);
  1062.     int i;
  1063.     if (list == NULL)
  1064.         return NULL;
  1065.     for (i = 0; i < self->ob_size; i++) {
  1066.         PyObject *v = getarrayitem((PyObject *)self, i);
  1067.         if (v == NULL) {
  1068.             Py_DECREF(list);
  1069.             return NULL;
  1070.         }
  1071.         PyList_SetItem(list, i, v);
  1072.     }
  1073.     return list;
  1074. }
  1075.  
  1076. static char tolist_doc [] =
  1077. "tolist() -> list\n\
  1078. \n\
  1079. Convert array to an ordinary list with the same items.";
  1080.  
  1081.  
  1082. static PyObject *
  1083. array_fromstring(self, args)
  1084.     arrayobject *self;
  1085.     PyObject *args;
  1086. {
  1087.     char *str;
  1088.     int n;
  1089.     int itemsize = self->ob_descr->itemsize;
  1090.     if (!PyArg_Parse(args, "s#", &str, &n))
  1091.         return NULL;
  1092.     if (n % itemsize != 0) {
  1093.         PyErr_SetString(PyExc_ValueError,
  1094.                "string length not a multiple of item size");
  1095.         return NULL;
  1096.     }
  1097.     n = n / itemsize;
  1098.     if (n > 0) {
  1099.         char *item = self->ob_item;
  1100.         PyMem_RESIZE(item, char, (self->ob_size + n) * itemsize);
  1101.         if (item == NULL) {
  1102.             PyErr_NoMemory();
  1103.             return NULL;
  1104.         }
  1105.         self->ob_item = item;
  1106.         self->ob_size += n;
  1107.         memcpy(item + (self->ob_size - n) * itemsize,
  1108.                str, itemsize*n);
  1109.     }
  1110.     Py_INCREF(Py_None);
  1111.     return Py_None;
  1112. }
  1113.  
  1114. static char fromstring_doc [] =
  1115. "fromstring(string)\n\
  1116. \n\
  1117. Appends items from the string, interpreting it as an array of machine\n\
  1118. values,as if it had been read from a file using the fromfile() method).";
  1119.  
  1120.  
  1121. static PyObject *
  1122. array_tostring(self, args)
  1123.     arrayobject *self;
  1124.     PyObject *args;
  1125. {
  1126.     if (!PyArg_Parse(args, ""))
  1127.         return NULL;
  1128.     return PyString_FromStringAndSize(self->ob_item,
  1129.                     self->ob_size * self->ob_descr->itemsize);
  1130. }
  1131.  
  1132. static char tostring_doc [] =
  1133. "tostring() -> string\n\
  1134. \n\
  1135. Convert the array to an array of machine values and return the string\n\
  1136. representation.";
  1137.  
  1138. PyMethodDef array_methods[] = {
  1139.     {"append",    (PyCFunction)array_append, 0, append_doc},
  1140.     {"buffer_info", (PyCFunction)array_buffer_info, 0, buffer_info_doc},
  1141.     {"byteswap",    (PyCFunction)array_byteswap, 0, byteswap_doc},
  1142. /*    {"count",    (method)array_count},*/
  1143.     {"fromfile",    (PyCFunction)array_fromfile, 0, fromfile_doc},
  1144.     {"fromlist",    (PyCFunction)array_fromlist, 0, fromlist_doc},
  1145.     {"fromstring",    (PyCFunction)array_fromstring, 0, fromstring_doc},
  1146. /*    {"index",    (method)array_index},*/
  1147.     {"insert",    (PyCFunction)array_insert, 0, insert_doc},
  1148.     {"read",    (PyCFunction)array_fromfile, 0, fromfile_doc},
  1149. /*    {"remove",    (method)array_remove},*/
  1150.     {"reverse",    (PyCFunction)array_reverse, 0, reverse_doc},
  1151. /*    {"sort",    (method)array_sort},*/
  1152.     {"tofile",    (PyCFunction)array_tofile, 0, tofile_doc},
  1153.     {"tolist",    (PyCFunction)array_tolist, 0, tolist_doc},
  1154.     {"tostring",    (PyCFunction)array_tostring, 0, tostring_doc},
  1155.     {"write",    (PyCFunction)array_tofile, 0, tofile_doc},
  1156.     {NULL,        NULL}        /* sentinel */
  1157. };
  1158.  
  1159. static PyObject *
  1160. array_getattr(a, name)
  1161.     arrayobject *a;
  1162.     char *name;
  1163. {
  1164.     if (strcmp(name, "typecode") == 0) {
  1165.         char tc = a->ob_descr->typecode;
  1166.         return PyString_FromStringAndSize(&tc, 1);
  1167.     }
  1168.     if (strcmp(name, "itemsize") == 0) {
  1169.         return PyInt_FromLong((long)a->ob_descr->itemsize);
  1170.     }
  1171.     if (strcmp(name, "__members__") == 0) {
  1172.         PyObject *list = PyList_New(2);
  1173.         if (list) {
  1174.             PyList_SetItem(list, 0,
  1175.                        PyString_FromString("typecode"));
  1176.             PyList_SetItem(list, 1,
  1177.                        PyString_FromString("itemsize"));
  1178.             if (PyErr_Occurred()) {
  1179.                 Py_DECREF(list);
  1180.                 list = NULL;
  1181.             }
  1182.         }
  1183.         return list;
  1184.     }
  1185.     return Py_FindMethod(array_methods, (PyObject *)a, name);
  1186. }
  1187.  
  1188. static int
  1189. array_print(a, fp, flags)
  1190.     arrayobject *a;
  1191.     FILE *fp;
  1192.     int flags;
  1193. {
  1194.     int ok = 0;
  1195.     int i, len;
  1196.     PyObject *v;
  1197.     len = a->ob_size;
  1198.     if (len == 0) {
  1199.         fprintf(fp, "array('%c')", a->ob_descr->typecode);
  1200.         return ok;
  1201.     }
  1202.     if (a->ob_descr->typecode == 'c') {
  1203.         fprintf(fp, "array('c', ");
  1204.         v = array_tostring(a, (PyObject *)NULL);
  1205.         ok = PyObject_Print(v, fp, 0);
  1206.         Py_XDECREF(v);
  1207.         fprintf(fp, ")");
  1208.         return ok;
  1209.     }
  1210.     fprintf(fp, "array('%c', [", a->ob_descr->typecode);
  1211.     for (i = 0; i < len && ok == 0; i++) {
  1212.         if (i > 0)
  1213.             fprintf(fp, ", ");
  1214.         v = (a->ob_descr->getitem)(a, i);
  1215.         ok = PyObject_Print(v, fp, 0);
  1216.         Py_XDECREF(v);
  1217.     }
  1218.     fprintf(fp, "])");
  1219.     return ok;
  1220. }
  1221.  
  1222. static PyObject *
  1223. array_repr(a)
  1224.     arrayobject *a;
  1225. {
  1226.     char buf[256];
  1227.     PyObject *s, *t, *comma, *v;
  1228.     int i, len;
  1229.     len = a->ob_size;
  1230.     if (len == 0) {
  1231.         sprintf(buf, "array('%c')", a->ob_descr->typecode);
  1232.         return PyString_FromString(buf);
  1233.     }
  1234.     if (a->ob_descr->typecode == 'c') {
  1235.         sprintf(buf, "array('c', ");
  1236.         s = PyString_FromString(buf);
  1237.         v = array_tostring(a, (PyObject *)NULL);
  1238.         t = PyObject_Repr(v);
  1239.         Py_XDECREF(v);
  1240.         PyString_ConcatAndDel(&s, t);
  1241.         PyString_ConcatAndDel(&s, PyString_FromString(")"));
  1242.         return s;
  1243.     }
  1244.     sprintf(buf, "array('%c', [", a->ob_descr->typecode);
  1245.     s = PyString_FromString(buf);
  1246.     comma = PyString_FromString(", ");
  1247.     for (i = 0; i < len && !PyErr_Occurred(); i++) {
  1248.         if (i > 0)
  1249.             PyString_Concat(&s, comma);
  1250.         v = (a->ob_descr->getitem)(a, i);
  1251.         t = PyObject_Repr(v);
  1252.         Py_XDECREF(v);
  1253.         PyString_ConcatAndDel(&s, t);
  1254.     }
  1255.     Py_XDECREF(comma);
  1256.     PyString_ConcatAndDel(&s, PyString_FromString("])"));
  1257.     return s;
  1258. }
  1259.  
  1260. static int
  1261. array_buffer_getreadbuf(self, index, ptr)
  1262.     arrayobject *self;
  1263.     int index;
  1264.     const void **ptr;
  1265. {
  1266.     if ( index != 0 ) {
  1267.         PyErr_SetString(PyExc_SystemError,
  1268.                 "Accessing non-existent array segment");
  1269.         return -1;
  1270.     }
  1271.     *ptr = (void *)self->ob_item;
  1272.     return self->ob_size*self->ob_descr->itemsize;
  1273. }
  1274.  
  1275. static int
  1276. array_buffer_getwritebuf(self, index, ptr)
  1277.     arrayobject *self;
  1278.     int index;
  1279.     const void **ptr;
  1280. {
  1281.     if ( index != 0 ) {
  1282.         PyErr_SetString(PyExc_SystemError,
  1283.                 "Accessing non-existent array segment");
  1284.         return -1;
  1285.     }
  1286.     *ptr = (void *)self->ob_item;
  1287.     return self->ob_size*self->ob_descr->itemsize;
  1288. }
  1289.  
  1290. static int
  1291. array_buffer_getsegcount(self, lenp)
  1292.     arrayobject *self;
  1293.     int *lenp;
  1294. {
  1295.     if ( lenp )
  1296.         *lenp = self->ob_size*self->ob_descr->itemsize;
  1297.     return 1;
  1298. }
  1299.  
  1300. static PySequenceMethods array_as_sequence = {
  1301.     (inquiry)array_length,                /*sq_length*/
  1302.     (binaryfunc)array_concat,               /*sq_concat*/
  1303.     (intargfunc)array_repeat,        /*sq_repeat*/
  1304.     (intargfunc)array_item,                /*sq_item*/
  1305.     (intintargfunc)array_slice,        /*sq_slice*/
  1306.     (intobjargproc)array_ass_item,        /*sq_ass_item*/
  1307.     (intintobjargproc)array_ass_slice,    /*sq_ass_slice*/
  1308. };
  1309.  
  1310. static PyBufferProcs array_as_buffer = {
  1311.     (getreadbufferproc)array_buffer_getreadbuf,
  1312.     (getwritebufferproc)array_buffer_getwritebuf,
  1313.     (getsegcountproc)array_buffer_getsegcount,
  1314. };
  1315.  
  1316.  
  1317.  
  1318.  
  1319. static PyObject *
  1320. a_array(self, args)
  1321.     PyObject *self;
  1322.     PyObject *args;
  1323. {
  1324.     char c;
  1325.     PyObject *initial = NULL;
  1326.     struct arraydescr *descr;
  1327.     if (!PyArg_Parse(args, "c", &c)) {
  1328.         PyErr_Clear();
  1329.         if (!PyArg_Parse(args, "(cO)", &c, &initial))
  1330.             return NULL;
  1331.         if (!PyList_Check(initial) && !PyString_Check(initial)) {
  1332.             PyErr_SetString(PyExc_TypeError,
  1333.                  "array initializer must be list or string");
  1334.             return NULL;
  1335.         }
  1336.     }
  1337.     for (descr = descriptors; descr->typecode != '\0'; descr++) {
  1338.         if (descr->typecode == c) {
  1339.             PyObject *a;
  1340.             int len;
  1341.             if (initial == NULL || !PyList_Check(initial))
  1342.                 len = 0;
  1343.             else
  1344.                 len = PyList_Size(initial);
  1345.             a = newarrayobject(len, descr);
  1346.             if (a == NULL)
  1347.                 return NULL;
  1348.             if (len > 0) {
  1349.                 int i;
  1350.                 for (i = 0; i < len; i++) {
  1351.                     PyObject *v =
  1352.                              PyList_GetItem(initial, i);
  1353.                     if (setarrayitem(a, i, v) != 0) {
  1354.                         Py_DECREF(a);
  1355.                         return NULL;
  1356.                     }
  1357.                 }
  1358.             }
  1359.             if (initial != NULL && PyString_Check(initial)) {
  1360.                 PyObject *v =
  1361.                   array_fromstring((arrayobject *)a, initial);
  1362.                 if (v == NULL) {
  1363.                     Py_DECREF(a);
  1364.                     return NULL;
  1365.                 }
  1366.                 Py_DECREF(v);
  1367.             }
  1368.             return a;
  1369.         }
  1370.     }
  1371.     PyErr_SetString(PyExc_ValueError,
  1372.         "bad typecode (must be c, b, B, h, H, i, I, l, L, f or d)");
  1373.     return NULL;
  1374. }
  1375.  
  1376. static char a_array_doc [] =
  1377. "array(typecode [, initializer]) -> array\n\
  1378. \n\
  1379. Return a new array whose items are restricted by typecode, and\n\
  1380. initialized from the optional initializer value, which must be a list\n\
  1381. or a string.";
  1382.  
  1383. static PyMethodDef a_methods[] = {
  1384.     {"array",    a_array, 0, a_array_doc},
  1385.     {NULL,        NULL}        /* sentinel */
  1386. };
  1387.  
  1388. static char module_doc [] =
  1389. "This module defines a new object type which can efficiently represent\n\
  1390. an array of basic values: characters, integers, floating point\n\
  1391. numbers.  Arrays are sequence types and behave very much like lists,\n\
  1392. except that the type of objects stored in them is constrained.  The\n\
  1393. type is specified at object creation time by using a type code, which\n\
  1394. is a single character.  The following type codes are defined:\n\
  1395. \n\
  1396.     Type code   C Type             Minimum size in bytes \n\
  1397.     'c'         character          1 \n\
  1398.     'b'         signed integer     1 \n\
  1399.     'B'         unsigned integer   1 \n\
  1400.     'h'         signed integer     2 \n\
  1401.     'H'         unsigned integer   2 \n\
  1402.     'i'         signed integer     2 \n\
  1403.     'I'         unsigned integer   2 \n\
  1404.     'l'         signed integer     4 \n\
  1405.     'L'         unsigned integer   4 \n\
  1406.     'f'         floating point     4 \n\
  1407.     'd'         floating point     8 \n\
  1408. \n\
  1409. Functions:\n\
  1410. \n\
  1411. array(typecode [, initializer]) -- create a new array\n\
  1412. \n\
  1413. Special Objects:\n\
  1414. \n\
  1415. ArrayType -- type object for array objects\n\
  1416. ";
  1417.  
  1418. static char arraytype_doc [] =
  1419. "An array represents basic values and behave very much like lists, except\n\
  1420. the type of objects stored in them is constrained.\n\
  1421. \n\
  1422. Methods:\n\
  1423. \n\
  1424. append() -- append a new item to the end of the array\n\
  1425. buffer_info() -- return information giving the current memory info\n\
  1426. byteswap() -- byteswap all the items of the array\n\
  1427. fromfile() -- read items from a file object\n\
  1428. fromlist() -- append items from the list\n\
  1429. fromstring() -- append items from the string\n\
  1430. insert() -- insert a new item into the array at a provided position\n\
  1431. read() -- DEPRECATED, use fromfile()\n\
  1432. reverse() -- reverse the order of the items in the array\n\
  1433. tofile() -- write all items to a file object\n\
  1434. tolist() -- return the array converted to an ordinary list\n\
  1435. tostring() -- return the array converted to a string\n\
  1436. write() -- DEPRECATED, use tofile()\n\
  1437. \n\
  1438. Variables:\n\
  1439. \n\
  1440. typecode -- the typecode character used to create the array\n\
  1441. itemsize -- the length in bytes of one array item\n\
  1442. ";
  1443.  
  1444. statichere PyTypeObject Arraytype = {
  1445.     PyObject_HEAD_INIT(&PyType_Type)
  1446.     0,
  1447.     "array",
  1448.     sizeof(arrayobject),
  1449.     0,
  1450.     (destructor)array_dealloc,    /*tp_dealloc*/
  1451.     (printfunc)array_print,        /*tp_print*/
  1452.     (getattrfunc)array_getattr,    /*tp_getattr*/
  1453.     0,                /*tp_setattr*/
  1454.     (cmpfunc)array_compare,        /*tp_compare*/
  1455.     (reprfunc)array_repr,        /*tp_repr*/
  1456.     0,                /*tp_as_number*/
  1457.     &array_as_sequence,        /*tp_as_sequence*/
  1458.     0,                /*tp_as_mapping*/
  1459.     0,                 /*tp_hash*/
  1460.     0,                /*tp_call*/
  1461.     0,                /*tp_str*/
  1462.     0,                /*tp_getattro*/
  1463.     0,                /*tp_setattro*/
  1464.     &array_as_buffer,        /*tp_as_buffer*/
  1465.     0,                /*tp_xxx4*/
  1466.     arraytype_doc,            /*tp_doc*/
  1467. };
  1468.  
  1469. DL_EXPORT(void)
  1470. initarray()
  1471. {
  1472.     PyObject *m, *d;
  1473.     m = Py_InitModule3("array", a_methods, module_doc);
  1474.     d = PyModule_GetDict(m);
  1475.     PyDict_SetItemString(d, "ArrayType", (PyObject *)&Arraytype);
  1476.     /* No need to check the error here, the caller will do that */
  1477. }
  1478.