Changes in exceptions, to distinguish between catching and throwing exceptions. README.md of examples is doen for now

1 files changed, 64 insertions, 0 deletions

diff --git a/Examples/Exceptions/ExceptionCatch/exceptionCatch.cpp b/Examples/Exceptions/ExceptionCatch/exceptionCatch.cpp
new file mode 100644
index 0000000..1b95277
--- /dev/null
+++ b/Examples/Exceptions/ExceptionCatch/exceptionCatch.cpp
@@ -0,0 +1,64 @@
+/**
+ *	exception.cpp
+ * 	@author Jasper van Eck<jasper.vaneck@copernica.com>
+ * 
+ * 	An example file to show the working of a C++ function that 
+ * 	takes a callback function as parameter, and handles the 
+ * 	exception thrown by the callback function.
+ */
+
+/**
+ * 	Libraries used.
+ */
+#include <phpcpp.h>
+
+/**
+ *  Namespace to use
+ */
+using namespace std;
+
+/**
+ * 	my_catch_exception_function()
+ * 	Catches the exception thrown by the PHP callback function.
+ * 	@param		Php::Parameters
+ */
+void my_catch_exception_function(Php::Parameters &params)
+{
+    // the first parameter should be a callback
+    Php::Value callback = params[0];
+
+    // this must be a callable type
+    if (!callback.isCallable()) throw Php::Exception("Parameter 0 is not a function");
+
+    // we're going to call a function that could throw an exception, start a 
+    // try-catch block to deal with that
+    try
+    {
+        // call the function
+        callback("some","example","parameters");
+    }
+    catch (Php::Exception &exception)
+    {
+        // @todo handle the exception that was thrown from PHP space
+    }
+}
+
+
+// Symbols are exported according to the "C" language
+extern "C" 
+{
+	// export the "get_module" function that will be called by the Zend engine
+	PHPCPP_EXPORT void *get_module()
+	{
+		// create extension
+        static Php::Extension extension("my_exception_catch","1.0");
+        
+        // add function to extension
+        extension.add("my_catch_exception_function", my_catch_exception_function, {
+			Php::ByVal("callback", Php::callableType);
+			});
+		
+		// return the extension module
+		return extension.module();
+	}
+}