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) |
Guido van Rossum | 99c185e | 1998-04-09 17:54:26 +0000 | [diff] [blame] | 127 | spami(op_not_ , PyObject_Not) |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 128 | spam2(op_and_ , PyNumber_And) |
| 129 | spam2(op_xor , PyNumber_Xor) |
| 130 | spam2(op_or_ , PyNumber_Or) |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 131 | spami(isSequenceType , PySequence_Check) |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 132 | spam2(op_concat , PySequence_Concat) |
| 133 | spamoi(op_repeat , PySequence_Repeat) |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 134 | spami2(sequenceIncludes, PySequence_In) |
| 135 | spami2(indexOf , PySequence_Index) |
| 136 | spami2(countOf , PySequence_Count) |
| 137 | spami(isMappingType , PyMapping_Check) |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 138 | spam2(op_getitem , PyObject_GetItem) |
| 139 | spam2n(op_delitem , PyObject_DelItem) |
| 140 | spam3n(op_setitem , PyObject_SetItem) |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 141 | |
| 142 | static PyObject* |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 143 | op_getslice(s,a) |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 144 | PyObject *s, *a; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 145 | { |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 146 | PyObject *a1; |
Guido van Rossum | 24a4994 | 1997-08-28 18:11:05 +0000 | [diff] [blame] | 147 | int a2,a3; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 148 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 149 | if (!PyArg_ParseTuple(a,"Oii",&a1,&a2,&a3)) |
| 150 | return NULL; |
| 151 | return PySequence_GetSlice(a1,a2,a3); |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 152 | } |
| 153 | |
| 154 | static PyObject* |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 155 | op_setslice(s,a) |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 156 | PyObject *s, *a; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 157 | { |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 158 | PyObject *a1, *a4; |
Guido van Rossum | 24a4994 | 1997-08-28 18:11:05 +0000 | [diff] [blame] | 159 | int a2,a3; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 160 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 161 | if (!PyArg_ParseTuple(a,"OiiO",&a1,&a2,&a3,&a4)) |
| 162 | return NULL; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 163 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 164 | if (-1 == PySequence_SetSlice(a1,a2,a3,a4)) |
| 165 | return NULL; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 166 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 167 | Py_INCREF(Py_None); |
| 168 | return Py_None; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 169 | } |
| 170 | |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 171 | static PyObject* |
| 172 | op_delslice(s,a) |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 173 | PyObject *s, *a; |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 174 | { |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 175 | PyObject *a1; |
Guido van Rossum | 24a4994 | 1997-08-28 18:11:05 +0000 | [diff] [blame] | 176 | int a2,a3; |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 177 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 178 | if(! PyArg_ParseTuple(a,"Oii",&a1,&a2,&a3)) |
| 179 | return NULL; |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 180 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 181 | if (-1 == PySequence_DelSlice(a1,a2,a3)) |
| 182 | return NULL; |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 183 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 184 | Py_INCREF(Py_None); |
| 185 | return Py_None; |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 186 | } |
| 187 | |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 188 | #undef spam1 |
| 189 | #undef spam2 |
Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 190 | #ifdef HAVE_OLD_CPP |
| 191 | #define spam1(OP,DOC) {"OP", OP, 1, DOC}, |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 192 | #define spam2(OP,ALTOP,DOC) {"OP", op_/**/OP, 1, DOC}, \ |
| 193 | {"ALTOP", op_/**/OP, 1, DOC}, |
Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 194 | #else |
| 195 | #define spam1(OP,DOC) {#OP, OP, 1, DOC}, |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 196 | #define spam2(OP,ALTOP,DOC) {#OP, op_##OP, 1, DOC}, \ |
| 197 | {#ALTOP, op_##OP, 1, DOC}, |
Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 198 | #endif |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 199 | |
| 200 | static struct PyMethodDef operator_methods[] = { |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 201 | |
Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 202 | spam1(isCallable, |
| 203 | "isCallable(o) -- Return 1 if o is callable, and zero otherwise.") |
| 204 | spam1(isNumberType, |
| 205 | "isNumberType(o) -- Return 1 if o has a numeric type, and zero otherwise.") |
| 206 | spam1(isSequenceType, |
| 207 | "isSequenceType(o) -- Return 1 if o has a sequence type, and zero otherwise.") |
| 208 | spam1(truth, |
| 209 | "truth(o) -- Return 1 if o is true, and 0 otherwise.") |
| 210 | spam1(sequenceIncludes, |
| 211 | "sequenceIncludes(a, b) -- Return 1 is a includes b, and 0 otherwise.") |
| 212 | spam1(indexOf, |
| 213 | "indexOf(a, b) -- Return the index of b in a.") |
| 214 | spam1(countOf, |
| 215 | "countOf(a, b) -- Return the number of times b occurs in a.") |
| 216 | spam1(isMappingType, |
| 217 | "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] | 218 | |
Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 219 | spam2(add,__add__, "add(a, b) -- Return a + b, for a and b numbers.") |
| 220 | spam2(sub,__sub__, "sub(a, b) -- Return a - b.") |
| 221 | spam2(mul,__mul__, "mul(a, b) -- Return a * b, for a and b numbers.") |
| 222 | spam2(div,__div__, "div(a, b) -- Return a / b.") |
| 223 | spam2(mod,__mod__, "mod(a, b) -- Return a % b.") |
| 224 | spam2(neg,__neg__, "neg(o) -- Return o negated.") |
| 225 | spam2(pos,__pos__, "pos(o) -- Return o positive.") |
| 226 | spam2(abs,__abs__, "abs(o) -- Return the absolute value of o.") |
| 227 | spam2(inv,__inv__, "inv(o) -- Return the inverse of o.") |
| 228 | spam2(lshift,__lshift__, "lshift(a, b) -- Return a shifted left by b.") |
| 229 | spam2(rshift,__rshift__, "rshift(a, b) -- Return a shifted right by b.") |
Guido van Rossum | 99c185e | 1998-04-09 17:54:26 +0000 | [diff] [blame] | 230 | spam2(not_,__not__, "not_(o) -- Return 0 if o is true, and 1 otherwise.") |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 231 | 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] | 232 | 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] | 233 | 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] | 234 | spam2(concat,__concat__, |
| 235 | "concat(a, b) -- Return a + b, for a and b sequences.") |
| 236 | spam2(repeat,__repeat__, |
Guido van Rossum | 36a484f | 1996-12-05 19:01:16 +0000 | [diff] [blame] | 237 | "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] | 238 | spam2(getitem,__getitem__, |
| 239 | "getitem(a, b) -- Return the value of a at index b.") |
| 240 | spam2(setitem,__setitem__, |
| 241 | "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] | 242 | spam2(delitem,__delitem__, |
| 243 | "delitem(a, b) -- Delete the value of a at b.") |
Guido van Rossum | 1720230 | 1996-08-19 22:01:39 +0000 | [diff] [blame] | 244 | spam2(getslice,__getslice__, |
| 245 | "getslice(a, b, c) -- Return the slice of a from b to c-1.") |
| 246 | spam2(setslice,__setslice__, |
Guido van Rossum | c9fb47e | 1996-08-21 17:40:51 +0000 | [diff] [blame] | 247 | "setslice(a, b, c, v) -- Set the slice of a from b to c-1 to the sequence v.") |
| 248 | spam2(delslice,__delslice__, |
| 249 | "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] | 250 | |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 251 | {NULL, NULL} /* sentinel */ |
| 252 | |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 253 | }; |
| 254 | |
| 255 | |
| 256 | /* Initialization function for the module (*must* be called initoperator) */ |
| 257 | |
| 258 | void |
| 259 | initoperator() |
| 260 | { |
Guido van Rossum | 9efe8ef | 1997-09-03 18:19:40 +0000 | [diff] [blame] | 261 | PyObject *m, *d, *v; |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 262 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 263 | /* Create the module and add the functions */ |
| 264 | m = Py_InitModule4("operator", operator_methods, |
| 265 | operator_doc, |
| 266 | (PyObject*)NULL,PYTHON_API_VERSION); |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 267 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 268 | /* Add some symbolic constants to the module */ |
| 269 | d = PyModule_GetDict(m); |
| 270 | PyDict_SetItemString(d, "__version__", |
Guido van Rossum | 9efe8ef | 1997-09-03 18:19:40 +0000 | [diff] [blame] | 271 | v = PyString_FromString("$Rev$")); |
| 272 | Py_XDECREF(v); |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 273 | |
Barry Warsaw | 19f61ae | 1996-12-18 19:50:00 +0000 | [diff] [blame] | 274 | /* Check for errors */ |
| 275 | if (PyErr_Occurred()) |
| 276 | Py_FatalError("can't initialize module operator"); |
Guido van Rossum | 037b940 | 1996-07-30 16:55:54 +0000 | [diff] [blame] | 277 | } |