Merge branch 'opt_manage'
[libfirm] / include / libfirm / typerep.h
index f20f01d..4a0b4c9 100644 (file)
@@ -200,6 +200,19 @@ FIRM_API ir_entity *new_entity(ir_type *owner, ident *name, ir_type *tp);
 FIRM_API ir_entity *new_d_entity(ir_type *owner, ident *name, ir_type *tp,
                                  dbg_info *db);
 
+/**
+ * Creates a new entity corresponding to a function parameter.
+ * This must be created on an irgs frame_type
+ */
+FIRM_API ir_entity *new_parameter_entity(ir_type *owner, size_t pos,
+                                         ir_type *type);
+
+/**
+ * Like new_parameter_entity() but with debug information.
+ */
+FIRM_API ir_entity *new_d_parameter_entity(ir_type *owner, size_t pos,
+                                           ir_type *type, dbg_info *dbgi);
+
 /**
  * Copies the entity if the new_owner is different from the
  * owner of the old entity,  else returns the old entity.
@@ -278,15 +291,6 @@ FIRM_API void set_entity_linkage(ir_entity *entity, ir_linkage linkage);
 FIRM_API void add_entity_linkage(ir_entity *entity, ir_linkage linkage);
 FIRM_API void remove_entity_linkage(ir_entity *entity, ir_linkage linkage);
 
-/**
- * This enumeration flags the volatility of entities and Loads/Stores.
- * @deprecated
- */
-typedef enum {
-       volatility_non_volatile,    /**< The entity is not volatile. Default. */
-       volatility_is_volatile      /**< The entity is volatile. */
-} ir_volatility;
-
 /**
  * Returns the volatility of an entity.
  * @deprecated
@@ -313,22 +317,13 @@ FIRM_API void set_entity_alignment(ir_entity *entity, unsigned alignment);
 
 
 /**
- * This enumeration flags the align of Loads/Stores.
- * @deprecated
- */
-typedef enum {
-       align_non_aligned,    /**< The entity is not aligned. */
-       align_is_aligned      /**< The entity is aligned. Default */
-} ir_align;
-
-/**
- * Returns indication wether entity is aligned in memory.
+ * Returns indication whether entity is aligned in memory.
  * @deprecated
  */
 FIRM_API ir_align get_entity_aligned(const ir_entity *ent);
 
 /**
- * Sets indication wether entity is aligned in memory
+ * Sets indication whether entity is aligned in memory
  * @deprecated
  */
 FIRM_API void set_entity_aligned(ir_entity *ent, ir_align a);
@@ -418,6 +413,24 @@ FIRM_API dbg_info *get_entity_dbg_info(const ir_entity *ent);
  */
 FIRM_API void set_entity_dbg_info(ir_entity *ent, dbg_info *db);
 
+#define IR_VA_START_PARAMETER_NUMBER  ((size_t)-1)
+
+/**
+ * returns true if a given entity is a parameter_entity representing the
+ * address of a function parameter
+ */
+FIRM_API int is_parameter_entity(const ir_entity *entity);
+
+/**
+ * returns number of parameter a parameter entitiy represents
+ */
+FIRM_API size_t get_entity_parameter_number(const ir_entity *entity);
+
+/**
+ * set number of parameter an entity represents
+ */
+FIRM_API void set_entity_parameter_number(ir_entity *entity, size_t n);
+
 /* -- Representation of constant values of entities -- */
 /**
  * Returns true if the the node is representable as code on
@@ -1566,10 +1579,6 @@ FIRM_API int is_Struct_type(const ir_type *strct);
  * - res_type:   A list with the types of parameters.  This list is ordered.
  *               The nth type in this list corresponds to the nth input to
  *               Return nodes.  (See ircons.h for more information.)
- *
- * - value_res_ents
- *               A list of entities (whose owner is a struct private to the
- *               method type) that represent results passed by value.
  */
 
 /* These macros define the suffixes for the types and entities used
@@ -1605,48 +1614,19 @@ FIRM_API ir_type *new_d_type_method(size_t n_param, size_t n_res,
 FIRM_API size_t get_method_n_params(const ir_type *method);
 
 /** Returns the type of the parameter at position pos of a method. */
