2006-08-17 Zoltan Varga <vargaz@gmail.com>
[mono.git] / mono / metadata / exception.c
index 4197227f39a8888bf558e61581770bd0cb22493a..fa1d6126ac8e18c85ccf058dbd1a12cc05a50b28 100644 (file)
@@ -21,7 +21,8 @@
  * @name_space: the namespace for the class
  * @name: class name
  *
- * Creates an exception of the given namespace/name class.
+ * Creates an exception of the given namespace/name class in the
+ * current domain.
  *
  * Returns: the initialized exception instance.
  */
@@ -32,6 +33,18 @@ mono_exception_from_name (MonoImage *image, const char *name_space,
        return mono_exception_from_name_domain (mono_domain_get (), image, name_space, name);
 }
 
+/**
+ * mono_exception_from_name_domain:
+ * @domain: Domain where the return object will be created.
+ * @image: the Mono image where to look for the class
+ * @name_space: the namespace for the class
+ * @name: class name
+ *
+ * Creates an exception object of the given namespace/name class on
+ * the given domain.
+ *
+ * Returns: the initialized exception instance.
+ */
 MonoException *
 mono_exception_from_name_domain (MonoDomain *domain, MonoImage *image, 
                                 const char* name_space, const char *name)
@@ -49,6 +62,32 @@ mono_exception_from_name_domain (MonoDomain *domain, MonoImage *image,
        return (MonoException *)o;
 }
 
+
+/**
+ * mono_exception_from_token:
+ * @image: the Mono image where to look for the class
+ * @token: The type token of the class
+ *
+ * Creates an exception of the type given by @token.
+ *
+ * Returns: the initialized exception instance.
+ */
+MonoException *
+mono_exception_from_token (MonoImage *image, guint32 token)
+{
+       MonoClass *klass;
+       MonoObject *o;
+
+       klass = mono_class_get (image, token);
+
+       o = mono_object_new (mono_domain_get (), klass);
+       g_assert (o != NULL);
+       
+       mono_runtime_object_init (o);
+
+       return (MonoException *)o;
+}
+
 /**
  * mono_exception_from_name_two_strings:
  * @image: the Mono image where to look for the class
@@ -70,8 +109,10 @@ mono_exception_from_name_two_strings (MonoImage *image, const char *name_space,
        MonoClass *klass;
        MonoMethod *method = NULL;
        MonoObject *o;
-       int i, count = 1;
+       int count = 1;
        gpointer args [2];
+       gpointer iter;
+       MonoMethod *m;
 
        if (a2 != NULL)
                count++;
@@ -79,12 +120,13 @@ mono_exception_from_name_two_strings (MonoImage *image, const char *name_space,
        klass = mono_class_from_name (image, name_space, name);
        o = mono_object_new (domain, klass);
 
-       for (i = 0; i < klass->method.count; ++i) {
+       iter = NULL;
+       while ((m = mono_class_get_methods (klass, &iter))) {
                MonoMethodSignature *sig;
                
-               if (strcmp (".ctor", mono_method_get_name (klass->methods [i])))
+               if (strcmp (".ctor", mono_method_get_name (m)))
                        continue;
-               sig = mono_method_signature (klass->methods [i]);
+               sig = mono_method_signature (m);
                if (sig->param_count != count)
                        continue;
 
@@ -92,7 +134,7 @@ mono_exception_from_name_two_strings (MonoImage *image, const char *name_space,
                        continue;
                if (count == 2 && sig->params [1]->type != MONO_TYPE_STRING)
                        continue;
-               method = klass->methods [i];
+               method = m;
        }
 
        args [0] = a1;
@@ -114,21 +156,23 @@ mono_exception_from_name_two_strings (MonoImage *image, const char *name_space,
  */
 MonoException *
 mono_exception_from_name_msg (MonoImage *image, const char *name_space,
-                             const char *name, const guchar *msg)
+                             const char *name, const char *msg)
 {
        MonoException *ex;
-       MonoDomain *domain;
 
        ex = mono_exception_from_name (image, name_space, name);
 
-       domain = ((MonoObject *)ex)->vtable->domain;
-
        if (msg)
-               ex->message = mono_string_new (domain, msg);
+               MONO_OBJECT_SETREF (ex, message, mono_string_new (mono_object_get_domain ((MonoObject*)ex), msg));
 
        return ex;
 }
 
