1 /*10 2002/03/19 13:08:33
2 ** Copyright (C) 1998 - 2000 by Universitaet Karlsruhe
3 ** All rights reserved.
5 ** Authors: Martin Trapp, Christian Schaefer,
8 ** entity.h: entities represent all program known objects.
10 ** An entity is the representation of program known objects in Firm.
11 ** The primary concept of entities is to represent members of complex
12 ** types, i.e., fields and methods of classes. As not all programming
13 ** language model all variables and methods as members of some class,
14 ** the concept of entities is extended to cover also local and global
15 ** variables, and arbitrary procedures.
17 ** An entity always specifies the type of the object it represents and
18 ** the type of the object it is a part of, the owner of the entity.
19 ** Originally this is the type of the class of which the entity is a
21 ** The owner of local variables is the procedure they are defined in.
22 ** The owner of global variables and procedures visible in the whole
23 ** program is a universally defined class type "GlobalType". The owner
24 ** of procedures defined in the scope of an other procedure is the
25 ** enclosing procedure.
36 #ifndef _IR_GRAPH_TYPEDEF_
37 #define _IR_GRAPH_TYPEDEF_
38 /* to resolve recursion between entity.h and irgraph.h */
39 typedef struct ir_graph ir_graph;
44 ident *name; /* name of this entity */
45 ident *ld_name; /* Unique name of this entity, i.e., the mangled
46 name. E.g., for a class `A' with field `a' this
47 is the ident for `A_a'. */
48 type *type; /* The type of this entity, e.g., a method type, a
49 basic type of the language or a class itself */
50 type *owner; /* The class this entity belongs to. In case of local
51 variables the method they are defined in. */
52 entity **overwrites; /* A list of entities this entity overwrites. */
53 entity **overwrittenby; /* A list of entities that overwrite this entity. */
54 ent_allocation allocation; /* Distinguishes static and dynamically allocated
56 ent_visibility visibility; /* Specifies visibility to external program
58 ent_variability variability; /* Specifies variability of entities content */
59 ent_volatility volatility; /* Specifies volatility of entities content */
60 ir_node *value; /* value of atomic entity */
61 ir_node **values; /* values of compound entities */
62 entity **val_ents; /* entities corresponding to constant values */
63 int offset; /* Offset in byte for this entity. Fixed when layout
64 of owner is determined. */
65 void *link; /* To store some intermediate information */
66 unsigned long visit; /* visited counter for walks of the type information */
68 enum peculiarity peculiarity;
69 ir_graph *irg; /* If (type == method_type) this is the corresponding irg.
70 The ir_graph constructor automatically sets this field.
71 Yes, it must be here. */
75 # endif /* _ENTITY_T_H_ */