-FIRM_API ir_type *get_method_param_type(ir_type *method, size_t pos);
+FIRM_API ir_type *get_method_param_type(const ir_type *method, size_t pos);
 /** Sets the type of the parameter at position pos of a method.
     Also changes the type in the pass-by-value representation by just
     changing the type of the corresponding entity if the representation is constructed. */
 FIRM_API void set_method_param_type(ir_type *method, size_t pos, ir_type *tp);
-/** Returns an entity that represents the copied value argument.  Only necessary
-   for compounds passed by value. This information is constructed only on demand. */
-FIRM_API ir_entity *get_method_value_param_ent(ir_type *method, size_t pos);
-/**
- * Sets the type that represents the copied value arguments.
- */
-FIRM_API void set_method_value_param_type(ir_type *method, ir_type *tp);
-/**
- * Returns a type that represents the copied value arguments if one
- * was allocated, else NULL.
- */
-FIRM_API ir_type *get_method_value_param_type(const ir_type *method);
-/** Returns an ident representing the parameters name. Returns NULL if not set.
-    For debug support only. */
-FIRM_API ident *get_method_param_ident(ir_type *method, size_t pos);
-/** Returns a string representing the parameters name. Returns NULL if not set.
-    For debug support only. */
-FIRM_API const char *get_method_param_name(ir_type *method, size_t pos);
-/** Sets an ident representing the parameters name. For debug support only. */
-FIRM_API void set_method_param_ident(ir_type *method, size_t pos, ident *id);
-
 /** Returns the number of results of a method type. */
 FIRM_API size_t get_method_n_ress(const ir_type *method);
 /** Returns the return type of a method type at position pos. */
-FIRM_API ir_type *get_method_res_type(ir_type *method, size_t pos);
+FIRM_API ir_type *get_method_res_type(const ir_type *method, size_t pos);
 /** Sets the type of the result at position pos of a method.
     Also changes the type in the pass-by-value representation by just
     changing the type of the corresponding entity if the representation is constructed. */
 FIRM_API void set_method_res_type(ir_type *method, size_t pos, ir_type *tp);
-/** Returns an entity that represents the copied value result.  Only necessary
-   for compounds passed by value. This information is constructed only on demand. */
-FIRM_API ir_entity *get_method_value_res_ent(ir_type *method, size_t pos);
-
-/**
- * Returns a type that represents the copied value results.
- */
-FIRM_API ir_type *get_method_value_res_type(const ir_type *method);
 
 /**
  * This enum flags the variadicity of methods (methods with a
@@ -1667,23 +1647,6 @@ FIRM_API ir_variadicity get_method_variadicity(const ir_type *method);
 /** Sets the variadicity of a method. */
 FIRM_API void set_method_variadicity(ir_type *method, ir_variadicity vari);
 
-/**
- * Returns the first variadic parameter index of a type.
- * If this index was NOT set, the index of the last parameter
- * of the method type plus one is returned for variadic functions.
- * Non-variadic function types always return -1 here.
- */
-FIRM_API size_t get_method_first_variadic_param_index(const ir_type *method);
-
-/**
- * Sets the first variadic parameter index. This allows to specify
- * a complete call type (containing the type of all parameters)
- * but still have the knowledge, which parameter must be passed as
- * variadic one.
- */
-FIRM_API void set_method_first_variadic_param_index(ir_type *method,
-                                                    size_t index);
-
 /** Returns the mask of the additional graph properties. */
 FIRM_API mtp_additional_properties get_method_additional_properties(const ir_type *method);
 
@@ -1833,7 +1796,7 @@ FIRM_API int is_Union_type(const ir_type *uni);
  * The entity for array elements is built automatically.
  * Set dimension sizes after call to constructor with set_* routines.
  */
