This section documents some of the internal APIs used inside Mono that developers extending or altering Mono might want to use.
These routines are used when coping with strings that come from Mono's environment, and might be encoded in one or more of the external encodings.
For example, some file systems might historically contain a mix of file names with both old and new encodings, typically UTF8 for new files, and the old files would be encoded in an 8 bit character set (ISO-8859-1 for example).
These routines try a number of encodings, those specified in the MONO_ENCODINGS environment variable and return unicode strings that can be used internally.
See the mono(1) man page for more details.
mono_unicode_from_external
in | pointers to the buffer. |
bytes | number of bytes in the string. |
NULL
-terminated string into UTF-16.
First, see if it's valid UTF-8, in which case just turn it directly
into UTF-16. Next, run through the colon-separated encodings in
MONO_EXTERNAL_ENCODINGS
and do an iconv
conversion on each,
returning the first successful conversion to UTF-16. If no
conversion succeeds, return NULL
.
Callers must free the returned string if not NULL
. bytes holds the number
of bytes in the returned string, not including the terminator.
mono_unicode_to_external
uni | a UTF-16 string to convert to an external representation. |
NULL
-terminated UTF-16 into either UTF-8, or the first
working item in MONO_EXTERNAL_ENCODINGS
if set. If no conversions
work, then UTF-8 is returned.
Callers must free the returned string.mono_utf8_from_external
in | pointer to the string buffer. |
NULL
-terminated string into UTF8.
First, see if it's valid UTF-8, in which case there's nothing more
to be done. Next, run through the colon-separated encodings in
MONO_EXTERNAL_ENCODINGS
and do an iconv
conversion on each,
returning the first successful conversion to UTF-8. If no
conversion succeeds, return NULL
.
Callers must free the returned string if not NULL
.
This function is identical to mono_unicode_from_external
, apart
from returning UTF-8 not UTF-16; it's handy in a few places to work
in UTF-8.
mono_marshal_alloc
mono_marshal_asany
NULL
on error.mono_marshal_free_array
mono_marshal_free_asany
mono_marshal_free
mono_marshal_get_castclass
mono_marshal_get_delegate_begin_invoke
mono_marshal_get_delegate_end_invoke
mono_marshal_get_delegate_invoke
mono_marshal_get_icall_wrapper
mono_marshal_get_isinst
mono_marshal_get_ldfld_wrapper
type | the type of the field |
This method generates a function which can be use to load a field with type type from an object. The generated function has the following signature:
type ldfld_wrapper (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, int offset)
mono_marshal_get_managed_wrapper
0
, the wrapper info will be a WrapperInfo
structure.mono_marshal_get_native_wrapper
method | The MonoMethod to wrap. |
check_exceptions | Whenever to check for pending exceptions |
Generates IL code for the pinvoke wrapper. The generated method
calls the unmanaged code in piinfo->addr
.
mono_marshal_get_proxy_cancast
mono_marshal_get_ptr_to_struct
klass | MonoClass |
PtrToStructure (IntPtr src, object structure)
mono_marshal_get_remoting_invoke_for_target
mono_marshal_get_remoting_invoke
mono_marshal_get_remoting_invoke_with_check
mono_marshal_get_runtime_invoke
function |
MonoObject *runtime_invoke (MonoObject *this_obj, void **params, MonoObject **exc, void* method)
We also catch exceptions if exc is not NULL
.
If virtual is TRUE
, then method is invoked virtually on this. This is useful since
it means that the compiled code for method does not have to be looked up
before calling the runtime invoke wrapper. In this case, the wrapper ignores
its method argument.
mono_marshal_get_stelemref
mono_marshal_get_stfld_wrapper
type | the type of the field |
This method generates a function which can be use to store a field with type type. The generated function has the following signature:
void stfld_wrapper (MonoObject *this_obj, MonoClass *klass, MonoClassField *field, int offset, type val)
mono_marshal_get_struct_to_ptr
klass | MonoClass |
Generates IL code for StructureToPtr (object structure, IntPtr ptr, bool fDeleteOld)
mono_marshal_get_synchronized_wrapper
wrapper | the generated method |
this
or the parent type.mono_marshal_get_unbox_wrapper
this
argument.mono_marshal_get_xappdomain_invoke
mono_marshal_load_type_info
Initialize klass::marshal_info
using information from metadata. This function can
recursively call itself, and the caller is responsible to avoid that by calling
mono_marshal_is_loading_type_info
beforehand.
LOCKING: Acquires the loader lock.
mono_marshal_method_from_wrapper
mono_marshal_set_last_error
This function is invoked to set the last error value from a P/Invoke call
which has SetLastError
set.
mono_marshal_type_size
The locking functions here are used by code in class.c and metadata.c to lock access to the shared hashtables inside the MonoImage.
mono_loader_lock
See docs/thread-safety.txt
for the locking strategy.
mono_loader_unlock
The internal interface of the Mono GC is the interface used between the runtime engine and the garbage collector.
mono_gc_alloc_fixed
mono_gc_free_fixed
mono_gc_make_descr_from_bitmap
mono_gc_base_init
mono_gc_invoke_finalizers
mono_gc_is_gc_thread
mono_gc_pending_finalizers
mono_gc_register_thread