1 files changed, 77 insertions, 0 deletions
diff --git a/src/loris/lorisException_pi.h b/src/loris/lorisException_pi.h
new file mode 100644
index 0000000..8dddc2a
--- /dev/null
+++ b/src/loris/lorisException_pi.h
@@ -0,0 +1,77 @@
+#ifndef INCLUDE_LORISEXCEPTION_PI_H
+#define INCLUDE_LORISEXCEPTION_PI_H
+/*
+ * This is the Loris C++ Class Library, implementing analysis, 
+ * manipulation, and synthesis of digitized sounds using the Reassigned 
+ * Bandwidth-Enhanced Additive Sound Model.
+ *
+ * Loris is Copyright (c) 1999-2010 by Kelly Fitz and Lippold Haken
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY, without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ *
+ *
+ *	lorisException_pi.h
+ *
+ *	A component of the C-linkable procedural interface for Loris. 
+ *
+ *	Main components of the Loris procedural interface:
+ *	- object interfaces - Analyzer, Synthesizer, Partial, PartialIterator, 
+ *		PartialList, PartialListIterator, Breakpoint, BreakpointEnvelope,  
+ *		and SampleVector need to be (opaque) objects in the interface, 
+ * 		either because they hold state (e.g. Analyzer) or because they are 
+ *		fundamental data types (e.g. Partial), so they need a procedural 
+ *		interface to their member functions. All these things need to be 
+ *		opaque pointers for the benefit of C.
+ *	- non-object-based procedures - other classes in Loris are not so stateful,
+ *		and have sufficiently narrow functionality that they need only 
+ *		procedures, and no object representation.
+ *	- utility functions - some procedures that are generally useful but are
+ *		not yet part of the Loris core are also defined.
+ *	- notification and exception handlers - all exceptions must be caught and
+ *		handled internally, clients can specify an exception handler and 
+ *		a notification function (the default one in Loris uses printf()).
+ *
+ *	This file declares the exception handling functions used in the
+ *	Loris procedural interface.
+ *
+ * Kelly Fitz, 10 Nov 2000
+ * loris@cerlsoundgroup.org
+ *
+ * http://www.cerlsoundgroup.org/Loris/
+ *
+ */
+ 
+#include "LorisExceptions.h"
+#include <string>
+
+//	forward-declare local exception handler:
+void handleException( const char * s );
+
+/* ---------------------------------------------------------------- */
+/*		class NullPointer
+/*
+/*	Exception subclass for catching NULL pointers:
+ */
+class NullPointer : public Loris::Exception
+{
+public: 
+	NullPointer( const std::string & str, const std::string & where = "" ) : 
+		Exception( std::string("NULL pointer exception -- ").append( str ), where ) {}
+};	//	end of class NullPointer
+
+#define ThrowIfNull(ptr) if ((ptr)==NULL) Throw( NullPointer, #ptr );	
+
+
+#endif	/* ndef INCLUDE_LORISEXCEPTION_PI_H */