2002-07-16 Dietmar Maurer <dietmar@ximian.com>
[mono.git] / mono / metadata / metadata.h
index d4db931296f6fa1a4744f905023234e648625e91..04f3f77b601118fe121beffb6e13f637adda299d 100644 (file)
@@ -15,6 +15,7 @@
 #endif
 
 typedef struct _MonoClass MonoClass;
+typedef struct _MonoDomain MonoDomain;
 
 typedef enum {
        MONO_TABLE_MODULE,
@@ -58,7 +59,7 @@ typedef enum {
        MONO_TABLE_FILE,
        MONO_TABLE_EXPORTEDTYPE,
        MONO_TABLE_MANIFESTRESOURCE,
-       MONO_TABLE_NESTEDCLASS,
+       MONO_TABLE_NESTEDCLASS
 
 #define MONO_TABLE_LAST MONO_TABLE_NESTEDCLASS
 } MonoMetaTableEnum;
@@ -79,6 +80,76 @@ typedef enum {
        MONO_CALL_VARARG
 } MonoCallConvention;
 
+/* ECMA lamespec: the old spec had more info... */
+typedef enum {
+       MONO_NATIVE_BOOLEAN = 0x02, /* 4 bytes, 0 is false, != 0 is true */
+       MONO_NATIVE_I1 = 0x03,
+       MONO_NATIVE_U1 = 0x04,
+       MONO_NATIVE_I2 = 0x05,
+       MONO_NATIVE_U2 = 0x06,
+       MONO_NATIVE_I4 = 0x07,
+       MONO_NATIVE_U4 = 0x08,
+       MONO_NATIVE_I8 = 0x09,
+       MONO_NATIVE_U8 = 0x0a,
+       MONO_NATIVE_R4 = 0x0b,
+       MONO_NATIVE_R8 = 0x0c,
+       MONO_NATIVE_CURRENCY = 0x0f,
+       MONO_NATIVE_BSTR = 0x13, /* prefixed length, Unicode */
+       MONO_NATIVE_LPSTR = 0x14, /* ANSI, null terminated */
+       MONO_NATIVE_LPWSTR = 0x15, /* UNICODE, null terminated */
+       MONO_NATIVE_LPTSTR = 0x16, /* plattform dep., null terminated */
+       MONO_NATIVE_BYVALTSTR = 0x17,
+       MONO_NATIVE_IUNKNOWN = 0x19,
+       MONO_NATIVE_IDISPATCH = 0x1a,
+       MONO_NATIVE_STRUCT = 0x1b,
+       MONO_NATIVE_INTERFACE = 0x1c,
+       MONO_NATIVE_SAFEARRAY = 0x1d,
+       MONO_NATIVE_BYVALARRAY = 0x1e,
+       MONO_NATIVE_INT   = 0x1f,
+       MONO_NATIVE_UINT  = 0x20,
+       MONO_NATIVE_VBBYREFSTR  = 0x22,
+       MONO_NATIVE_ANSIBSTR  = 0x23,  /* prefixed length, ANSI */
+       MONO_NATIVE_TBSTR  = 0x24, /* prefixed length, plattform dep. */
+       MONO_NATIVE_VARIANTBOOL  = 0x25,
+       MONO_NATIVE_FUNC  = 0x26,
+       MONO_NATIVE_ASANY = 0x28,
+       MONO_NATIVE_LPARRAY = 0x2a,
+       MONO_NATIVE_LPSTRUCT = 0x2b,
+       MONO_NATIVE_CUSTOM = 0x2c,
+       MONO_NATIVE_ERROR = 0x2d,
+       MONO_NATIVE_MAX = 0x50 /* no info */
+} MonoMarshalNative;
+
+typedef enum {
+       MONO_MARSHAL_CONV_NONE,
+       MONO_MARSHAL_CONV_BOOL_VARIANTBOOL,
+       MONO_MARSHAL_CONV_BOOL_I4,
+       MONO_MARSHAL_CONV_STR_BSTR,
+       MONO_MARSHAL_CONV_STR_LPSTR,
+       MONO_MARSHAL_CONV_LPSTR_STR,
+       MONO_MARSHAL_CONV_STR_LPWSTR,
+       MONO_MARSHAL_CONV_STR_LPTSTR,
+       MONO_MARSHAL_CONV_STR_ANSIBSTR,
+       MONO_MARSHAL_CONV_STR_TBSTR,
+       MONO_MARSHAL_CONV_STR_BYVALSTR,
+       MONO_MARSHAL_CONV_STR_BYVALWSTR,
+       MONO_MARSHAL_CONV_ARRAY_BYVALARRAY,
+       MONO_MARSHAL_CONV_ARRAY_SAVEARRAY,
+       MONO_MARSHAL_CONV_ARRAY_LPARRAY,
+       MONO_MARSHAL_CONV_OBJECT_INTERFACE,
+       MONO_MARSHAL_CONV_OBJECT_IDISPATCH,
+       MONO_MARSHAL_CONV_OBJECT_IUNKNOWN,
+       MONO_MARSHAL_CONV_DEL_FTN
+} MonoMarshalConv;
+
+typedef struct {
+       MonoMarshalNative native;
+       MonoMarshalNative elem_type;
+       gint32 param_num;
+       gint32 num_elem;
+} MonoMarshalSpec;
+
+
 void         mono_metadata_decode_row (MonoTableInfo         *t,
                                       int                    idx,
                                       guint32               *res,
@@ -95,18 +166,46 @@ guint32      mono_metadata_decode_row_col (MonoTableInfo *t,
 #define mono_metadata_table_size(bitfield,table) ((((bitfield) >> ((table)*2)) & 0x3) + 1)
 #define mono_metadata_table_count(bitfield) ((bitfield) >> 24)
 
+int mono_metadata_compute_size (MonoImage   *meta,
+                                int             tableindex,
+                                guint32        *result_bitfield);
+
 /*
  *
  */
-char          *mono_metadata_locate        (MonoMetadata *meta, int table, int idx);
-char          *mono_metadata_locate_token  (MonoMetadata *meta, guint32 token);
+const char    *mono_metadata_locate        (MonoImage *meta, int table, int idx);
+const char    *mono_metadata_locate_token  (MonoImage *meta, guint32 token);
                                           
-const char    *mono_metadata_string_heap   (MonoMetadata *meta, guint32 index);
-const char    *mono_metadata_blob_heap     (MonoMetadata *meta, guint32 index);
-const char    *mono_metadata_user_string   (MonoMetadata *meta, guint32 index);
+const char    *mono_metadata_string_heap   (MonoImage *meta, guint32 table_index);
+const char    *mono_metadata_blob_heap     (MonoImage *meta, guint32 table_index);
+const char    *mono_metadata_user_string   (MonoImage *meta, guint32 table_index);
+const char    *mono_metadata_guid_heap     (MonoImage *meta, guint32 table_index);
+
+guint32 mono_metadata_typedef_from_field  (MonoImage *meta, guint32 table_index);
+guint32 mono_metadata_typedef_from_method (MonoImage *meta, guint32 table_index);
+guint32 mono_metadata_nested_in_typedef   (MonoImage *meta, guint32 table_index);
+guint32 mono_metadata_nesting_typedef     (MonoImage *meta, guint32 table_index);
+
+MonoClass** mono_metadata_interfaces_from_typedef (MonoImage *meta, guint32 table_index, guint *count);
+
+guint32     mono_metadata_events_from_typedef     (MonoImage *meta, guint32 table_index, guint *end_idx);
+guint32     mono_metadata_methods_from_event      (MonoImage *meta, guint32 table_index, guint *end);
+guint32     mono_metadata_properties_from_typedef (MonoImage *meta, guint32 table_index, guint *end);
+guint32     mono_metadata_methods_from_property   (MonoImage *meta, guint32 table_index, guint *end);
+guint32     mono_metadata_packing_from_typedef    (MonoImage *meta, guint32 table_index, guint32 *packing, guint32 *size);
+const char* mono_metadata_get_marshal_info        (MonoImage *meta, guint32 idx, gboolean is_field);
 
-guint32 mono_metadata_typedef_from_field  (MonoMetadata *meta, guint32 index);
-guint32 mono_metadata_typedef_from_method (MonoMetadata *meta, guint32 index);
+MonoMarshalSpec *mono_metadata_parse_marshal_spec (MonoImage *image, const char *ptr);
+
+guint32     mono_metadata_implmap_from_method     (MonoImage *meta, guint32 method_idx);
+
+void        mono_metadata_field_info (MonoImage *meta, 
+                                     guint32       table_index,
+                                     guint32      *offset,
+                                     guint32      *rva,
+                                     MonoMarshalSpec **marshal_spec);
+
+guint32     mono_metadata_get_constant_index (MonoImage *meta, guint32 token);
 
 /*
  * Functions to extract information from the Blobs
@@ -116,6 +215,13 @@ guint32 mono_metadata_decode_value     (const char            *ptr,
 guint32 mono_metadata_decode_blob_size (const char            *ptr,
                                         const char           **rptr);
 
+void mono_metadata_encode_value (guint32 value, char *bug, char **endbuf);
+
+#define MONO_OFFSET_IN_CLAUSE(clause,offset) \
+       ((clause)->try_offset <= (offset) && (offset) < ((clause)->try_offset + (clause)->try_len))
+#define MONO_OFFSET_IN_HANDLER(clause,offset) \
+       ((clause)->handler_offset <= (offset) && (offset) < ((clause)->handler_offset + (clause)->handler_len))
+
 typedef struct {
        guint32 flags;
        guint32 try_offset;
@@ -126,21 +232,15 @@ typedef struct {
 } MonoExceptionClause;
 
 typedef struct _MonoType MonoType;
-typedef struct _MonoArray MonoArray;
+typedef struct _MonoArrayType MonoArrayType;
 typedef struct _MonoMethodSignature MonoMethodSignature;
 
 typedef struct {
-       guchar mod;
-       guint32 token;
+       unsigned int required : 1;
+       unsigned int token    : 31;
 } MonoCustomMod;
 
-typedef struct {
-       MonoType *type;
-       int num_modifiers;
-       MonoCustomMod modifiers [MONO_ZERO_LEN_ARRAY]; /* this may grow */
-} MonoModifiedType;
-
-struct _MonoArray {
+struct _MonoArrayType {
        MonoType *type;
        int rank;
        int numsizes;
@@ -150,41 +250,30 @@ struct _MonoArray {
 };
 
 struct _MonoType {
-       guchar type; /* ElementTypeEnum */
-       guchar custom_mod; /* for PTR and SZARRAY: use data.mtype instead of data.type */
-       guchar byref; /* when included in a MonoRetType */
-       guchar constraint; /* valid when included in a local var signature */
        union {
                MonoClass *klass; /* for VALUETYPE and CLASS */
-               MonoType *type;
-               MonoModifiedType *mtype;
-               MonoArray *array; /* for ARRAY */
+               MonoType *type;   /* for PTR and SZARRAY */
+               MonoArrayType *array; /* for ARRAY */
                MonoMethodSignature *method;
        } data;
-};
-
-typedef struct {
-       /* maybe use a union here: saves 4 bytes */
-       MonoType *type; /* NULL for VOID */
-       short param_attrs; /* 22.1.11 */
-       char typedbyref;
-       char num_modifiers;
+       unsigned int attrs    : 16; /* param attributes or field flags */
+       unsigned int type     : 8;  /* ElementTypeEnum */
+       unsigned int num_mods : 6;  /* max 64 modifiers follow at the end */
+       unsigned int byref    : 1;
+       unsigned int pinned   : 1;  /* valid when included in a local var signature */
        MonoCustomMod modifiers [MONO_ZERO_LEN_ARRAY]; /* this may grow */
-} MonoRetType;
-
-/* MonoRetType is used also for params and fields */
-typedef MonoRetType MonoParam;
-typedef MonoRetType MonoFieldType;
+};
 
 struct _MonoMethodSignature {
-       char          hasthis;
-       char          explicit_this;
-       char          call_convention;
+       unsigned int  hasthis : 1;
+       unsigned int  explicit_this   : 1;
+       unsigned int  call_convention : 6;
+       unsigned int  pinvoke   : 1;
+       unsigned int  ref_count : 23;
        guint16       param_count;
        guint16       sentinelpos;
-       MonoRetType  *ret;
-       MonoParam   **params;
-       guint32       params_size;
+       MonoType     *ret;
+       MonoType     *params [MONO_ZERO_LEN_ARRAY];
 };
 
 typedef struct {
@@ -195,53 +284,87 @@ typedef struct {
        /* if num_locals != 0, then the following apply: */
        unsigned int init_locals : 1;
        guint16      num_locals;
-       MonoType   **locals;
-       guint32      locals_size;
        MonoExceptionClause *clauses;
+       MonoType    *locals [MONO_ZERO_LEN_ARRAY];
 } MonoMethodHeader;
 
-guint32     mono_metadata_parse_typedef_or_ref (MonoMetadata      *m,
+typedef enum {
+       MONO_PARSE_TYPE,
+       MONO_PARSE_MOD_TYPE,
+       MONO_PARSE_LOCAL,
+       MONO_PARSE_PARAM,
+       MONO_PARSE_RET,
+       MONO_PARSE_FIELD
+} MonoParseTypeMode;
+
+guint32     mono_metadata_parse_typedef_or_ref (MonoImage      *m,
                                                 const char      *ptr,
                                                 const char     **rptr);
-int            mono_metadata_parse_custom_mod  (MonoMetadata      *m,
+int            mono_metadata_parse_custom_mod  (MonoImage      *m,
                                                MonoCustomMod   *dest,
                                                const char      *ptr,
                                                const char     **rptr);
-MonoArray     *mono_metadata_parse_array       (MonoMetadata      *m,
+MonoArrayType *mono_metadata_parse_array       (MonoImage      *m,
                                                const char      *ptr,
                                                const char     **rptr);
-void           mono_metadata_free_array        (MonoArray       *array);
-MonoParam     *mono_metadata_parse_param       (MonoMetadata      *m,
-                                               int              rettype,
+void           mono_metadata_free_array        (MonoArrayType     *array);
+MonoType      *mono_metadata_parse_type        (MonoImage      *m,
+                                               MonoParseTypeMode  mode,
+                                               short              opt_attrs,
+                                               const char        *ptr,
+                                               const char       **rptr);
+MonoType      *mono_metadata_parse_param       (MonoImage      *m,
                                                const char      *ptr,
-                                               const char     **rptr);
-void           mono_metadata_free_param        (MonoParam       *param);
-MonoType      *mono_metadata_parse_type        (MonoMetadata      *m,
-                                                       const char      *ptr,
-                                                       const char     **rptr);
+                                               const char      **rptr);
+MonoType      *mono_metadata_parse_ret_type    (MonoImage      *m,
+                                               const char      *ptr,
+                                               const char      **rptr);
+MonoType      *mono_metadata_parse_field_type  (MonoImage      *m,
+                                               short            field_flags,
+                                               const char      *ptr,
+                                               const char      **rptr);
+MonoType      *mono_type_create_from_typespec  (MonoImage        *image, 
+                                               guint32           type_spec);
 void           mono_metadata_free_type         (MonoType        *type);
 int            mono_type_size                  (MonoType        *type, 
                                                int             *alignment);
+int            mono_type_stack_size            (MonoType        *type, 
+                                               int             *alignment);
+
+MonoType      *mono_get_param_info             (MonoMethodSignature *sig, 
+                                               int                  param_num, 
+                                               int                 *size, 
+                                               int                 *align);
 
-MonoFieldType *mono_metadata_parse_field_type  (MonoMetadata      *m,
-                                               const char      *ptr,
-                                               const char      **rptr);
-                                                       
 
-MonoMethodSignature  *mono_metadata_parse_method_signature (MonoMetadata            *m,
+guint          mono_metadata_type_hash         (MonoType *t1);
+gboolean       mono_metadata_type_equal        (MonoType *t1, MonoType *t2);
+
+MonoMethodSignature  *mono_metadata_parse_signature (MonoImage *image, 
+                                                    guint32    token);
+
+MonoMethodSignature  *mono_metadata_parse_method_signature (MonoImage            *m,
                                                             int                    def,
                                                             const char            *ptr,
                                                             const char           **rptr);
 void                  mono_metadata_free_method_signature  (MonoMethodSignature   *method);
 
-gboolean          mono_metadata_signature_equal (MonoMetadata *m1, 
-                                                MonoMethodSignature *sig1, 
-                                                MonoMetadata *m2, 
+gboolean          mono_metadata_signature_equal (MonoMethodSignature *sig1, 
                                                 MonoMethodSignature *sig2);
 
-MonoMethodHeader *mono_metadata_parse_mh (MonoMetadata *m, const char *ptr);
+guint             mono_signature_hash (MonoMethodSignature *sig);
+
+MonoMethodHeader *mono_metadata_parse_mh (MonoImage *m, const char *ptr);
 void              mono_metadata_free_mh  (MonoMethodHeader *mh);
 
+guint32 
+mono_type_to_unmanaged (MonoType *type, MonoMarshalSpec *mspec, 
+                       gboolean as_field, gboolean unicode, MonoMarshalConv *conv);
+
+gint32
+mono_marshal_type_size (MonoType *type, MonoMarshalSpec *mspec, gint32 *align, 
+                       gboolean as_field, gboolean unicode);
+
 /*
  * Makes a token based on a table and an index
  */