blob: bbca6c17de1ecf9c9f9f1e8d3f49b42c7d688c79 [file] [log] [blame]
Guido van Rossuma3309961993-07-28 09:05:47 +00001#ifndef Py_COMPILE_H
2#define Py_COMPILE_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
Guido van Rossumf70e43a1991-02-19 12:39:46 +00007/***********************************************************
Guido van Rossum5799b521995-01-04 19:06:22 +00008Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
9The Netherlands.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000010
11 All Rights Reserved
12
Guido van Rossumfd71b9e2000-06-30 23:50:40 +000013Copyright (c) 2000, BeOpen.com.
14Copyright (c) 1995-2000, Corporation for National Research Initiatives.
15Copyright (c) 1990-1995, Stichting Mathematisch Centrum.
16All rights reserved.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000017
Guido van Rossumfd71b9e2000-06-30 23:50:40 +000018See the file "Misc/COPYRIGHT" for information on usage and
19redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000020
21******************************************************************/
22
Guido van Rossum884afd61995-07-18 14:21:06 +000023/* Definitions for bytecode */
Guido van Rossum3f5da241990-12-20 15:06:42 +000024
Guido van Rossum884afd61995-07-18 14:21:06 +000025/* Bytecode object */
Guido van Rossum3f5da241990-12-20 15:06:42 +000026typedef struct {
Guido van Rossumcaa63801995-01-12 11:45:45 +000027 PyObject_HEAD
Guido van Rossum884afd61995-07-18 14:21:06 +000028 int co_argcount; /* #arguments, except *args */
29 int co_nlocals; /* #local variables */
Guido van Rossum3f6e4081997-01-17 20:59:26 +000030 int co_stacksize; /* #entries needed for evaluation stack */
Guido van Rossum884afd61995-07-18 14:21:06 +000031 int co_flags; /* CO_..., see below */
Guido van Rossumd076c731998-10-07 19:42:25 +000032 PyObject *co_code; /* instruction opcodes */
Guido van Rossum884afd61995-07-18 14:21:06 +000033 PyObject *co_consts; /* list (constants used) */
34 PyObject *co_names; /* list of strings (names used) */
35 PyObject *co_varnames; /* tuple of strings (local variable names) */
36 /* The rest doesn't count for hash/cmp */
37 PyObject *co_filename; /* string (where it was loaded from) */
38 PyObject *co_name; /* string (name, for reference) */
Guido van Rossum76757981997-01-24 03:41:09 +000039 int co_firstlineno; /* first source line number */
40 PyObject *co_lnotab; /* string (encoding addr<->lineno mapping) */
Guido van Rossumcaa63801995-01-12 11:45:45 +000041} PyCodeObject;
Guido van Rossum3f5da241990-12-20 15:06:42 +000042
Guido van Rossum884afd61995-07-18 14:21:06 +000043/* Masks for co_flags above */
44#define CO_OPTIMIZED 0x0001
45#define CO_NEWLOCALS 0x0002
46#define CO_VARARGS 0x0004
47#define CO_VARKEYWORDS 0x0008
48
Guido van Rossum051ab121995-02-27 10:17:52 +000049extern DL_IMPORT(PyTypeObject) PyCode_Type;
Guido van Rossum3f5da241990-12-20 15:06:42 +000050
Guido van Rossumcaa63801995-01-12 11:45:45 +000051#define PyCode_Check(op) ((op)->ob_type == &PyCode_Type)
Guido van Rossum3f5da241990-12-20 15:06:42 +000052
Guido van Rossum3f6e4081997-01-17 20:59:26 +000053#define CO_MAXBLOCKS 20 /* Max static block nesting within a function */
Guido van Rossum3f5da241990-12-20 15:06:42 +000054
55/* Public interface */
Guido van Rossume543a941991-04-03 19:00:55 +000056struct _node; /* Declare the existence of this type */
Guido van Rossum43466ec1998-12-04 18:48:25 +000057DL_IMPORT(PyCodeObject *) PyNode_Compile Py_PROTO((struct _node *, char *));
58DL_IMPORT(PyCodeObject *) PyCode_New Py_PROTO((
Guido van Rossum3f6e4081997-01-17 20:59:26 +000059 int, int, int, int, PyObject *, PyObject *, PyObject *, PyObject *,
Guido van Rossum76757981997-01-24 03:41:09 +000060 PyObject *, PyObject *, int, PyObject *)); /* same as struct above */
Guido van Rossum43466ec1998-12-04 18:48:25 +000061DL_IMPORT(int) PyCode_Addr2Line Py_PROTO((PyCodeObject *, int));
Guido van Rossuma3309961993-07-28 09:05:47 +000062
Guido van Rossumd076c731998-10-07 19:42:25 +000063/* for internal use only */
64#define _PyCode_GETCODEPTR(co, pp) \
65 ((*(co)->co_code->ob_type->tp_as_buffer->bf_getreadbuffer) \
66 ((co)->co_code, 0, (void **)(pp)))
67
Guido van Rossuma3309961993-07-28 09:05:47 +000068#ifdef __cplusplus
69}
70#endif
71#endif /* !Py_COMPILE_H */