+/**
+ * mono_get_exception_divide_by_zero:
+ *
+ * Returns: a new instance of the System.DivideByZeroException
+ */
 MonoException *
 mono_get_exception_divide_by_zero ()
 {
@@ -136,13 +180,23 @@ mono_get_exception_divide_by_zero ()
                                         "DivideByZeroException");
 }
 
+/**
+ * mono_get_exception_security:
+ *
+ * Returns: a new instance of the System.Security.SecurityException
+ */
 MonoException *
 mono_get_exception_security ()
 {
-       return mono_exception_from_name (mono_get_corlib (), "System",
+       return mono_exception_from_name (mono_get_corlib (), "System.Security",
                                         "SecurityException");
 }
 
+/**
+ * mono_get_exception_thread_abort:
+ *
+ * Returns: a new instance of the System.Threading.ThreadAbortException.
+ */
 MonoException *
 mono_get_exception_thread_abort ()
 {
@@ -150,6 +204,11 @@ mono_get_exception_thread_abort ()
                                         "ThreadAbortException");
 }
 
+/**
+ * mono_get_exception_arithmetic:
+ *
+ * Returns: a new instance of the System.ArithmeticException.
+ */
 MonoException *
 mono_get_exception_arithmetic ()
 {
@@ -157,6 +216,11 @@ mono_get_exception_arithmetic ()
                                         "ArithmeticException");
 }
 
+/**
+ * mono_get_exception_overflow:
+ *
+ * Returns: a new instance of the System.OverflowException
+ */
 MonoException *
 mono_get_exception_overflow ()
 {
@@ -164,6 +228,11 @@ mono_get_exception_overflow ()
                                         "OverflowException");
 }
 
+/**
+ * mono_get_exception_null_reference:
+ *
+ * Returns: a new instance of the System.NullReferenceException
+ */
 MonoException *
 mono_get_exception_null_reference ()
 {
@@ -171,27 +240,59 @@ mono_get_exception_null_reference ()
                                         "NullReferenceException");
 }
 
+/**
+ * mono_get_exception_execution_engine:
+ * @msg: the message to pass to the user
+ *
+ * Returns: a new instance of the System.ExecutionEngineException
+ */
 MonoException *
-mono_get_exception_execution_engine (const guchar *msg)
+mono_get_exception_execution_engine (const char *msg)
 {
-       return mono_exception_from_name_msg (mono_get_corlib (), "System",
-                                                                                "ExecutionEngineException", msg);
+       return mono_exception_from_name_msg (mono_get_corlib (), "System", "ExecutionEngineException", msg);
 }
 
+/**
+ * mono_get_exception_serialization:
+ * @msg: the message to pass to the user
+ *
+ * Returns: a new instance of the System.Runtime.Serialization.SerializationException
+ */
 MonoException *
-mono_get_exception_serialization (const guchar *msg)
+mono_get_exception_serialization (const char *msg)
 {
-       return mono_exception_from_name_msg (mono_get_corlib (), "System.Runtime.Serialization",
-                                                                                "SerializationException", msg);
+       return mono_exception_from_name_msg (mono_get_corlib (), "System.Runtime.Serialization", "SerializationException", msg);
 }
 
+/**
+ * mono_get_exception_invalid_cast:
+ *
+ * Returns: a new instance of the System.InvalidCastException
+ */
 MonoException *
 mono_get_exception_invalid_cast ()
 {
-       return mono_exception_from_name (mono_get_corlib (), "System",
-                                        "InvalidCastException");
+       return mono_exception_from_name (mono_get_corlib (), "System", "InvalidCastException");
+}
+
+/**
+ * mono_get_exception_invalid_operation:
+ * @msg: the message to pass to the user
+ *
+ * Returns: a new instance of the System.InvalidOperationException
+ */
+MonoException *
+mono_get_exception_invalid_operation (const char *msg)
+{
+       return mono_exception_from_name_msg (mono_get_corlib (), "System",
+                                       "InvalidOperationException", msg);
 }
 
+/**
+ * mono_get_exception_index_out_of_range:
+ *
+ * Returns: a new instance of the System.IndexOutOfRangeException
+ */
 MonoException *
 mono_get_exception_index_out_of_range ()
 {
@@ -199,6 +300,11 @@ mono_get_exception_index_out_of_range ()
                                         "IndexOutOfRangeException");
 }
 
