blob: cc1921de027c10ac178568f3e9de22c3e8d2539b [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/* List object interface */
26
27/*
28123456789-123456789-123456789-123456789-123456789-123456789-123456789-12
29
30Another generally useful object type is an list of object pointers.
31This is a mutable type: the list items can be changed, and items can be
32added or removed. Out-of-range indices or non-list objects are ignored.
33
34*** WARNING *** setlistitem 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 list. Similarly, getlistitem 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;
44} listobject;
45
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000046extern typeobject Listtype;
47
48#define is_listobject(op) ((op)->ob_type == &Listtype)
49
50extern object *newlistobject PROTO((int size));
51extern int getlistsize PROTO((object *));
52extern object *getlistitem PROTO((object *, int));
53extern int setlistitem PROTO((object *, int, object *));
54extern int inslistitem PROTO((object *, int, object *));
55extern int addlistitem PROTO((object *, object *));
Guido van Rossum14da5801990-10-30 13:32:39 +000056extern int sortlist PROTO((object *));
Guido van Rossum3f5da241990-12-20 15:06:42 +000057
58/* Macro, trading safety for speed */
59#define GETLISTITEM(op, i) ((op)->ob_item[i])