Cleanup IDisposable support
[vlc.git] / bindings / cil / src / exception.cs
1 /**
2  * @file exception.cs
3  * @brief LibVLC exceptions
4  * @ingroup API
5  */
6
7 /**********************************************************************
8  *  Copyright (C) 2007-2009 RĂ©mi Denis-Courmont.                      *
9  *  This program is free software; you can redistribute and/or modify *
10  *  it under the terms of the GNU General Public License as published *
11  *  by the Free Software Foundation; version 2 of the license, or (at *
12  *  your option) any later version.                                   *
13  *                                                                    *
14  *  This program is distributed in the hope that it will be useful,   *
15  *  but WITHOUT ANY WARRANTY; without even the implied warranty of    *
16  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.              *
17  *  See the GNU General Public License for more details.              *
18  *                                                                    *
19  *  You should have received a copy of the GNU General Public License *
20  *  along with this program; if not, you can get it from:             *
21  *  http://www.gnu.org/copyleft/gpl.html                              *
22  **********************************************************************/
23
24 using System;
25 using System.Runtime.InteropServices;
26
27 namespace VideoLAN.LibVLC
28 {
29     /**
30      * @brief VLCException: base class for LibVLC exceptions
31      * @ingroup API
32      */
33     public class VLCException : Exception
34     {
35         int code;
36         /**
37          * VLC exception code.
38          */
39         public int Code
40         {
41             get
42             {
43                 return code;
44             }
45         }
46
47         /**
48          * Creates a managed VLC exception.
49          */
50         public VLCException ()
51         {
52         }
53
54         /**
55          * Creates a managed VLC exception.
56          * @param message exception error message
57          */
58         public VLCException (string message)
59             : base (message)
60         {
61         }
62
63         /**
64          * Creates a managed VLC exception wrapping another exception.
65          * @param message exception error message
66          * @param inner inner wrapped exception
67          */
68         public VLCException (string message, Exception inner)
69            : base (message, inner)
70         {
71         }
72
73         /**
74          * Creates a VLC exception
75          * @param code VLC exception code
76          * @param message VLC exception message
77          */
78         public VLCException (int code, string message) : base (message)
79         {
80             this.code = code;
81         }
82
83         /**
84          * Creates a VLC exception
85          * @param code VLC exception code
86          */
87         public VLCException (int code) : base ()
88         {
89             this.code = code;
90         }
91     };
92
93     /**
94      * @brief NativeException: CIL representation for libvlc_exception_t.
95      * @ingroup Internals
96      */
97     [StructLayout (LayoutKind.Sequential)]
98     public sealed class NativeException : IDisposable
99     {
100         int raised;
101         int code;
102         IntPtr message;
103
104         [DllImport ("libvlc.dll", EntryPoint="libvlc_exception_init")]
105         private static extern void Init (NativeException e);
106         [DllImport ("libvlc.dll", EntryPoint="libvlc_exception_clear")]
107         private static extern void Clear (NativeException e);
108
109         public NativeException ()
110         {
111             Init (this);
112         }
113
114         /**
115          * Throws a managed exception if LibVLC has returned a native
116          * unmanaged exception. Clears the native exception.
117          */
118         public void Raise ()
119         {
120             if (raised == 0)
121                 return;
122
123             string msg = U8String.FromNative (message);
124             try
125             {
126                 if (msg != null)
127                     throw new VLCException (code, msg);
128                 else
129                     throw new VLCException (code);
130             }
131             finally
132             {
133                 Clear (this);
134             }
135         }
136
137         /** IDisposable implementation. */
138         public void Dispose ()
139         {
140             Dispose (true);
141             GC.SuppressFinalize (this);
142         }
143
144         ~NativeException ()
145         {
146             Dispose (false);
147         }
148
149         private void Dispose (bool disposing)
150         {
151             Clear (this);
152         }
153     };
154 };