+/**
+ * mono_get_exception_array_type_mismatch:
+ *
+ * Returns: a new instance of the System.ArrayTypeMismatchException
+ */
 MonoException *
 mono_get_exception_array_type_mismatch ()
 {
@@ -206,110 +312,178 @@ mono_get_exception_array_type_mismatch ()
                                         "ArrayTypeMismatchException");
 }
 
+/**
+ * mono_get_exception_type_load:
+ * @class_name: the name of the class that could not be loaded
+ * @assembly_name: the assembly where the class was looked up.
+ *
+ * Returns: a new instance of the System.TypeLoadException.
+ */
 MonoException *
-mono_get_exception_type_load (MonoString *type_name)
+mono_get_exception_type_load (MonoString *class_name, char *assembly_name)
 {
-       MonoTypeLoadException *exc;
-       
-       exc = (MonoTypeLoadException *) mono_exception_from_name (mono_get_corlib (),
-                                       "System",
-                                       "TypeLoadException");
+       MonoString *s = assembly_name ? mono_string_new (mono_domain_get (), assembly_name) : mono_string_new (mono_domain_get (), "");
 
-       exc->type_name = type_name;
-       return (MonoException *) exc;
+       return mono_exception_from_name_two_strings (mono_get_corlib (), "System",
+                                                    "TypeLoadException", class_name, s);
 }
 
+/**
+ * mono_get_exception_not_implemented:
+ * @msg: the message to pass to the user
+ *
+ * Returns: a new instance of the System.NotImplementedException
+ */
 MonoException *
-mono_get_exception_not_implemented (const guchar *msg)
+mono_get_exception_not_implemented (const char *msg)
 {
-       MonoException *ex;
-       MonoDomain *domain;
-       
-       ex = mono_exception_from_name (mono_get_corlib (), "System",
-                                      "NotImplementedException");
-       domain = ((MonoObject *)ex)->vtable->domain;
+       return mono_exception_from_name_msg (mono_get_corlib (), "System", "NotImplementedException", msg);
+}
 
-       if (msg)
-               ex->message = mono_string_new (domain, msg);
+/**
+ * mono_get_exception_not_supported:
+ * @msg: the message to pass to the user
+ *
+ * Returns: a new instance of the System.NotSupportedException
+ */
+MonoException *
+mono_get_exception_not_supported (const char *msg)
+{
+       return mono_exception_from_name_msg (mono_get_corlib (), "System", "NotSupportedException", msg);
+}
 
-       return ex;
+/**
+ * mono_get_exception_missing_method:
+ * @class_name: the class where the lookup was performed.
+ * @member_name: the name of the missing method.
+ *
+ * Returns: a new instance of the System.MissingMethodException
+ */
+MonoException *
+mono_get_exception_missing_method (const char *class_name, const char *member_name)
+{
+       MonoString *s1 = mono_string_new (mono_domain_get (), class_name);
+       MonoString *s2 = mono_string_new (mono_domain_get (), member_name);
+
+       return mono_exception_from_name_two_strings (mono_get_corlib (), "System",
+                                                    "MissingMethodException", s1, s2);
 }
 
+/**
+ * mono_get_exception_missing_field:
+ * @class_name: the class where the lookup was performed
+ * @member_name: the name of the missing method.
+ *
+ * Returns: a new instance of the System.MissingFieldException
+ */
 MonoException *
-mono_get_exception_missing_method ()
+mono_get_exception_missing_field (const char *class_name, const char *member_name)
 {
-       return mono_exception_from_name (mono_get_corlib (), "System",
-                                        "MissingMethodException");
+       MonoString *s1 = mono_string_new (mono_domain_get (), class_name);
+       MonoString *s2 = mono_string_new (mono_domain_get (), member_name);
+
+       return mono_exception_from_name_two_strings (mono_get_corlib (), "System",
+                                                    "MissingFieldException", s1, s2);
 }
 
+/**
+ * mono_get_exception_argument_null:
+ * @arg: the name of the argument that is null
+ *
+ * Returns: a new instance of the System.ArgumentNullException
+ */
 MonoException*