-FIRM_API ir_type *new_type_array(int n_dims, ir_type *element_type);
+FIRM_API ir_type *new_type_array(size_t n_dims, ir_type *element_type);
 
 /** Create a new type array with debug information.
  *
@@ -1843,7 +1806,7 @@ FIRM_API ir_type *new_type_array(int n_dims, ir_type *element_type);
  * Set dimension sizes after call to constructor with set_* routines.
  * A legal array type must have at least one dimension set.
  */
-FIRM_API ir_type *new_d_type_array(int n_dims, ir_type *element_type,
+FIRM_API ir_type *new_d_type_array(size_t n_dims, ir_type *element_type,
                                    type_dbg_info* db);
 
 /* --- manipulate private fields of array type --- */
@@ -1895,16 +1858,16 @@ FIRM_API ir_node *get_array_upper_bound(const ir_type *array, size_t dimension);
 FIRM_API long get_array_upper_bound_int(const ir_type *array, size_t dimension);
 
 /** Sets an array dimension to a specific order. */
-FIRM_API void set_array_order(ir_type *array, size_t dimension, int order);
+FIRM_API void set_array_order(ir_type *array, size_t dimension, size_t order);
 
 /** Returns the order of an array dimension. */
-FIRM_API int get_array_order(const ir_type *array, size_t dimension);
+FIRM_API size_t get_array_order(const ir_type *array, size_t dimension);
 
 /** Find the array dimension that is placed at order order. */
-FIRM_API size_t find_array_dimension(const ir_type *array, int order);
+FIRM_API size_t find_array_dimension(const ir_type *array, size_t order);
 
 /** Sets the array element type. */
-FIRM_API void set_array_element_type(ir_type *array, ir_typetp);
+FIRM_API void set_array_element_type(ir_type *array, ir_type *tp);
 
 /** Gets the array element type. */
 FIRM_API ir_type *get_array_element_type(const ir_type *array);
@@ -2124,6 +2087,9 @@ FIRM_API ir_entity *get_compound_member(const ir_type *tp, size_t pos);
 /** Returns index of member in tp, -1 if not contained. */
 FIRM_API size_t get_compound_member_index(const ir_type *tp, ir_entity *member);
 
+/** Remove a member from a compound type. */
+FIRM_API void remove_compound_member(ir_type *compound, ir_entity *entity);
+
 /**
  * layout members of a struct/union or class type in a default way.
  */
@@ -2139,7 +2105,7 @@ FIRM_API void default_layout_compound_type(ir_type *tp);
 FIRM_API int is_compound_type(const ir_type *tp);
 
 /**
- * Checks wether a type is a code type.
+ * Checks whether a type is a code type.
  */
 FIRM_API int is_code_type(const ir_type *tp);
 
@@ -2148,23 +2114,6 @@ FIRM_API int is_code_type(const ir_type *tp);
  */
 FIRM_API int is_frame_type(const ir_type *tp);
 
-/**
- * Checks, whether a type is a value parameter type.
- */
-FIRM_API int is_value_param_type(const ir_type *tp);
-
-/**
- * Checks, whether a type is a lowered type.
- */
-FIRM_API int is_lowered_type(const ir_type *tp);
-
-/**
- * Makes a new value type. Value types are struct types,
- * so all struct access functions work.
- * Value types are not in the global list of types.
- */
-FIRM_API ir_type *new_type_value(void);
-
 /**
  * Makes a new frame type. Frame types are class types,
  * so all class access functions work.
@@ -2179,18 +2128,6 @@ FIRM_API ir_type *new_type_frame(void);
  */
 FIRM_API ir_type *clone_frame_type(ir_type *type);
 
-/**
- * Sets a lowered type for a type. This sets both associations
- * and marks lowered_type as a "lowered" one.
- */
-FIRM_API void set_lowered_type(ir_type *tp, ir_type *lowered_type);
-
-/**
- * Gets the lowered/unlowered type of a type or NULL if this type
- * has no lowered/unlowered one.
- */
-FIRM_API ir_type *get_associated_type(const ir_type *tp);
-
 /**
  * Allocate an area of size bytes aligned at alignment
  * at the start or the end of a frame type.