mono/metadata/object.h

   1 /**
   2  * \file
   3  */
   4
   5 #ifndef _MONO_CLI_OBJECT_H_
   6 #define _MONO_CLI_OBJECT_H_
   7
   8 #include <mono/metadata/class.h>
   9 #include <mono/utils/mono-error.h>
  10
  11 MONO_BEGIN_DECLS
  12
  13 typedef mono_byte MonoBoolean;
  14
  15 typedef struct _MonoString MonoString;
  16 typedef struct _MonoArray MonoArray;
  17 typedef struct _MonoReflectionMethod MonoReflectionMethod;
  18 typedef struct _MonoReflectionAssembly MonoReflectionAssembly;
  19 typedef struct _MonoReflectionModule MonoReflectionModule;
  20 typedef struct _MonoReflectionField MonoReflectionField;
  21 typedef struct _MonoReflectionProperty MonoReflectionProperty;
  22 typedef struct _MonoReflectionEvent MonoReflectionEvent;
  23 typedef struct _MonoReflectionType MonoReflectionType;
  24 typedef struct _MonoDelegate MonoDelegate;
  25 typedef struct _MonoException MonoException;
  26 typedef struct _MonoThreadsSync MonoThreadsSync;
  27 typedef struct _MonoThread MonoThread;
  28 typedef struct _MonoDynamicAssembly MonoDynamicAssembly;
  29 typedef struct _MonoDynamicImage MonoDynamicImage;
  30 typedef struct _MonoReflectionMethodBody MonoReflectionMethodBody;
  31 typedef struct _MonoAppContext MonoAppContext;
  32
  33 typedef struct _MonoObject {
  34         MonoVTable *vtable;
  35         MonoThreadsSync *synchronisation;
  36 } MonoObject;
  37
  38 typedef MonoObject* (*MonoInvokeFunc)        (MonoMethod *method, void *obj, void **params, MonoObject **exc, MonoError *error);
  39 typedef void*    (*MonoCompileFunc)          (MonoMethod *method);
  40 typedef void        (*MonoMainThreadFunc)    (void* user_data);
  41
  42 #define MONO_OBJECT_SETREF(obj,fieldname,value) do {    \
  43                 mono_gc_wbarrier_set_field ((MonoObject*)(obj), &((obj)->fieldname), (MonoObject*)value);       \
  44                 /*(obj)->fieldname = (value);*/ \
  45         } while (0)
  46
  47 /* This should be used if 's' can reside on the heap */
  48 #define MONO_STRUCT_SETREF(s,field,value) do { \
  49         mono_gc_wbarrier_generic_store (&((s)->field), (MonoObject*)(value)); \
  50     } while (0)
  51
  52 #define mono_array_addr(array,type,index) ((type*)(void*) mono_array_addr_with_size (array, sizeof (type), index))
  53 #define mono_array_get(array,type,index) ( *(type*)mono_array_addr ((array), type, (index)) )
  54 #define mono_array_set(array,type,index,value)  \
  55         do {    \
  56                 type *__p = (type *) mono_array_addr ((array), type, (index));  \
  57                 *__p = (value); \
  58         } while (0)
  59 #define mono_array_setref(array,index,value)    \
  60         do {    \
  61                 void **__p = (void **) mono_array_addr ((array), void*, (index));       \
  62                 mono_gc_wbarrier_set_arrayref ((array), __p, (MonoObject*)(value));     \
  63                 /* *__p = (value);*/    \
  64         } while (0)
  65 #define mono_array_memcpy_refs(dest,destidx,src,srcidx,count)   \
  66         do {    \
  67                 void **__p = (void **) mono_array_addr ((dest), void*, (destidx));      \
  68                 void **__s = mono_array_addr ((src), void*, (srcidx));  \
  69                 mono_gc_wbarrier_arrayref_copy (__p, __s, (count));     \
  70         } while (0)
  71
  72 MONO_API mono_unichar2 *mono_string_chars  (MonoString *s);
  73 MONO_API int            mono_string_length (MonoString *s);
  74
  75 MONO_RT_EXTERNAL_ONLY MONO_API MonoObject *
  76 mono_object_new             (MonoDomain *domain, MonoClass *klass);
  77
  78 MONO_RT_EXTERNAL_ONLY
  79 MONO_API MonoObject *
  80 mono_object_new_specific    (MonoVTable *vtable);
  81
  82 /* can be used for classes without finalizer in non-profiling mode */
  83 MONO_RT_EXTERNAL_ONLY
  84 MONO_API MonoObject *
  85 mono_object_new_fast        (MonoVTable *vtable);
  86
  87 MONO_RT_EXTERNAL_ONLY
  88 MONO_API MonoObject *
  89 mono_object_new_alloc_specific (MonoVTable *vtable);
  90
  91 MONO_RT_EXTERNAL_ONLY
  92 MONO_API MonoObject *
  93 mono_object_new_from_token  (MonoDomain *domain, MonoImage *image, uint32_t token);
  94
  95 MONO_RT_EXTERNAL_ONLY
  96 MONO_API MonoArray*
  97 mono_array_new              (MonoDomain *domain, MonoClass *eclass, uintptr_t n);
  98
  99 MONO_RT_EXTERNAL_ONLY
 100 MONO_API MonoArray*
 101 mono_array_new_full         (MonoDomain *domain, MonoClass *array_class,
 102                              uintptr_t *lengths, intptr_t *lower_bounds);
 103
 104 MONO_RT_EXTERNAL_ONLY
 105 MONO_API MonoArray *
 106 mono_array_new_specific     (MonoVTable *vtable, uintptr_t n);
 107
 108 MONO_RT_EXTERNAL_ONLY
 109 MONO_API MonoArray*
 110 mono_array_clone            (MonoArray *array);
 111
 112 MONO_API char*
 113 mono_array_addr_with_size   (MonoArray *array, int size, uintptr_t idx);
 114
 115 MONO_API uintptr_t
 116 mono_array_length           (MonoArray *array);
 117
 118 MONO_API MonoString*
 119 mono_string_empty             (MonoDomain *domain);
 120
 121 MONO_RT_EXTERNAL_ONLY
 122 MONO_API MonoString*
 123 mono_string_empty_wrapper   (void);
 124
 125 MONO_RT_EXTERNAL_ONLY
 126 MONO_API MonoString*
 127 mono_string_new_utf16       (MonoDomain *domain, const mono_unichar2 *text, int32_t len);
 128
 129 MONO_RT_EXTERNAL_ONLY
 130 MONO_API MonoString*
 131 mono_string_new_size        (MonoDomain *domain, int32_t len);
 132
 133 MONO_RT_EXTERNAL_ONLY
 134 MONO_API MonoString*
 135 mono_ldstr                  (MonoDomain *domain, MonoImage *image, uint32_t str_index);
 136
 137 MONO_API MonoString*
 138 mono_string_is_interned     (MonoString *str);
 139
 140 MONO_RT_EXTERNAL_ONLY
 141 MONO_API MonoString*
 142 mono_string_intern          (MonoString *str);
 143
 144 MONO_API MonoString*
 145 mono_string_new             (MonoDomain *domain, const char *text);
 146
 147 MONO_API MonoString*
 148 mono_string_new_wrapper     (const char *text);
 149
 150 MONO_RT_EXTERNAL_ONLY
 151 MONO_API MonoString*
 152 mono_string_new_len         (MonoDomain *domain, const char *text, unsigned int length);
 153
 154 MONO_RT_EXTERNAL_ONLY
 155 MONO_API MonoString*
 156 mono_string_new_utf32       (MonoDomain *domain, const mono_unichar4 *text, int32_t len);
 157
 158 MONO_RT_EXTERNAL_ONLY
 159 MONO_API char *
 160 mono_string_to_utf8         (MonoString *string_obj);
 161
 162 MONO_API char *
 163 mono_string_to_utf8_checked (MonoString *string_obj, MonoError *error);
 164
 165 MONO_API mono_unichar2 *
 166 mono_string_to_utf16        (MonoString *string_obj);
 167
 168 MONO_API mono_unichar4 *
 169 mono_string_to_utf32        (MonoString *string_obj);
 170
 171 MONO_RT_EXTERNAL_ONLY
 172 MONO_API MonoString *
 173 mono_string_from_utf16      (mono_unichar2 *data);
 174
 175 MONO_RT_EXTERNAL_ONLY
 176 MONO_API MonoString *
 177 mono_string_from_utf32      (mono_unichar4 *data);
 178
 179 MONO_API mono_bool
 180 mono_string_equal           (MonoString *s1, MonoString *s2);
 181
 182 MONO_API unsigned int
 183 mono_string_hash            (MonoString *s);
 184
 185 MONO_API int
 186 mono_object_hash            (MonoObject* obj);
 187
 188 MONO_RT_EXTERNAL_ONLY
 189 MONO_API MonoString *
 190 mono_object_to_string (MonoObject *obj, MonoObject **exc);
 191
 192 MONO_RT_EXTERNAL_ONLY
 193 MONO_API MonoObject *
 194 mono_value_box              (MonoDomain *domain, MonoClass *klass, void* val);
 195
 196 MONO_API void
 197 mono_value_copy             (void* dest, void* src, MonoClass *klass);
 198
 199 MONO_API void
 200 mono_value_copy_array       (MonoArray *dest, int dest_idx, void* src, int count);
 201
 202 MONO_API MonoDomain*
 203 mono_object_get_domain      (MonoObject *obj);
 204
 205 MONO_API MonoClass*
 206 mono_object_get_class       (MonoObject *obj);
 207
 208 MONO_API void*
 209 mono_object_unbox           (MonoObject *obj);
 210
 211 MONO_RT_EXTERNAL_ONLY
 212 MONO_API MonoObject *
 213 mono_object_clone           (MonoObject *obj);
 214
 215 MONO_RT_EXTERNAL_ONLY
 216 MONO_API MonoObject *
 217 mono_object_isinst          (MonoObject *obj, MonoClass *klass);
 218
 219 MONO_RT_EXTERNAL_ONLY
 220 MONO_API MonoObject *
 221 mono_object_isinst_mbyref   (MonoObject *obj, MonoClass *klass);
 222
 223 MONO_RT_EXTERNAL_ONLY
 224 MONO_API MonoObject *
 225 mono_object_castclass_mbyref (MonoObject *obj, MonoClass *klass);
 226
 227 MONO_API mono_bool
 228 mono_monitor_try_enter       (MonoObject *obj, uint32_t ms);
 229
 230 MONO_API mono_bool
 231 mono_monitor_enter           (MonoObject *obj);
 232
 233 MONO_API void
 234 mono_monitor_enter_v4        (MonoObject *obj, char *lock_taken);
 235
 236 MONO_API unsigned int
 237 mono_object_get_size         (MonoObject *o);
 238
 239 MONO_API void
 240 mono_monitor_exit            (MonoObject *obj);
 241
 242 MONO_API void
 243 mono_raise_exception        (MonoException *ex);
 244
 245 MONO_RT_EXTERNAL_ONLY
 246 MONO_API void
 247 mono_runtime_object_init    (MonoObject *this_obj);
 248
 249 MONO_RT_EXTERNAL_ONLY
 250 MONO_API void
 251 mono_runtime_class_init     (MonoVTable *vtable);
 252
 253 MONO_API MonoMethod*
 254 mono_object_get_virtual_method (MonoObject *obj, MonoMethod *method);
 255
 256 MONO_RT_EXTERNAL_ONLY
 257 MONO_API MonoObject*
 258 mono_runtime_invoke         (MonoMethod *method, void *obj, void **params,
 259                              MonoObject **exc);
 260
 261 MONO_API MonoMethod *
 262 mono_get_delegate_invoke    (MonoClass *klass);
 263
 264 MONO_API MonoMethod *
 265 mono_get_delegate_begin_invoke (MonoClass *klass);
 266
 267 MONO_API MonoMethod *
 268 mono_get_delegate_end_invoke (MonoClass *klass);
 269
 270 MONO_RT_EXTERNAL_ONLY
 271 MONO_API MonoObject*
 272 mono_runtime_delegate_invoke (MonoObject *delegate, void **params,
 273                               MonoObject **exc);
 274
 275 MONO_RT_EXTERNAL_ONLY
 276 MONO_API MonoObject*
 277 mono_runtime_invoke_array   (MonoMethod *method, void *obj, MonoArray *params,
 278                              MonoObject **exc);
 279
 280 MONO_API void*
 281 mono_method_get_unmanaged_thunk (MonoMethod *method);
 282
 283 MONO_RT_EXTERNAL_ONLY
 284 MONO_API MonoArray*
 285 mono_runtime_get_main_args  (void);
 286
 287 MONO_API void
 288 mono_runtime_exec_managed_code (MonoDomain *domain,
 289                                 MonoMainThreadFunc main_func,
 290                                 void* main_args);
 291
 292 MONO_RT_EXTERNAL_ONLY
 293 MONO_API int
 294 mono_runtime_run_main       (MonoMethod *method, int argc, char* argv[],
 295                              MonoObject **exc);
 296
 297 MONO_RT_EXTERNAL_ONLY
 298 MONO_API int
 299 mono_runtime_exec_main      (MonoMethod *method, MonoArray *args,
 300                              MonoObject **exc);
 301
 302 MONO_API int
 303 mono_runtime_set_main_args  (int argc, char* argv[]);
 304
 305 /* The following functions won't be available with mono was configured with remoting disabled. */
 306 /*#ifndef DISABLE_REMOTING */
 307 MONO_RT_EXTERNAL_ONLY
 308 MONO_API void*
 309 mono_load_remote_field (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, void **res);
 310
 311 MONO_RT_EXTERNAL_ONLY
 312 MONO_API MonoObject *
 313 mono_load_remote_field_new (MonoObject *this_obj, MonoClass *klass, MonoClassField *field);
 314
 315 MONO_RT_EXTERNAL_ONLY
 316 MONO_API void
 317 mono_store_remote_field (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, void* val);
 318
 319 MONO_RT_EXTERNAL_ONLY
 320 MONO_API void
 321 mono_store_remote_field_new (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, MonoObject *arg);
 322
 323 /* #endif */
 324
 325 MONO_API void
 326 mono_unhandled_exception    (MonoObject *exc);
 327
 328 MONO_API void
 329 mono_print_unhandled_exception (MonoObject *exc);
 330
 331 MONO_RT_EXTERNAL_ONLY
 332 MONO_API void*
 333 mono_compile_method        (MonoMethod *method);
 334
 335 /* accessors for fields and properties */
 336 MONO_API void
 337 mono_field_set_value (MonoObject *obj, MonoClassField *field, void *value);
 338
 339 MONO_API void
 340 mono_field_static_set_value (MonoVTable *vt, MonoClassField *field, void *value);
 341
 342 MONO_API void
 343 mono_field_get_value (MonoObject *obj, MonoClassField *field, void *value);
 344
 345 MONO_RT_EXTERNAL_ONLY
 346 MONO_API void
 347 mono_field_static_get_value (MonoVTable *vt, MonoClassField *field, void *value);
 348
 349 MONO_RT_EXTERNAL_ONLY
 350 MONO_API MonoObject *
 351 mono_field_get_value_object (MonoDomain *domain, MonoClassField *field, MonoObject *obj);
 352
 353 MONO_RT_EXTERNAL_ONLY
 354 MONO_API void
 355 mono_property_set_value (MonoProperty *prop, void *obj, void **params, MonoObject **exc);
 356
 357 MONO_RT_EXTERNAL_ONLY
 358 MONO_API MonoObject*
 359 mono_property_get_value (MonoProperty *prop, void *obj, void **params, MonoObject **exc);
 360
 361 /* GC handles support
 362  *
 363  * A handle can be created to refer to a managed object and either prevent it
 364  * from being garbage collected or moved or to be able to know if it has been
 365  * collected or not (weak references).
 366  * mono_gchandle_new () is used to prevent an object from being garbage collected
 367  * until mono_gchandle_free() is called. Use a TRUE value for the pinned argument to
 368  * prevent the object from being moved (this should be avoided as much as possible
 369  * and this should be used only for shorts periods of time or performance will suffer).
 370  * To create a weakref use mono_gchandle_new_weakref (): track_resurrection should
 371  * usually be false (see the GC docs for more details).
 372  * mono_gchandle_get_target () can be used to get the object referenced by both kinds
 373  * of handle: for a weakref handle, if an object has been collected, it will return NULL.
 374  */
 375 MONO_API uint32_t      mono_gchandle_new         (MonoObject *obj, mono_bool pinned);
 376 MONO_API uint32_t      mono_gchandle_new_weakref (MonoObject *obj, mono_bool track_resurrection);
 377 MONO_API MonoObject*  mono_gchandle_get_target  (uint32_t gchandle);
 378 MONO_API void         mono_gchandle_free        (uint32_t gchandle);
 379
 380 /* Reference queue support
 381  *
 382  * A reference queue is used to get notifications of when objects are collected.
 383  * Call mono_gc_reference_queue_new to create a new queue and pass the callback that
 384  * will be invoked when registered objects are collected.
 385  * Call mono_gc_reference_queue_add to register a pair of objects and data within a queue.
 386  * The callback will be triggered once an object is both unreachable and finalized.
 387  */
 388
 389 typedef void (*mono_reference_queue_callback) (void *user_data);
 390 typedef struct _MonoReferenceQueue MonoReferenceQueue;
 391
 392 MONO_API MonoReferenceQueue* mono_gc_reference_queue_new (mono_reference_queue_callback callback);
 393 MONO_API void mono_gc_reference_queue_free (MonoReferenceQueue *queue);
 394 MONO_API mono_bool mono_gc_reference_queue_add (MonoReferenceQueue *queue, MonoObject *obj, void *user_data);
 395
 396
 397
 398 /* GC write barriers support */
 399 MONO_API void mono_gc_wbarrier_set_field     (MonoObject *obj, void* field_ptr, MonoObject* value);
 400 MONO_API void mono_gc_wbarrier_set_arrayref  (MonoArray *arr, void* slot_ptr, MonoObject* value);
 401 MONO_API void mono_gc_wbarrier_arrayref_copy (void* dest_ptr, void* src_ptr, int count);
 402 MONO_API void mono_gc_wbarrier_generic_store (void* ptr, MonoObject* value);
 403 MONO_API void mono_gc_wbarrier_generic_store_atomic (void *ptr, MonoObject *value);
 404 MONO_API void mono_gc_wbarrier_generic_nostore (void* ptr);
 405 MONO_API void mono_gc_wbarrier_value_copy    (void* dest, void* src, int count, MonoClass *klass);
 406 MONO_API void mono_gc_wbarrier_object_copy   (MonoObject* obj, MonoObject *src);
 407
 408 MONO_END_DECLS
 409
 410 #endif
 411