aboutsummaryrefslogtreecommitdiffstats
path: root/deps/sol2/docs/source/api/error.rst
diff options
context:
space:
mode:
Diffstat (limited to 'deps/sol2/docs/source/api/error.rst')
-rw-r--r--deps/sol2/docs/source/api/error.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/deps/sol2/docs/source/api/error.rst b/deps/sol2/docs/source/api/error.rst
new file mode 100644
index 0000000..0548648
--- /dev/null
+++ b/deps/sol2/docs/source/api/error.rst
@@ -0,0 +1,21 @@
+error
+=====
+*the single error/exception type*
+
+
+.. code-block:: cpp
+
+ class error : public std::runtime_error {
+ public:
+ error(const std::string& str): std::runtime_error("lua: error: " + str) {}
+ };
+
+
+.. note::
+
+ Please do not throw this error type yourself. It belongs to the library and we do some information appending at the front.
+
+
+If an eror is thrown by sol, it is going to be of this type. We use this in a single place: the default ``at_panic`` function we bind on construction of a :ref:`sol::state<set-panic>`. If you turn :doc:`off exceptions<../exceptions>`, the chances of you seeing this error are nil unless you specifically use it to pull errors out of things such as :doc:`sol::protected_function<protected_function>`.
+
+As it derives from ``std::runtime_error``, which derives from ``std::exception``, you can catch it with a ``catch (const std::exception& )`` clause in your try/catch blocks. You can retrieve a string error from Lua (Lua pushes all its errors as string returns) by using this type with any of the get or lookup functions in sol.