Switch to NULL-terminated array of strings
[openscop.git] / include / openscop / scop.h.in
blobda087fb99cf67cf78e07ead0d96220fdeef7aeb6
2 /*+-----------------------------------------------------------------**
3 ** OpenScop Library **
4 **-----------------------------------------------------------------**
5 ** scop.h **
6 **-----------------------------------------------------------------**
7 ** First version: 30/04/2008 **
8 **-----------------------------------------------------------------**
11 *****************************************************************************
12 * OpenScop: Structures and formats for polyhedral tools to talk together *
13 *****************************************************************************
14 * ,___,,_,__,,__,,__,,__,,_,__,,_,__,,__,,___,_,__,,_,__, *
15 * / / / // // // // / / / // // / / // / /|,_, *
16 * / / / // // // // / / / // // / / // / / / /\ *
17 * |~~~|~|~~~|~~~|~~~|~~~|~|~~~|~|~~~|~~~|~~~|~|~~~|~|~~~|/_/ \ *
18 * | G |C| P | = | L | P |=| = |C| = | = | = |=| = |=| C |\ \ /\ *
19 * | R |l| o | = | e | l |=| = |a| = | = | = |=| = |=| L | \# \ /\ *
20 * | A |a| l | = | t | u |=| = |n| = | = | = |=| = |=| o | |\# \ \ *
21 * | P |n| l | = | s | t |=| = |d| = | = | = | | |=| o | | \# \ \ *
22 * | H | | y | | e | o | | = |l| | | = | | | | G | | \ \ \ *
23 * | I | | | | e | | | | | | | | | | | | | \ \ \ *
24 * | T | | | | | | | | | | | | | | | | | \ \ \ *
25 * | E | | | | | | | | | | | | | | | | | \ \ \ *
26 * | * |*| * | * | * | * |*| * |*| * | * | * |*| * |*| * | / \* \ \ *
27 * | O |p| e | n | S | c |o| p |-| L | i | b |r| a |r| y |/ \ \ / *
28 * '---'-'---'---'---'---'-'---'-'---'---'---'-'---'-'---' '--' *
29 * *
30 * Copyright (C) 2008 University Paris-Sud 11 and INRIA *
31 * *
32 * (3-clause BSD license) *
33 * Redistribution and use in source and binary forms, with or without *
34 * modification, are permitted provided that the following conditions *
35 * are met: *
36 * *
37 * 1. Redistributions of source code must retain the above copyright notice, *
38 * this list of conditions and the following disclaimer. *
39 * 2. Redistributions in binary form must reproduce the above copyright *
40 * notice, this list of conditions and the following disclaimer in the *
41 * documentation and/or other materials provided with the distribution. *
42 * 3. The name of the author may not be used to endorse or promote products *
43 * derived from this software without specific prior written permission. *
44 * *
45 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR *
46 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES *
47 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. *
48 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, *
49 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT *
50 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, *
51 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY *
52 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT *
53 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF *
54 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. *
55 * *
56 * OpenScop Library, a library to manipulate OpenScop formats and data *
57 * structures. Written by: *
58 * Cedric Bastoul <Cedric.Bastoul@u-psud.fr> and *
59 * Louis-Noel Pouchet <Louis-Noel.pouchet@inria.fr> *
60 * *
61 *****************************************************************************/
64 /*+****************************************************************************
65 * THIS FILE HAS BEEN AUTOMATICALLY GENERATED FROM scop.h.in BY configure *
66 ******************************************************************************/
69 #ifndef OPENSCOP_SCOP_H
70 # define OPENSCOP_SCOP_H
72 # include <unistd.h>
74 # define OPENSCOP_RELEASE "@PACKAGE_VERSION@"
75 # define OPENSCOP_VERSION "@BITS@"
76 # ifndef @OPENSCOP_INT_T@
77 # define @OPENSCOP_INT_T@
78 # endif
80 # include <openscop/macros.h>
81 # include <openscop/util.h>
82 # include <openscop/strings.h>
83 # include <openscop/names.h>
84 # include <openscop/vector.h>
85 # include <openscop/relation.h>
86 # include <openscop/extension.h>
87 # include <openscop/statement.h>
90 # if defined(__cplusplus)
91 extern "C"
93 # endif
96 /**
97 * The scop_t structure stores the useful information of a static
98 * control part of a program to process it within a polyhedral framework.
99 * Parameter information may be strings of characters (char *) or a generic
100 * pointer to anything else (void *). The OpenScop library does not touch AT
101 * ALL generic information: printing, copy etc. must be done externally.
103 struct openscop_scop {
104 int version; /**< Version of the data structure */
105 char * language; /**< Target language (backend) */
106 openscop_relation_p context; /**< Constraints on the SCoP parameters */
107 int parameter_type; /**< OPENSCOP_TYPE_GENERIC if parameters are
108 generic (void*), OPENSCOP_TYPE_STRING if
109 they are strings (castable to char*) */
110 void ** parameters; /**< NULL-terminated array of parameters */
111 openscop_statement_p statement; /**< Statement list of the SCoP */
112 openscop_extension_p extension; /**< Extension list */
113 void * usr; /**< A user-defined field, not touched
114 AT ALL by the OpenScop Library */
116 typedef struct openscop_scop openscop_scop_t;
117 typedef struct openscop_scop * openscop_scop_p;
120 /*+***************************************************************************
121 * Structure display function *
122 *****************************************************************************/
123 void openscop_scop_idump(FILE *, openscop_scop_p, int);
124 void openscop_scop_dump(FILE *, openscop_scop_p);
125 void openscop_scop_print(FILE *, openscop_scop_p);
128 /*****************************************************************************
129 * Reading function *
130 *****************************************************************************/
131 openscop_scop_p openscop_scop_read(FILE *);
134 /*+***************************************************************************
135 * Memory allocation/deallocation function *
136 *****************************************************************************/
137 openscop_scop_p openscop_scop_malloc();
138 void openscop_scop_free(openscop_scop_p);
141 /*+***************************************************************************
142 * Processing functions *
143 *****************************************************************************/
144 openscop_scop_p openscop_scop_clone(openscop_scop_p);
145 int openscop_scop_equal(openscop_scop_p, openscop_scop_p);
146 int openscop_scop_integrity_check(openscop_scop_p);
149 # if defined(__cplusplus)
151 # endif
153 #endif /* define OPENSCOP_SCOP_H */