| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 1 | static char operator_doc[] = "\ | 
 | 2 | Operator interface.\n\ | 
 | 3 | \n\ | 
 | 4 | This module exports a set of functions implemented in C corresponding\n\ | 
 | 5 | to the intrinsic operators of Python.  For example, operator.add(x, y)\n\ | 
 | 6 | is equivalent to the expression x+y.  The function names are those\n\ | 
 | 7 | used for special class methods; variants without leading and trailing\n\ | 
 | 8 | '__' are also provided for convenience.\n\ | 
 | 9 | "; | 
 | 10 |  | 
 | 11 | /* | 
 | 12 |  | 
 | 13 |      Copyright  | 
 | 14 |  | 
 | 15 |        Copyright 1996 Digital Creations, L.C., 910 Princess Anne | 
 | 16 |        Street, Suite 300, Fredericksburg, Virginia 22401 U.S.A. All | 
 | 17 |        rights reserved.  Copyright in this software is owned by DCLC, | 
 | 18 |        unless otherwise indicated. Permission to use, copy and | 
 | 19 |        distribute this software is hereby granted, provided that the | 
 | 20 |        above copyright notice appear in all copies and that both that | 
 | 21 |        copyright notice and this permission notice appear. Note that | 
 | 22 |        any product, process or technology described in this software | 
 | 23 |        may be the subject of other Intellectual Property rights | 
 | 24 |        reserved by Digital Creations, L.C. and are not licensed | 
 | 25 |        hereunder. | 
 | 26 |  | 
 | 27 |      Trademarks  | 
 | 28 |  | 
 | 29 |        Digital Creations & DCLC, are trademarks of Digital Creations, L.C.. | 
 | 30 |        All other trademarks are owned by their respective companies.  | 
 | 31 |  | 
 | 32 |      No Warranty  | 
 | 33 |  | 
 | 34 |        The software is provided "as is" without warranty of any kind, | 
 | 35 |        either express or implied, including, but not limited to, the | 
 | 36 |        implied warranties of merchantability, fitness for a particular | 
 | 37 |        purpose, or non-infringement. This software could include | 
 | 38 |        technical inaccuracies or typographical errors. Changes are | 
 | 39 |        periodically made to the software; these changes will be | 
 | 40 |        incorporated in new editions of the software. DCLC may make | 
 | 41 |        improvements and/or changes in this software at any time | 
 | 42 |        without notice. | 
 | 43 |  | 
 | 44 |      Limitation Of Liability  | 
 | 45 |  | 
 | 46 |        In no event will DCLC be liable for direct, indirect, special, | 
 | 47 |        incidental, economic, cover, or consequential damages arising | 
 | 48 |        out of the use of or inability to use this software even if | 
 | 49 |        advised of the possibility of such damages. Some states do not | 
 | 50 |        allow the exclusion or limitation of implied warranties or | 
 | 51 |        limitation of liability for incidental or consequential | 
 | 52 |        damages, so the above limitation or exclusion may not apply to | 
 | 53 |        you. | 
 | 54 |  | 
 | 55 |  | 
 | 56 |     If you have questions regarding this software, | 
 | 57 |     contact: | 
 | 58 |     | 
 | 59 |       Jim Fulton, jim@digicool.com | 
 | 60 |       Digital Creations L.C.   | 
 | 61 |     | 
 | 62 |       (540) 371-6909 | 
 | 63 |  | 
 | 64 |     Modifications | 
 | 65 |      | 
 | 66 |       Renamed and slightly rearranged by Guido van Rossum | 
 | 67 |  | 
 | 68 | */ | 
 | 69 |  | 
 | 70 | #include "Python.h" | 
 | 71 |  | 
 | 72 | #define spam1(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 73 |   PyObject *a1; \ | 
 | 74 |   if(! PyArg_ParseTuple(a,"O",&a1)) return NULL; \ | 
 | 75 |   return AOP(a1); } | 
 | 76 |  | 
 | 77 | #define spam2(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 78 |   PyObject *a1, *a2; \ | 
 | 79 |   if(! PyArg_ParseTuple(a,"OO",&a1,&a2)) return NULL; \ | 
 | 80 |   return AOP(a1,a2); } | 
 | 81 |  | 
 | 82 | #define spamoi(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 83 |   PyObject *a1; int a2; \ | 
 | 84 |   if(! PyArg_ParseTuple(a,"Oi",&a1,&a2)) return NULL; \ | 
 | 85 |   return AOP(a1,a2); } | 
 | 86 |  | 
 | 87 | #define spam2n(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 88 |   PyObject *a1, *a2; \ | 
 | 89 |   if(! PyArg_ParseTuple(a,"OO",&a1,&a2)) return NULL; \ | 
 | 90 |   if(-1 == AOP(a1,a2)) return NULL; \ | 
 | 91 |   Py_INCREF(Py_None); \ | 
 | 92 |   return Py_None; } | 
 | 93 |  | 
 | 94 | #define spam3n(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 95 |   PyObject *a1, *a2, *a3; \ | 
 | 96 |   if(! PyArg_ParseTuple(a,"OOO",&a1,&a2,&a3)) return NULL; \ | 
 | 97 |   if(-1 == AOP(a1,a2,a3)) return NULL; \ | 
 | 98 |   Py_INCREF(Py_None); \ | 
 | 99 |   return Py_None; } | 
 | 100 |  | 
 | 101 | #define spami(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 102 |   PyObject *a1; long r; \ | 
 | 103 |   if(! PyArg_ParseTuple(a,"O",&a1)) return NULL; \ | 
 | 104 |   if(-1 == (r=AOP(a1))) return NULL; \ | 
 | 105 |   return PyInt_FromLong(r); } | 
 | 106 |  | 
 | 107 | #define spami2(OP,AOP) static PyObject *OP(s,a) PyObject *s, *a; { \ | 
 | 108 |   PyObject *a1, *a2; long r; \ | 
 | 109 |   if(! PyArg_ParseTuple(a,"OO",&a1,&a2)) return NULL; \ | 
 | 110 |   if(-1 == (r=AOP(a1,a2))) return NULL; \ | 
 | 111 |   return PyInt_FromLong(r); } | 
 | 112 |  | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 113 | spami(isCallable       , PyCallable_Check) | 
 | 114 | spami(isNumberType     , PyNumber_Check) | 
 | 115 | spami(truth            , PyObject_IsTrue) | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 116 | spam2(op_add           , PyNumber_Add) | 
 | 117 | spam2(op_sub           , PyNumber_Subtract) | 
 | 118 | spam2(op_mul           , PyNumber_Multiply) | 
 | 119 | spam2(op_div           , PyNumber_Divide) | 
 | 120 | spam2(op_mod           , PyNumber_Remainder) | 
 | 121 | spam1(op_neg           , PyNumber_Negative) | 
 | 122 | spam1(op_pos           , PyNumber_Positive) | 
 | 123 | spam1(op_abs           , PyNumber_Absolute) | 
 | 124 | spam1(op_inv           , PyNumber_Invert) | 
 | 125 | spam2(op_lshift        , PyNumber_Lshift) | 
 | 126 | spam2(op_rshift        , PyNumber_Rshift) | 
 | 127 | spam2(op_and_          , PyNumber_And) | 
 | 128 | spam2(op_xor           , PyNumber_Xor) | 
 | 129 | spam2(op_or_           , PyNumber_Or) | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 130 | spami(isSequenceType   , PySequence_Check) | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 131 | spam2(op_concat        , PySequence_Concat) | 
 | 132 | spamoi(op_repeat       , PySequence_Repeat) | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 133 | spami2(sequenceIncludes, PySequence_In) | 
 | 134 | spami2(indexOf         , PySequence_Index) | 
 | 135 | spami2(countOf         , PySequence_Count) | 
 | 136 | spami(isMappingType    , PyMapping_Check) | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 137 | spam2(op_getitem       , PyObject_GetItem) | 
 | 138 | spam2n(op_delitem       , PyObject_DelItem) | 
 | 139 | spam3n(op_setitem      , PyObject_SetItem) | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 140 |  | 
 | 141 | static PyObject* | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 142 | op_getslice(s,a) | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 143 |         PyObject *s, *a; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 144 | { | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 145 |         PyObject *a1; | 
| Guido van Rossum | 24a4994 | 1997-08-28 18:11:05 +0000 | [diff] [blame] | 146 |         int a2,a3; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 147 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 148 |         if (!PyArg_ParseTuple(a,"Oii",&a1,&a2,&a3)) | 
 | 149 |                 return NULL; | 
 | 150 |         return PySequence_GetSlice(a1,a2,a3); | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 151 | } | 
 | 152 |  | 
 | 153 | static PyObject* | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 154 | op_setslice(s,a) | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 155 |         PyObject *s, *a; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 156 | { | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 157 |         PyObject *a1, *a4; | 
| Guido van Rossum | 24a4994 | 1997-08-28 18:11:05 +0000 | [diff] [blame] | 158 |         int a2,a3; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 159 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 160 |         if (!PyArg_ParseTuple(a,"OiiO",&a1,&a2,&a3,&a4)) | 
 | 161 |                 return NULL; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 162 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 163 |         if (-1 == PySequence_SetSlice(a1,a2,a3,a4)) | 
 | 164 |                 return NULL; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 165 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 166 |         Py_INCREF(Py_None); | 
 | 167 |         return Py_None; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 168 | } | 
 | 169 |  | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 170 | static PyObject* | 
 | 171 | op_delslice(s,a) | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 172 |         PyObject *s, *a; | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 173 | { | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 174 |         PyObject *a1; | 
| Guido van Rossum | 24a4994 | 1997-08-28 18:11:05 +0000 | [diff] [blame] | 175 |         int a2,a3; | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 176 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 177 |         if(! PyArg_ParseTuple(a,"Oii",&a1,&a2,&a3)) | 
 | 178 |                 return NULL; | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 179 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 180 |         if (-1 == PySequence_DelSlice(a1,a2,a3)) | 
 | 181 |                 return NULL; | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 182 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 183 |         Py_INCREF(Py_None); | 
 | 184 |         return Py_None; | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 185 | } | 
 | 186 |  | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 187 | #undef spam1 | 
 | 188 | #undef spam2 | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 189 | #ifdef HAVE_OLD_CPP | 
 | 190 | #define spam1(OP,DOC) {"OP", OP, 1, DOC}, | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 191 | #define spam2(OP,ALTOP,DOC) {"OP", op_/**/OP, 1, DOC}, \ | 
 | 192 | 			   {"ALTOP", op_/**/OP, 1, DOC},  | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 193 | #else | 
 | 194 | #define spam1(OP,DOC) {#OP, OP, 1, DOC}, | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 195 | #define spam2(OP,ALTOP,DOC) {#OP, op_##OP, 1, DOC}, \ | 
 | 196 | 			   {#ALTOP, op_##OP, 1, DOC},  | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 197 | #endif | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 198 |  | 
 | 199 | static struct PyMethodDef operator_methods[] = { | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 200 |  | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 201 | spam1(isCallable, | 
 | 202 |  "isCallable(o) -- Return 1 if o is callable, and zero otherwise.") | 
 | 203 | spam1(isNumberType, | 
 | 204 |  "isNumberType(o) -- Return 1 if o has a numeric type, and zero otherwise.") | 
 | 205 | spam1(isSequenceType, | 
 | 206 |  "isSequenceType(o) -- Return 1 if o has a sequence type, and zero otherwise.") | 
 | 207 | spam1(truth, | 
 | 208 |  "truth(o) -- Return 1 if o is true, and 0 otherwise.") | 
 | 209 | spam1(sequenceIncludes, | 
 | 210 |  "sequenceIncludes(a, b) -- Return 1 is a includes b, and 0 otherwise.") | 
 | 211 | spam1(indexOf, | 
 | 212 |  "indexOf(a, b) -- Return the index of b in a.") | 
 | 213 | spam1(countOf, | 
 | 214 |  "countOf(a, b) -- Return the number of times b occurs in a.") | 
 | 215 | spam1(isMappingType, | 
 | 216 |  "isMappingType(o) -- Return 1 if o has a mapping type, and zero otherwise.") | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 217 |  | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 218 | spam2(add,__add__, "add(a, b) -- Return a + b, for a and b numbers.") | 
 | 219 | spam2(sub,__sub__, "sub(a, b) -- Return a - b.") | 
 | 220 | spam2(mul,__mul__, "mul(a, b) -- Return a * b, for a and b numbers.") | 
 | 221 | spam2(div,__div__, "div(a, b) -- Return a / b.") | 
 | 222 | spam2(mod,__mod__, "mod(a, b) -- Return a % b.") | 
 | 223 | spam2(neg,__neg__, "neg(o) -- Return o negated.") | 
 | 224 | spam2(pos,__pos__, "pos(o) -- Return o positive.") | 
 | 225 | spam2(abs,__abs__, "abs(o) -- Return the absolute value of o.") | 
 | 226 | spam2(inv,__inv__, "inv(o) -- Return the inverse of o.") | 
 | 227 | spam2(lshift,__lshift__, "lshift(a, b) -- Return a shifted left by b.") | 
 | 228 | spam2(rshift,__rshift__, "rshift(a, b) -- Return a shifted right by b.") | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 229 | spam2(and_,__and__, "and_(a, b) -- Return the bitwise and of a and b.") | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 230 | spam2(xor,__xor__, "xor(a, b) -- Return the bitwise exclusive-or of a and b.") | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 231 | spam2(or_,__or__, "or_(a, b) -- Return the bitwise or of a and b.") | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 232 | spam2(concat,__concat__, | 
 | 233 |  "concat(a, b) -- Return a + b, for a and b sequences.") | 
 | 234 | spam2(repeat,__repeat__, | 
| Guido van Rossum | 36a484f | 1996-12-05 19:01:16 +0000 | [diff] [blame] | 235 |  "repeat(a, b) -- Return a * b, where a is a sequence, and b is an integer.") | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 236 | spam2(getitem,__getitem__, | 
 | 237 |  "getitem(a, b) -- Return the value of a at index b.") | 
 | 238 | spam2(setitem,__setitem__, | 
 | 239 |  "setitem(a, b, c) -- Set the value of a at b to c.") | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 240 | spam2(delitem,__delitem__, | 
 | 241 |  "delitem(a, b) -- Delete the value of a at b.") | 
| Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 242 | spam2(getslice,__getslice__, | 
 | 243 |  "getslice(a, b, c) -- Return the slice of a from b to c-1.") | 
 | 244 | spam2(setslice,__setslice__, | 
| Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 245 | "setslice(a, b, c, v) -- Set the slice of a from b to c-1 to the sequence v.") | 
 | 246 | spam2(delslice,__delslice__, | 
 | 247 | "delslice(a, b, c) -- Delete the slice of a from b to c-1.") | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 248 |  | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 249 | 	{NULL,		NULL}		/* sentinel */ | 
 | 250 |  | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 251 | }; | 
 | 252 |  | 
 | 253 |  | 
 | 254 | /* Initialization function for the module (*must* be called initoperator) */ | 
 | 255 |  | 
 | 256 | void | 
 | 257 | initoperator() | 
 | 258 | { | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 259 |         PyObject *m, *d; | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 260 |    | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 261 |         /* Create the module and add the functions */ | 
 | 262 |         m = Py_InitModule4("operator", operator_methods, | 
 | 263 |                            operator_doc, | 
 | 264 |                            (PyObject*)NULL,PYTHON_API_VERSION); | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 265 |  | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 266 |         /* Add some symbolic constants to the module */ | 
 | 267 |         d = PyModule_GetDict(m); | 
 | 268 |         PyDict_SetItemString(d, "__version__", | 
 | 269 |                              PyString_FromString("$Rev$")); | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 270 |    | 
| Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 271 |         /* Check for errors */ | 
 | 272 |         if (PyErr_Occurred()) | 
 | 273 |                 Py_FatalError("can't initialize module operator"); | 
| Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 274 | } |