git.sesse.net Git - vlc/blob - 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         public NativeException ()
 105         {
 106             LibVLC.ExceptionInit (this);
 107         }
 108
 109         /**
 110          * Throws a managed exception if LibVLC has returned a native
 111          * unmanaged exception. Clears the native exception.
 112          */
 113         public void Raise ()
 114         {
 115             if (raised == 0)
 116                 return;
 117
 118             string msg = U8String.FromNative (message);
 119             try
 120             {
 121                 if (msg != null)
 122                     throw new VLCException (code, msg);
 123                 else
 124                     throw new VLCException (code);
 125             }
 126             finally
 127             {
 128                 LibVLC.ExceptionClear (this);
 129             }
 130         }
 131
 132         /** IDisposable implementation. */
 133         public void Dispose ()
 134         {
 135             Dispose (true);
 136             GC.SuppressFinalize (this);
 137         }
 138
 139         ~NativeException ()
 140         {
 141             Dispose (false);
 142         }
 143
 144         private void Dispose (bool disposing)
 145         {
 146             LibVLC.ExceptionClear (this);
 147         }
 148     };
 149 };