Merge commit 'efcea3a80da7c4479d5fe168435ecc9fd06bdc72' as 'subprojects/boost-sqlite'

1 files changed, 36 insertions, 0 deletions

diff --git a/subprojects/boost-sqlite/doc/reference/extension.adoc b/subprojects/boost-sqlite/doc/reference/extension.adoc
new file mode 100644
index 0000000..7ee2500
--- /dev/null
+++ b/subprojects/boost-sqlite/doc/reference/extension.adoc
@@ -0,0 +1,36 @@
+== `sqlite/extension.hpp`
+
+=== `BOOST_SQLITE_EXTENSION`
+
+ This macro can be used to create an sqlite extension.
+
+.Definition
+[source,cpp]
+----
+#define BOOST_SQLITE_EXTENSION(Name, Conn)
+----
+
+Name:: The name of the module.
+Conn:: The parameter name of the connection.
+
+
+NOTE: When defining BOOST_SQLITE_COMPILE_EXTENSION (was is done in extension.hpp)
+sqlite will use an inline namespace to avoid symbol clashes.
+
+You must link against `Boost::sqlite_ext` and not `Boost::sqlite` and should not mix both in the same binary.
+
+.Example
+[source,cpp]
+----
+BOOST_SQLITE_EXTENSION(extension, conn)
+{
+  create_scalar_function(
+    conn, "assert",
+    [](boost::sqlite::context<>, boost::span<boost::sqlite::value, 1u> sp)
+    {
+        if (sp.front().get_int() == 0)
+          throw std::logic_error("assertion failed");
+    });
+}
+----
+