mono/metadata/object.h

   1 #ifndef _MONO_CLI_OBJECT_H_
   2 #define _MONO_CLI_OBJECT_H_
   3
   4 #include <mono/metadata/class.h>
   5
   6 typedef guchar MonoBoolean;
   7
   8 typedef struct _MonoReflectionMethod MonoReflectionMethod;
   9 typedef struct _MonoReflectionAssembly MonoReflectionAssembly;
  10 typedef struct _MonoReflectionModule MonoReflectionModule;
  11 typedef struct _MonoReflectionField MonoReflectionField;
  12 typedef struct _MonoReflectionProperty MonoReflectionProperty;
  13 typedef struct _MonoReflectionEvent MonoReflectionEvent;
  14 typedef struct _MonoReflectionType MonoReflectionType;
  15 typedef struct _MonoDelegate MonoDelegate;
  16 typedef struct _MonoException MonoException;
  17 typedef struct _MonoThreadsSync MonoThreadsSync;
  18 typedef struct _MonoThread MonoThread;
  19 typedef struct _MonoDynamicAssembly MonoDynamicAssembly;
  20 typedef struct _MonoDynamicImage MonoDynamicImage;
  21 typedef struct _MonoReflectionMethodBody MonoReflectionMethodBody;
  22 typedef struct _MonoAppContext MonoAppContext;
  23
  24 typedef struct {
  25         MonoVTable *vtable;
  26         MonoThreadsSync *synchronisation;
  27 } MonoObject;
  28
  29 typedef struct {
  30         guint32 length;
  31         guint32 lower_bound;
  32 } MonoArrayBounds;
  33
  34 typedef struct {
  35         MonoObject obj;
  36         /* bounds is NULL for szarrays */
  37         MonoArrayBounds *bounds;
  38         /* total number of elements of the array */
  39         guint32 max_length;
  40         /* we use double to ensure proper alignment on platforms that need it */
  41         double vector [MONO_ZERO_LEN_ARRAY];
  42 } MonoArray;
  43
  44 typedef struct {
  45         MonoObject object;
  46         gint32 length;
  47         gunichar2 chars [MONO_ZERO_LEN_ARRAY];
  48 } MonoString;
  49
  50 typedef MonoObject* (*MonoInvokeFunc)        (MonoMethod *method, void *obj, void **params, MonoObject **exc);
  51 typedef gpointer    (*MonoCompileFunc)       (MonoMethod *method);
  52 typedef void        (*MonoMainThreadFunc)    (gpointer user_data);
  53
  54 #define mono_object_class(obj) (((MonoObject*)(obj))->vtable->klass)
  55 #define mono_object_domain(obj) (((MonoObject*)(obj))->vtable->domain)
  56
  57 #define mono_array_length(array) ((array)->max_length)
  58 #define mono_array_addr(array,type,index) ((type*) mono_array_addr_with_size (array, sizeof (type), index))
  59 #define mono_array_addr_with_size(array,size,index) ( ((char*)(array)->vector) + (size) * (index) )
  60 #define mono_array_get(array,type,index) ( *(type*)mono_array_addr ((array), type, (index)) )
  61 #define mono_array_set(array,type,index,value)  \
  62         do {    \
  63                 type *__p = (type *) mono_array_addr ((array), type, (index));  \
  64                 *__p = (value); \
  65         } while (0)
  66
  67 #define mono_string_chars(s) ((gunichar2*)(s)->chars)
  68 #define mono_string_length(s) ((s)->length)
  69
  70 MonoObject *
  71 mono_object_new             (MonoDomain *domain, MonoClass *klass);
  72
  73 MonoObject *
  74 mono_object_new_specific    (MonoVTable *vtable);
  75
  76 /* can be used for classes without finalizer in non-profiling mode */
  77 MonoObject *
  78 mono_object_new_fast        (MonoVTable *vtable);
  79
  80 MonoObject *
  81 mono_object_new_alloc_specific (MonoVTable *vtable);
  82
  83 MonoObject *
  84 mono_object_new_from_token  (MonoDomain *domain, MonoImage *image, guint32 token);
  85
  86 MonoArray*
  87 mono_array_new              (MonoDomain *domain, MonoClass *eclass, guint32 n);
  88
  89 MonoArray*
  90 mono_array_new_full         (MonoDomain *domain, MonoClass *array_class,
  91                              guint32 *lengths, guint32 *lower_bounds);
  92
  93 MonoArray *
  94 mono_array_new_specific     (MonoVTable *vtable, guint32 n);
  95
  96 MonoArray*
  97 mono_array_clone            (MonoArray *array);
  98
  99 MonoString*
 100 mono_string_new_utf16       (MonoDomain *domain, const guint16 *text, gint32 len);
 101
 102 MonoString*
 103 mono_string_new_size        (MonoDomain *domain, gint32 len);
 104
 105 MonoString*
 106 mono_ldstr                  (MonoDomain *domain, MonoImage *image, guint32 str_index);
 107
 108 MonoString*
 109 mono_string_is_interned     (MonoString *str);
 110
 111 MonoString*
 112 mono_string_intern          (MonoString *str);
 113
 114 MonoString*
 115 mono_string_new             (MonoDomain *domain, const char *text);
 116
 117 MonoString*
 118 mono_string_new_wrapper     (const char *text);
 119
 120 MonoString*
 121 mono_string_new_len         (MonoDomain *domain, const char *text, guint length);
 122
 123 char *
 124 mono_string_to_utf8         (MonoString *string_obj);
 125
 126 gunichar2 *
 127 mono_string_to_utf16        (MonoString *string_obj);
 128
 129 MonoString *
 130 mono_string_from_utf16      (gunichar2 *data);
 131
 132 gboolean
 133 mono_string_equal           (MonoString *s1, MonoString *s2);
 134
 135 guint
 136 mono_string_hash            (MonoString *s);
 137
 138 MonoObject *
 139 mono_value_box              (MonoDomain *domain, MonoClass *klass, gpointer val);
 140
 141 MonoDomain*
 142 mono_object_get_domain      (MonoObject *obj);
 143
 144 MonoClass*
 145 mono_object_get_class       (MonoObject *obj);
 146
 147 gpointer
 148 mono_object_unbox           (MonoObject *obj);
 149
 150 MonoObject *
 151 mono_object_clone           (MonoObject *obj);
 152
 153 MonoObject *
 154 mono_object_isinst          (MonoObject *obj, MonoClass *klass);
 155
 156 MonoObject *
 157 mono_object_isinst_mbyref   (MonoObject *obj, MonoClass *klass);
 158
 159 MonoObject *
 160 mono_object_castclass_mbyref (MonoObject *obj, MonoClass *klass);
 161
 162 gboolean
 163 mono_monitor_try_enter       (MonoObject *obj, guint32 ms);
 164
 165 gboolean
 166 mono_monitor_enter           (MonoObject *obj);
 167
 168 guint
 169 mono_object_get_size         (MonoObject *o);
 170
 171 void
 172 mono_monitor_exit            (MonoObject *obj);
 173
 174 void
 175 mono_raise_exception        (MonoException *ex);
 176
 177 void
 178 mono_runtime_object_init    (MonoObject *this_obj);
 179
 180 void
 181 mono_runtime_class_init     (MonoVTable *vtable);
 182
 183 MonoMethod*
 184 mono_object_get_virtual_method (MonoObject *obj, MonoMethod *method);
 185
 186 MonoObject*
 187 mono_runtime_invoke         (MonoMethod *method, void *obj, void **params,
 188                              MonoObject **exc);
 189
 190 MonoMethod *
 191 mono_get_delegate_invoke    (MonoClass *klass);
 192
 193 MonoObject*
 194 mono_runtime_delegate_invoke (MonoObject *delegate, void **params,
 195                               MonoObject **exc);
 196
 197 MonoObject*
 198 mono_runtime_invoke_array   (MonoMethod *method, void *obj, MonoArray *params,
 199                              MonoObject **exc);
 200
 201 MonoArray*
 202 mono_runtime_get_main_args  (void);
 203
 204 void
 205 mono_runtime_exec_managed_code (MonoDomain *domain,
 206                                 MonoMainThreadFunc main_func,
 207                                 gpointer main_args);
 208
 209 int
 210 mono_runtime_run_main       (MonoMethod *method, int argc, char* argv[],
 211                              MonoObject **exc);
 212
 213 int
 214 mono_runtime_exec_main      (MonoMethod *method, MonoArray *args,
 215                              MonoObject **exc);
 216
 217 gpointer
 218 mono_load_remote_field (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, gpointer *res);
 219
 220 MonoObject *
 221 mono_load_remote_field_new (MonoObject *this_obj, MonoClass *klass, MonoClassField *field);
 222
 223 void
 224 mono_store_remote_field (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, gpointer val);
 225
 226 void
 227 mono_store_remote_field_new (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, MonoObject *arg);
 228
 229 void
 230 mono_unhandled_exception    (MonoObject *exc);
 231
 232 void
 233 mono_print_unhandled_exception (MonoObject *exc);
 234
 235 gpointer
 236 mono_compile_method        (MonoMethod *method);
 237
 238 MonoRemoteClass*
 239 mono_remote_class (MonoDomain *domain, MonoString *class_name, MonoClass *proxy_class);
 240
 241 void
 242 mono_upgrade_remote_class (MonoDomain *domain, MonoRemoteClass *remote_class, MonoClass *klass);
 243
 244 /* accessors for fields and properties */
 245 void
 246 mono_field_set_value (MonoObject *obj, MonoClassField *field, void *value);
 247
 248 void
 249 mono_field_static_set_value (MonoVTable *vt, MonoClassField *field, void *value);
 250
 251 void
 252 mono_field_get_value (MonoObject *obj, MonoClassField *field, void *value);
 253
 254 void
 255 mono_field_static_get_value (MonoVTable *vt, MonoClassField *field, void *value);
 256
 257 MonoObject *
 258 mono_field_get_value_object (MonoDomain *domain, MonoClassField *field, MonoObject *obj);
 259
 260 void
 261 mono_property_set_value (MonoProperty *prop, void *obj, void **params, MonoObject **exc);
 262
 263 MonoObject*
 264 mono_property_get_value (MonoProperty *prop, void *obj, void **params, MonoObject **exc);
 265
 266 /* GC handles support
 267  *
 268  * A handle can be created to refer to a managed object and either prevent it
 269  * from being garbage collected or moved or to be able to know if it has been
 270  * collected or not (weak references).
 271  * mono_gchandle_new () is used to prevent an object from being garbage collected
 272  * until mono_gchandle_free() is called. Use a TRUE value for the pinned argument to
 273  * prevent the object from being moved (this should be avoided as much as possible
 274  * and this should be used only for shorts periods of time or performance will suffer).
 275  * To create a weakref use mono_gchandle_new_weakref (): track_resurrection should
 276  * usually be false (see the GC docs for more details).
 277  * mono_gchandle_get_target () can be used to get the object referenced by both kinds
 278  * of handle: for a weakref handle, if an object has been collected, it will return NULL.
 279  */
 280 guint32      mono_gchandle_new         (MonoObject *obj, gboolean pinned);
 281 guint32      mono_gchandle_new_weakref (MonoObject *obj, gboolean track_resurrection);
 282 MonoObject*  mono_gchandle_get_target  (guint32 gchandle);
 283 void         mono_gchandle_free        (guint32 gchandle);
 284
 285 #endif
 286