-mono_get_exception_argument_null (const guchar *arg)
+mono_get_exception_argument_null (const char *arg)
 {
        MonoException *ex;
-       MonoDomain *domain;
 
        ex = mono_exception_from_name ( 
                mono_get_corlib (), "System", "ArgumentNullException");
 
-       domain = ((MonoObject *)ex)->vtable->domain;
-
-       if (arg)
-               ((MonoArgumentException *)ex)->param_name =
-                       mono_string_new (domain, arg);
+       if (arg) {
+               MonoArgumentException *argex = (MonoArgumentException *)ex;
+               MONO_OBJECT_SETREF (argex, param_name, mono_string_new (mono_object_get_domain ((MonoObject*)ex), arg));
+       }
        
        return ex;
 }
 
+/**
+ * mono_get_exception_argument:
+ * @arg: the name of the invalid argument.
+ *
+ * Returns: a new instance of the System.ArgumentException
+ */
 MonoException *
-mono_get_exception_argument (const guchar *arg, const guchar *msg)
+mono_get_exception_argument (const char *arg, const char *msg)
 {
        MonoException *ex;
-       MonoDomain *domain;
 
        ex = mono_exception_from_name_msg (
                mono_get_corlib (), "System", "ArgumentException", msg);
 
-       domain = ((MonoObject *)ex)->vtable->domain;
-
-       if (arg)
-               ((MonoArgumentException *)ex)->param_name =
-                       mono_string_new (domain, arg);
+       if (arg) {
+               MonoArgumentException *argex = (MonoArgumentException *)ex;
+               MONO_OBJECT_SETREF (argex, param_name, mono_string_new (mono_object_get_domain ((MonoObject*)ex), arg));
+       }
        
        return ex;
 }
 
+/**
+ * mono_get_exception_argument_out_of_range:
+ * @arg: the name of the out of range argument.
+ *
+ * Returns: a new instance of the System.ArgumentOutOfRangeException
+ */
 MonoException *
-mono_get_exception_argument_out_of_range (const guchar *arg)
+mono_get_exception_argument_out_of_range (const char *arg)
 {
        MonoException *ex;
-       MonoDomain *domain;
 
        ex = mono_exception_from_name (
                mono_get_corlib (), "System", "ArgumentOutOfRangeException");
 
-       domain = ((MonoObject *)ex)->vtable->domain;
-
-       if (arg)
-               ((MonoArgumentException *)ex)->param_name =
-                       mono_string_new (domain, arg);
+       if (arg) {
+               MonoArgumentException *argex = (MonoArgumentException *)ex;
+               MONO_OBJECT_SETREF (argex, param_name, mono_string_new (mono_object_get_domain ((MonoObject*)ex), arg));
+       }
        
        return ex;
 }
 
+/**
+ * mono_get_exception_thread_state:
+ * @msg: the message to present to the user
+ *
+ * Returns: a new instance of the System.Threading.ThreadStateException
+ */
 MonoException *
-mono_get_exception_thread_state (const guchar *msg)
+mono_get_exception_thread_state (const char *msg)
 {
        return mono_exception_from_name_msg (
                mono_get_corlib (), "System.Threading", "ThreadStateException", msg);
 }
 
+/**
+ * mono_get_exception_io:
+ * @msg: the message to present to the user
+ *
+ * Returns: a new instance of the System.IO.IOException
+ */
 MonoException *
-mono_get_exception_io (const guchar *msg)
+mono_get_exception_io (const char *msg)
 {
        return mono_exception_from_name_msg ( 
                mono_get_corlib (), "System.IO", "IOException", msg);
 }
 
+/**
+ * mono_get_exception_file_not_found:
+ * @fname: the name of the file not found.
+ *
+ * Returns: a new instance of the System.IO.FileNotFoundException
+ */
 MonoException *
 mono_get_exception_file_not_found (MonoString *fname)
 {
@@ -317,6 +491,29 @@ mono_get_exception_file_not_found (MonoString *fname)
                mono_get_corlib (), "System.IO", "FileNotFoundException", fname, fname);
 }
 
