2 * exception.c: Exception handling
5 * Paolo Molaro (lupus@ximian.com)
6 * Dietmar Maurer (dietmar@ximian.com)
7 * Dick Porter (dick@ximian.com)
8 * Miguel de Icaza (miguel@ximian.com)
10 * (C) 2001, 2002 Ximian, Inc.
13 #include <mono/metadata/exception.h>
14 #include <mono/metadata/object-internals.h>
15 #include <mono/metadata/appdomain.h>
19 * mono_exception_from_name:
20 * @image: the Mono image where to look for the class
21 * @name_space: the namespace for the class
24 * Creates an exception of the given namespace/name class in the
27 * Returns: the initialized exception instance.
30 mono_exception_from_name (MonoImage *image, const char *name_space,
33 return mono_exception_from_name_domain (mono_domain_get (), image, name_space, name);
37 * mono_exception_from_name_domain:
38 * @domain: Domain where the return object will be created.
39 * @image: the Mono image where to look for the class
40 * @name_space: the namespace for the class
43 * Creates an exception object of the given namespace/name class on
46 * Returns: the initialized exception instance.
49 mono_exception_from_name_domain (MonoDomain *domain, MonoImage *image,
50 const char* name_space, const char *name)
55 klass = mono_class_from_name (image, name_space, name);
57 o = mono_object_new (domain, klass);
60 mono_runtime_object_init (o);
62 return (MonoException *)o;
67 * mono_exception_from_token:
68 * @image: the Mono image where to look for the class
69 * @token: The type token of the class
71 * Creates an exception of the type given by @token.
73 * Returns: the initialized exception instance.
76 mono_exception_from_token (MonoImage *image, guint32 token)
81 klass = mono_class_get (image, token);
83 o = mono_object_new (mono_domain_get (), klass);
86 mono_runtime_object_init (o);
88 return (MonoException *)o;
92 * mono_exception_from_name_two_strings:
93 * @image: the Mono image where to look for the class
94 * @name_space: the namespace for the class
96 * @a1: first string argument to pass
97 * @a2: second string argument to pass
99 * Creates an exception from a constructor that takes two string
102 * Returns: the initialized exception instance.
105 mono_exception_from_name_two_strings (MonoImage *image, const char *name_space,
106 const char *name, MonoString *a1, MonoString *a2)
108 MonoDomain *domain = mono_domain_get ();
110 MonoMethod *method = NULL;
120 klass = mono_class_from_name (image, name_space, name);
121 o = mono_object_new (domain, klass);
124 while ((m = mono_class_get_methods (klass, &iter))) {
125 MonoMethodSignature *sig;
127 if (strcmp (".ctor", mono_method_get_name (m)))
129 sig = mono_method_signature (m);
130 if (sig->param_count != count)
133 if (sig->params [0]->type != MONO_TYPE_STRING)
135 if (count == 2 && sig->params [1]->type != MONO_TYPE_STRING)
143 mono_runtime_invoke (method, o, args, NULL);
144 return (MonoException *) o;
148 * mono_exception_from_name_msg:
149 * @image: the Mono image where to look for the class
150 * @name_space: the namespace for the class
152 * @msg: the message to embed inside the exception
154 * Creates an exception and initializes its message field.
156 * Returns: the initialized exception instance.
159 mono_exception_from_name_msg (MonoImage *image, const char *name_space,
160 const char *name, const char *msg)
164 ex = mono_exception_from_name (image, name_space, name);
167 MONO_OBJECT_SETREF (ex, message, mono_string_new (mono_object_get_domain ((MonoObject*)ex), msg));
173 * mono_get_exception_divide_by_zero:
175 * Returns: a new instance of the System.DivideByZeroException
178 mono_get_exception_divide_by_zero ()
180 return mono_exception_from_name (mono_get_corlib (), "System",
181 "DivideByZeroException");
185 * mono_get_exception_security:
187 * Returns: a new instance of the System.Security.SecurityException
190 mono_get_exception_security ()
192 return mono_exception_from_name (mono_get_corlib (), "System.Security",
193 "SecurityException");
197 * mono_get_exception_thread_abort:
199 * Returns: a new instance of the System.Threading.ThreadAbortException.
202 mono_get_exception_thread_abort ()
204 return mono_exception_from_name (mono_get_corlib (), "System.Threading",
205 "ThreadAbortException");
209 * mono_get_exception_thread_interrupted:
211 * Returns: a new instance of the System.Threading.ThreadInterruptedException.
214 mono_get_exception_thread_interrupted ()
216 return mono_exception_from_name (mono_get_corlib (), "System.Threading",
217 "ThreadInterruptedException");
221 * mono_get_exception_arithmetic:
223 * Returns: a new instance of the System.ArithmeticException.
226 mono_get_exception_arithmetic ()
228 return mono_exception_from_name (mono_get_corlib (), "System",
229 "ArithmeticException");
233 * mono_get_exception_overflow:
235 * Returns: a new instance of the System.OverflowException
238 mono_get_exception_overflow ()
240 return mono_exception_from_name (mono_get_corlib (), "System",
241 "OverflowException");
245 * mono_get_exception_null_reference:
247 * Returns: a new instance of the System.NullReferenceException
250 mono_get_exception_null_reference ()
252 return mono_exception_from_name (mono_get_corlib (), "System",
253 "NullReferenceException");
257 * mono_get_exception_execution_engine:
258 * @msg: the message to pass to the user
260 * Returns: a new instance of the System.ExecutionEngineException
263 mono_get_exception_execution_engine (const char *msg)
265 return mono_exception_from_name_msg (mono_get_corlib (), "System", "ExecutionEngineException", msg);
269 * mono_get_exception_serialization:
270 * @msg: the message to pass to the user
272 * Returns: a new instance of the System.Runtime.Serialization.SerializationException
275 mono_get_exception_serialization (const char *msg)
277 return mono_exception_from_name_msg (mono_get_corlib (), "System.Runtime.Serialization", "SerializationException", msg);
281 * mono_get_exception_invalid_cast:
283 * Returns: a new instance of the System.InvalidCastException
286 mono_get_exception_invalid_cast ()
288 return mono_exception_from_name (mono_get_corlib (), "System", "InvalidCastException");
292 * mono_get_exception_invalid_operation:
293 * @msg: the message to pass to the user
295 * Returns: a new instance of the System.InvalidOperationException
298 mono_get_exception_invalid_operation (const char *msg)
300 return mono_exception_from_name_msg (mono_get_corlib (), "System",
301 "InvalidOperationException", msg);
305 * mono_get_exception_index_out_of_range:
307 * Returns: a new instance of the System.IndexOutOfRangeException
310 mono_get_exception_index_out_of_range ()
312 return mono_exception_from_name (mono_get_corlib (), "System",
313 "IndexOutOfRangeException");
317 * mono_get_exception_array_type_mismatch:
319 * Returns: a new instance of the System.ArrayTypeMismatchException
322 mono_get_exception_array_type_mismatch ()
324 return mono_exception_from_name (mono_get_corlib (), "System",
325 "ArrayTypeMismatchException");
329 * mono_get_exception_type_load:
330 * @class_name: the name of the class that could not be loaded
331 * @assembly_name: the assembly where the class was looked up.
333 * Returns: a new instance of the System.TypeLoadException.
336 mono_get_exception_type_load (MonoString *class_name, char *assembly_name)
338 MonoString *s = assembly_name ? mono_string_new (mono_domain_get (), assembly_name) : mono_string_new (mono_domain_get (), "");
340 return mono_exception_from_name_two_strings (mono_get_corlib (), "System",
341 "TypeLoadException", class_name, s);
345 * mono_get_exception_not_implemented:
346 * @msg: the message to pass to the user
348 * Returns: a new instance of the System.NotImplementedException
351 mono_get_exception_not_implemented (const char *msg)
353 return mono_exception_from_name_msg (mono_get_corlib (), "System", "NotImplementedException", msg);
357 * mono_get_exception_not_supported:
358 * @msg: the message to pass to the user
360 * Returns: a new instance of the System.NotSupportedException
363 mono_get_exception_not_supported (const char *msg)
365 return mono_exception_from_name_msg (mono_get_corlib (), "System", "NotSupportedException", msg);
369 * mono_get_exception_missing_method:
370 * @class_name: the class where the lookup was performed.
371 * @member_name: the name of the missing method.
373 * Returns: a new instance of the System.MissingMethodException
376 mono_get_exception_missing_method (const char *class_name, const char *member_name)
378 MonoString *s1 = mono_string_new (mono_domain_get (), class_name);
379 MonoString *s2 = mono_string_new (mono_domain_get (), member_name);
381 return mono_exception_from_name_two_strings (mono_get_corlib (), "System",
382 "MissingMethodException", s1, s2);
386 * mono_get_exception_missing_field:
387 * @class_name: the class where the lookup was performed
388 * @member_name: the name of the missing method.
390 * Returns: a new instance of the System.MissingFieldException
393 mono_get_exception_missing_field (const char *class_name, const char *member_name)
395 MonoString *s1 = mono_string_new (mono_domain_get (), class_name);
396 MonoString *s2 = mono_string_new (mono_domain_get (), member_name);
398 return mono_exception_from_name_two_strings (mono_get_corlib (), "System",
399 "MissingFieldException", s1, s2);
403 * mono_get_exception_argument_null:
404 * @arg: the name of the argument that is null
406 * Returns: a new instance of the System.ArgumentNullException
409 mono_get_exception_argument_null (const char *arg)
413 ex = mono_exception_from_name (
414 mono_get_corlib (), "System", "ArgumentNullException");
417 MonoArgumentException *argex = (MonoArgumentException *)ex;
418 MONO_OBJECT_SETREF (argex, param_name, mono_string_new (mono_object_get_domain ((MonoObject*)ex), arg));
425 * mono_get_exception_argument:
426 * @arg: the name of the invalid argument.
428 * Returns: a new instance of the System.ArgumentException
431 mono_get_exception_argument (const char *arg, const char *msg)
435 ex = mono_exception_from_name_msg (
436 mono_get_corlib (), "System", "ArgumentException", msg);
439 MonoArgumentException *argex = (MonoArgumentException *)ex;
440 MONO_OBJECT_SETREF (argex, param_name, mono_string_new (mono_object_get_domain ((MonoObject*)ex), arg));
447 * mono_get_exception_argument_out_of_range:
448 * @arg: the name of the out of range argument.
450 * Returns: a new instance of the System.ArgumentOutOfRangeException
453 mono_get_exception_argument_out_of_range (const char *arg)
457 ex = mono_exception_from_name (
458 mono_get_corlib (), "System", "ArgumentOutOfRangeException");
461 MonoArgumentException *argex = (MonoArgumentException *)ex;
462 MONO_OBJECT_SETREF (argex, param_name, mono_string_new (mono_object_get_domain ((MonoObject*)ex), arg));
469 * mono_get_exception_thread_state:
470 * @msg: the message to present to the user
472 * Returns: a new instance of the System.Threading.ThreadStateException
475 mono_get_exception_thread_state (const char *msg)
477 return mono_exception_from_name_msg (
478 mono_get_corlib (), "System.Threading", "ThreadStateException", msg);
482 * mono_get_exception_io:
483 * @msg: the message to present to the user
485 * Returns: a new instance of the System.IO.IOException
488 mono_get_exception_io (const char *msg)
490 return mono_exception_from_name_msg (
491 mono_get_corlib (), "System.IO", "IOException", msg);
495 * mono_get_exception_file_not_found:
496 * @fname: the name of the file not found.
498 * Returns: a new instance of the System.IO.FileNotFoundException
501 mono_get_exception_file_not_found (MonoString *fname)
503 return mono_exception_from_name_two_strings (
504 mono_get_corlib (), "System.IO", "FileNotFoundException", fname, fname);
508 * mono_get_exception_file_not_found2:
509 * @msg: an informative message for the user.
510 * @fname: the name of the file not found.
512 * Returns: a new instance of the System.IO.FileNotFoundException
515 mono_get_exception_file_not_found2 (const char *msg, MonoString *fname)
517 MonoString *s = msg ? mono_string_new (mono_domain_get (), msg) : NULL;
519 return mono_exception_from_name_two_strings (
520 mono_get_corlib (), "System.IO", "FileNotFoundException", s, fname);
524 * mono_get_exception_type_initialization:
525 * @type_name: the name of the type that failed to initialize.
526 * @inner: the inner exception.
528 * Returns: a new instance of the System.TypeInitializationException
531 mono_get_exception_type_initialization (const gchar *type_name, MonoException *inner)
539 klass = mono_class_from_name (mono_get_corlib (), "System", "TypeInitializationException");
542 mono_class_init (klass);
544 /* TypeInitializationException only has 1 ctor with 2 args */
546 while ((method = mono_class_get_methods (klass, &iter))) {
547 if (!strcmp (".ctor", mono_method_get_name (method)) && mono_method_signature (method)->param_count == 2)
554 args [0] = mono_string_new (mono_domain_get (), type_name);
557 exc = mono_object_new (mono_domain_get (), klass);
558 mono_runtime_invoke (method, exc, args, NULL);
560 return (MonoException *) exc;
564 * mono_get_exception_synchronization_lock:
565 * @inner: the inner exception.
567 * Returns: a new instance of the System.TypeInitializationException
570 mono_get_exception_synchronization_lock (const char *msg)
572 return mono_exception_from_name_msg (mono_get_corlib (), "System.Threading", "SynchronizationLockException", msg);
576 * mono_get_exception_cannot_unload_appdomain:
577 * @inner: the inner exception.
579 * Returns: a new instance of the System.CannotUnloadAppDomainException
582 mono_get_exception_cannot_unload_appdomain (const char *msg)
584 return mono_exception_from_name_msg (mono_get_corlib (), "System", "CannotUnloadAppDomainException", msg);
588 * mono_get_exception_appdomain_unloaded
590 * Returns: a new instance of the System.AppDomainUnloadedException
593 mono_get_exception_appdomain_unloaded (void)
595 return mono_exception_from_name (mono_get_corlib (), "System", "AppDomainUnloadedException");
599 * mono_get_exception_bad_image_format:
600 * @msg: an informative message for the user.
602 * Returns: a new instance of the System.BadImageFormatException
605 mono_get_exception_bad_image_format (const char *msg)
607 return mono_exception_from_name_msg (mono_get_corlib (), "System", "BadImageFormatException", msg);
611 * mono_get_exception_bad_image_format2:
612 * @msg: an informative message for the user.
613 * @fname: The full name of the file with the invalid image.
615 * Returns: a new instance of the System.BadImageFormatException
618 mono_get_exception_bad_image_format2 (const char *msg, MonoString *fname)
620 MonoString *s = msg ? mono_string_new (mono_domain_get (), msg) : NULL;
622 return mono_exception_from_name_two_strings (
623 mono_get_corlib (), "System", "BadImageFormatException", s, fname);
627 * mono_get_exception_stack_overflow:
629 * Returns: a new instance of the System.StackOverflowException
632 mono_get_exception_stack_overflow (void)
634 return mono_exception_from_name (mono_get_corlib (), "System", "StackOverflowException");
638 * mono_get_exception_out_of_memory:
640 * Returns: a new instance of the System.OutOfMemoryException
643 mono_get_exception_out_of_memory (void)
645 return mono_exception_from_name (mono_get_corlib (), "System", "OutOfMemoryException");
649 * mono_get_exception_reflection_type_load:
650 * @types: an array of types that were defined in the moduled loaded.
651 * @exceptions: an array of exceptions that were thrown during the type loading.
653 * Returns: a new instance of the System.Reflection.ReflectionTypeLoadException
656 mono_get_exception_reflection_type_load (MonoArray *types, MonoArray *exceptions)
663 klass = mono_class_from_name (mono_get_corlib (), "System.Reflection", "ReflectionTypeLoadException");
665 mono_class_init (klass);
667 method = mono_class_get_method_from_name (klass, ".ctor", 2);
671 args [1] = exceptions;
673 exc = mono_object_new (mono_domain_get (), klass);
674 mono_runtime_invoke (method, exc, args, NULL);
676 return (MonoException *) exc;