From 6375147d5ae76a84dd64f1996cb0d9d501839db6 Mon Sep 17 00:00:00 2001
From: Michael Shepanski <michael@codesynthesis.com>
Date: Tue, 4 Nov 2014 16:10:03 +1100
Subject: Implement {query,execute}_{one,value}() shortcut functions

Useful in situations where the query is know to return at most one element
(*_one) or exactly one element (*_value).
---
 odb/database.hxx | 62 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 62 insertions(+)

(limited to 'odb/database.hxx')

diff --git a/odb/database.hxx b/odb/database.hxx
index 4e59aaf..1f56b7f 100644
--- a/odb/database.hxx
+++ b/odb/database.hxx
@@ -242,6 +242,56 @@ namespace odb
     result<T>
     query (const odb::query<T>&, bool cache = true);
 
+    // Query one API.
+    //
+    template <typename T>
+    typename object_traits<T>::pointer_type
+    query_one ();
+
+    template <typename T>
+    bool
+    query_one (T& object);
+
+    template <typename T>
+    T
+    query_value ();
+
+    template <typename T>
+    typename object_traits<T>::pointer_type
+    query_one (const char*);
+
+    template <typename T>
+    bool
+    query_one (const char*, T& object);
+
+    template <typename T>
+    T
+    query_value (const char*);
+
+    template <typename T>
+    typename object_traits<T>::pointer_type
+    query_one (const std::string&);
+
+    template <typename T>
+    bool
+    query_one (const std::string&, T& object);
+
+    template <typename T>
+    T
+    query_value (const std::string&);
+
+    template <typename T>
+    typename object_traits<T>::pointer_type
+    query_one (const odb::query<T>&);
+
+    template <typename T>
+    bool
+    query_one (const odb::query<T>&, T& object);
+
+    template <typename T>
+    T
+    query_value (const odb::query<T>&);
+
     // Query preparation.
     //
     template <typename T>
@@ -487,6 +537,18 @@ namespace odb
     void
     erase_ (const typename object_traits<T>::pointer_type&);
 
+    template <typename T, database_id DB, typename Q>
+    typename object_traits<T>::pointer_type
+    query_one_ (const Q&);
+
+    template <typename T, database_id DB, typename Q>
+    bool
+    query_one_ (const Q&, T&);
+
+    template <typename T, database_id DB, typename Q>
+    T
+    query_value_ (const Q&);
+
     template <typename T,
               database_id DB,
               class_kind kind = class_traits<T>::kind>
-- 
cgit v1.1