+/**
+ * mono_get_exception_file_not_found2:
+ * @msg: an informative message for the user.
+ * @fname: the name of the file not found.
+ *
+ * Returns: a new instance of the System.IO.FileNotFoundException
+ */
+MonoException *
+mono_get_exception_file_not_found2 (const char *msg, MonoString *fname)
+{
+       MonoString *s = mono_string_new (mono_domain_get (), msg);
+
+       return mono_exception_from_name_two_strings (
+               mono_get_corlib (), "System.IO", "FileNotFoundException", s, fname);
+}
+
+/**
+ * mono_get_exception_type_initialization:
+ * @type_name: the name of the type that failed to initialize.
+ * @inner: the inner exception.
+ *
+ * Returns: a new instance of the System.TypeInitializationException
+ */
 MonoException *
 mono_get_exception_type_initialization (const gchar *type_name, MonoException *inner)
 {
@@ -324,7 +521,7 @@ mono_get_exception_type_initialization (const gchar *type_name, MonoException *i
        gpointer args [2];
        MonoObject *exc;
        MonoMethod *method;
-       gint i;
+       gpointer iter;
 
        klass = mono_class_from_name (mono_get_corlib (), "System", "TypeInitializationException");
        g_assert (klass);
@@ -332,8 +529,8 @@ mono_get_exception_type_initialization (const gchar *type_name, MonoException *i
        mono_class_init (klass);
 
        /* TypeInitializationException only has 1 ctor with 2 args */
-       for (i = 0; i < klass->method.count; ++i) {
-               method = klass->methods [i];
+       iter = NULL;
+       while ((method = mono_class_get_methods (klass, &iter))) {
                if (!strcmp (".ctor", mono_method_get_name (method)) && mono_method_signature (method)->param_count == 2)
                        break;
                method = NULL;
@@ -350,32 +547,91 @@ mono_get_exception_type_initialization (const gchar *type_name, MonoException *i
        return (MonoException *) exc;
 }
 
+/**
+ * mono_get_exception_synchronization_lock:
+ * @inner: the inner exception.
+ *
+ * Returns: a new instance of the System.TypeInitializationException
+ */
 MonoException *
-mono_get_exception_synchronization_lock (const guchar *msg)
+mono_get_exception_synchronization_lock (const char *msg)
 {
        return mono_exception_from_name_msg (mono_get_corlib (), "System.Threading", "SynchronizationLockException", msg);
 }
 
+/**
+ * mono_get_exception_cannot_unload_appdomain:
+ * @inner: the inner exception.
+ *
+ * Returns: a new instance of the System.CannotUnloadAppDomainException
+ */
 MonoException *
-mono_get_exception_cannot_unload_appdomain (const guchar *msg)
+mono_get_exception_cannot_unload_appdomain (const char *msg)
 {
        return mono_exception_from_name_msg (mono_get_corlib (), "System", "CannotUnloadAppDomainException", msg);
 }
 
+/**
+ * mono_get_exception_appdomain_unloaded
+ *
+ * Returns: a new instance of the System.AppDomainUnloadedException
+ */
 MonoException *
 mono_get_exception_appdomain_unloaded (void)
 {
        return mono_exception_from_name (mono_get_corlib (), "System", "AppDomainUnloadedException");
 }
 
+/**
+ * mono_get_exception_bad_image_format:
+ * @msg: an informative message for the user.
+ *
+ * Returns: a new instance of the System.BadImageFormatException
+ */
 MonoException *
-mono_get_exception_bad_image_format (const guchar *msg)
+mono_get_exception_bad_image_format (const char *msg)
 {
        return mono_exception_from_name_msg (mono_get_corlib (), "System", "BadImageFormatException", msg);
 }      
 
+/**
+ * mono_get_exception_stack_overflow:
+ *
+ * Returns: a new instance of the System.StackOverflowException
+ */
 MonoException *
 mono_get_exception_stack_overflow (void)
 {
        return mono_exception_from_name (mono_get_corlib (), "System", "StackOverflowException");       
 }
+
+/**
+ * mono_get_exception_reflection_type_load:
+ * @types: an array of types that were defined in the moduled loaded.
+ * @exceptions: an array of exceptions that were thrown during the type loading.
+ *
+ * Returns: a new instance of the System.Reflection.ReflectionTypeLoadException
+ */
+MonoException *
+mono_get_exception_reflection_type_load (MonoArray *types, MonoArray *exceptions)
+{
+       MonoClass *klass;
+       gpointer args [2];
+       MonoObject *exc;
+       MonoMethod *method;
+
+       klass = mono_class_from_name (mono_get_corlib (), "System.Reflection", "ReflectionTypeLoadException");
+       g_assert (klass);
+       mono_class_init (klass);
+
+       method = mono_class_get_method_from_name (klass, ".ctor", 2);
+       g_assert (method);
+
+       args [0] = types;
+       args [1] = exceptions;
+
+       exc = mono_object_new (mono_domain_get (), klass);
+       mono_runtime_invoke (method, exc, args, NULL);
+
+       return (MonoException *) exc;
+}