blob: abdf1eafb499245bb503aed5896a3744b9774116 [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001/***********************************************************
2Copyright 1991 by Stichting Mathematisch Centrum, Amsterdam, The
3Netherlands.
4
5 All Rights Reserved
6
7Permission to use, copy, modify, and distribute this software and its
8documentation for any purpose and without fee is hereby granted,
9provided that the above copyright notice appear in all copies and that
10both that copyright notice and this permission notice appear in
11supporting documentation, and that the names of Stichting Mathematisch
12Centrum or CWI not be used in advertising or publicity pertaining to
13distribution of the software without specific, written prior permission.
14
15STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
16THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
17FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
18FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
19WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
20ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
21OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
22
23******************************************************************/
24
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000025/* Tuple object interface */
26
27/*
28123456789-123456789-123456789-123456789-123456789-123456789-123456789-12
29
30Another generally useful object type is an tuple of object pointers.
31This is a mutable type: the tuple items can be changed (but not their
32number). Out-of-range indices or non-tuple objects are ignored.
33
34*** WARNING *** settupleitem does not increment the new item's reference
35count, but does decrement the reference count of the item it replaces,
36if not nil. It does *decrement* the reference count if it is *not*
37inserted in the tuple. Similarly, gettupleitem does not increment the
38returned item's reference count.
39*/
40
Guido van Rossum3f5da241990-12-20 15:06:42 +000041typedef struct {
42 OB_VARHEAD
43 object *ob_item[1];
44} tupleobject;
45
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000046extern typeobject Tupletype;
47
48#define is_tupleobject(op) ((op)->ob_type == &Tupletype)
49
50extern object *newtupleobject PROTO((int size));
51extern int gettuplesize PROTO((object *));
52extern object *gettupleitem PROTO((object *, int));
53extern int settupleitem PROTO((object *, int, object *));
Guido van Rossum3f5da241990-12-20 15:06:42 +000054
55/* Macro, trading safety for speed */
56#define GETTUPLEITEM(op, i) ((op)->ob_item[i])