btrievePython 16.10.30.0b0__tar.gz → 16.10.30.0b2__tar.gz

{btrievepython-16.10.30.0b0/btrievePython.egg-info → btrievepython-16.10.30.0b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: btrievePython
-Version: 16.10.30.0b0
+Version: 16.10.30.0b2
 Summary: Btrieve Python provides a Client API for Actian Zen
 Home-page: https://www.actian.com/databases/zen
 Author: Actian Corporation

{btrievepython-16.10.30.0b0 → btrievepython-16.10.30.0b2}/btrievePython/__init__.py

@@ -64,6 +64,176 @@ class _SwigNonDynamicMeta(type):
 
 def buffer_view_attach(view: "Py_buffer *", obj: "PyObject *", buffer: "char **", size: "Py_ssize_t *") -> "int":
     return _btrievePython.buffer_view_attach(view, obj, buffer, size)
+
+def buffer_view_attach_const(view: "Py_buffer *", obj: "PyObject *", buffer: "char const **", size: "Py_ssize_t *") -> "int":
+    return _btrievePython.buffer_view_attach_const(view, obj, buffer, size)
+class SwigPyIterator(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+
+    def __init__(self, *args, **kwargs):
+        raise AttributeError("No constructor defined - class is abstract")
+    __repr__ = _swig_repr
+    __swig_destroy__ = _btrievePython.delete_SwigPyIterator
+
+    def value(self) -> "PyObject *":
+        return _btrievePython.SwigPyIterator_value(self)
+
+    def incr(self, n: "size_t"=1) -> "swig::SwigPyIterator *":
+        return _btrievePython.SwigPyIterator_incr(self, n)
+
+    def decr(self, n: "size_t"=1) -> "swig::SwigPyIterator *":
+        return _btrievePython.SwigPyIterator_decr(self, n)
+
+    def distance(self, x: "SwigPyIterator") -> "ptrdiff_t":
+        return _btrievePython.SwigPyIterator_distance(self, x)
+
+    def equal(self, x: "SwigPyIterator") -> "bool":
+        return _btrievePython.SwigPyIterator_equal(self, x)
+
+    def copy(self) -> "swig::SwigPyIterator *":
+        return _btrievePython.SwigPyIterator_copy(self)
+
+    def next(self) -> "PyObject *":
+        return _btrievePython.SwigPyIterator_next(self)
+
+    def __next__(self) -> "PyObject *":
+        return _btrievePython.SwigPyIterator___next__(self)
+
+    def previous(self) -> "PyObject *":
+        return _btrievePython.SwigPyIterator_previous(self)
+
+    def advance(self, n: "ptrdiff_t") -> "swig::SwigPyIterator *":
+        return _btrievePython.SwigPyIterator_advance(self, n)
+
+    def __eq__(self, x: "SwigPyIterator") -> "bool":
+        return _btrievePython.SwigPyIterator___eq__(self, x)
+
+    def __ne__(self, x: "SwigPyIterator") -> "bool":
+        return _btrievePython.SwigPyIterator___ne__(self, x)
+
+    def __iadd__(self, n: "ptrdiff_t") -> "swig::SwigPyIterator &":
+        return _btrievePython.SwigPyIterator___iadd__(self, n)
+
+    def __isub__(self, n: "ptrdiff_t") -> "swig::SwigPyIterator &":
+        return _btrievePython.SwigPyIterator___isub__(self, n)
+
+    def __add__(self, n: "ptrdiff_t") -> "swig::SwigPyIterator *":
+        return _btrievePython.SwigPyIterator___add__(self, n)
+
+    def __sub__(self, *args) -> "ptrdiff_t":
+        return _btrievePython.SwigPyIterator___sub__(self, *args)
+    def __iter__(self):
+        return self
+
+# Register SwigPyIterator in _btrievePython:
+_btrievePython.SwigPyIterator_swigregister(SwigPyIterator)
+
+class FloatVector(object):
+    thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
+    __repr__ = _swig_repr
+
+    def iterator(self) -> "swig::SwigPyIterator *":
+        return _btrievePython.FloatVector_iterator(self)
+    def __iter__(self):
+        return self.iterator()
+
+    def __nonzero__(self) -> "bool":
+        return _btrievePython.FloatVector___nonzero__(self)
+
+    def __bool__(self) -> "bool":
+        return _btrievePython.FloatVector___bool__(self)
+
+    def __len__(self) -> "std::vector< float >::size_type":
+        return _btrievePython.FloatVector___len__(self)
+
+    def __getslice__(self, i: "std::vector< float >::difference_type", j: "std::vector< float >::difference_type") -> "std::vector< float,std::allocator< float > > *":
+        return _btrievePython.FloatVector___getslice__(self, i, j)
+
+    def __setslice__(self, *args) -> "void":
+        return _btrievePython.FloatVector___setslice__(self, *args)
+
+    def __delslice__(self, i: "std::vector< float >::difference_type", j: "std::vector< float >::difference_type") -> "void":
+        return _btrievePython.FloatVector___delslice__(self, i, j)
+
+    def __delitem__(self, *args) -> "void":
+        return _btrievePython.FloatVector___delitem__(self, *args)
+
+    def __getitem__(self, *args) -> "std::vector< float >::value_type const &":
+        return _btrievePython.FloatVector___getitem__(self, *args)
+
+    def __setitem__(self, *args) -> "void":
+        return _btrievePython.FloatVector___setitem__(self, *args)
+
+    def pop(self) -> "std::vector< float >::value_type":
+        return _btrievePython.FloatVector_pop(self)
+
+    def append(self, x: "std::vector< float >::value_type const &") -> "void":
+        return _btrievePython.FloatVector_append(self, x)
+
+    def empty(self) -> "bool":
+        return _btrievePython.FloatVector_empty(self)
+
+    def size(self) -> "std::vector< float >::size_type":
+        return _btrievePython.FloatVector_size(self)
+
+    def swap(self, v: "FloatVector") -> "void":
+        return _btrievePython.FloatVector_swap(self, v)
+
+    def begin(self) -> "std::vector< float >::iterator":
+        return _btrievePython.FloatVector_begin(self)
+
+    def end(self) -> "std::vector< float >::iterator":
+        return _btrievePython.FloatVector_end(self)
+
+    def rbegin(self) -> "std::vector< float >::reverse_iterator":
+        return _btrievePython.FloatVector_rbegin(self)
+
+    def rend(self) -> "std::vector< float >::reverse_iterator":
+        return _btrievePython.FloatVector_rend(self)
+
+    def clear(self) -> "void":
+        return _btrievePython.FloatVector_clear(self)
+
+    def get_allocator(self) -> "std::vector< float >::allocator_type":
+        return _btrievePython.FloatVector_get_allocator(self)
+
+    def pop_back(self) -> "void":
+        return _btrievePython.FloatVector_pop_back(self)
+
+    def erase(self, *args) -> "std::vector< float >::iterator":
+        return _btrievePython.FloatVector_erase(self, *args)
+
+    def __init__(self, *args):
+        _btrievePython.FloatVector_swiginit(self, _btrievePython.new_FloatVector(*args))
+
+    def push_back(self, x: "std::vector< float >::value_type const &") -> "void":
+        return _btrievePython.FloatVector_push_back(self, x)
+
+    def front(self) -> "std::vector< float >::value_type const &":
+        return _btrievePython.FloatVector_front(self)
+
+    def back(self) -> "std::vector< float >::value_type const &":
+        return _btrievePython.FloatVector_back(self)
+
+    def assign(self, n: "std::vector< float >::size_type", x: "std::vector< float >::value_type const &") -> "void":
+        return _btrievePython.FloatVector_assign(self, n, x)
+
+    def resize(self, *args) -> "void":
+        return _btrievePython.FloatVector_resize(self, *args)
+
+    def insert(self, *args) -> "void":
+        return _btrievePython.FloatVector_insert(self, *args)
+
+    def reserve(self, n: "std::vector< float >::size_type") -> "void":
+        return _btrievePython.FloatVector_reserve(self, n)
+
+    def capacity(self) -> "std::vector< float >::size_type":
+        return _btrievePython.FloatVector_capacity(self)
+    __swig_destroy__ = _btrievePython.delete_FloatVector
+
+# Register FloatVector in _btrievePython:
+_btrievePython.FloatVector_swigregister(FloatVector)
+
 class Btrieve(object):
     thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc="The membership flag")
 
@@ -534,6 +704,7 @@ class Btrieve(object):
     STATUS_CODE_UT_THUNK_NOT_LOADED = _btrievePython.Btrieve_STATUS_CODE_UT_THUNK_NOT_LOADED
     STATUS_CODE_NO_RESOURCE_DLL = _btrievePython.Btrieve_STATUS_CODE_NO_RESOURCE_DLL
     STATUS_CODE_OS_ERROR = _btrievePython.Btrieve_STATUS_CODE_OS_ERROR
+    STATUS_CODE_FILTER_LIMIT_EXCEEDED = _btrievePython.Btrieve_STATUS_CODE_FILTER_LIMIT_EXCEEDED
     STATUS_CODE_MK_ROUTER_MEM_ERROR = _btrievePython.Btrieve_STATUS_CODE_MK_ROUTER_MEM_ERROR
     STATUS_CODE_MK_NO_LOCAL_ACCESS_ALLOWED = _btrievePython.Btrieve_STATUS_CODE_MK_NO_LOCAL_ACCESS_ALLOWED
     STATUS_CODE_MK_NO_RESOURCE_DLL = _btrievePython.Btrieve_STATUS_CODE_MK_NO_RESOURCE_DLL
@@ -1826,11 +1997,14 @@ class BtrieveSpace(object):
         _btrievePython.BtrieveSpace_swiginit(self, _btrievePython.new_BtrieveSpace())
     __swig_destroy__ = _btrievePython.delete_BtrieveSpace
 
+    def VectorCreateFast(self, json: "char const *", vector: "FloatVector") -> "int":
+        return _btrievePython.BtrieveSpace_VectorCreateFast(self, json, vector)
+
     def VectorRetrieveEntityTag(self, id: "int") -> "int":
         return _btrievePython.BtrieveSpace_VectorRetrieveEntityTag(self, id)
 
-    def VectorDelete(self, id: "int", entityTag: "int"=-1) -> "Btrieve::StatusCode":
-        return _btrievePython.BtrieveSpace_VectorDelete(self, id, entityTag)
+    def VectorDelete(self, *args) -> "Btrieve::StatusCode":
+        return _btrievePython.BtrieveSpace_VectorDelete(self, *args)
 
     def Query(self, btrieveVectorSet: "BtrieveVectorSet", query: "char const *"=None) -> "Btrieve::StatusCode":
         return _btrievePython.BtrieveSpace_Query(self, btrieveVectorSet, query)
@@ -1847,22 +2021,22 @@ class BtrieveSpace(object):
     def SetLastStatusCode(self, statusCode: "Btrieve::StatusCode") -> "Btrieve::StatusCode":
         return _btrievePython.BtrieveSpace_SetLastStatusCode(self, statusCode)
 
-    def EuclideanDistanceSimilarity(self, vector: "char const *", limit: "int", query: "char const *"=None) -> "char const *":
+    def EuclideanDistanceSimilarity(self, vector: "char const *", limit: "int", query: "char const *"=None) -> "std::string":
         return _btrievePython.BtrieveSpace_EuclideanDistanceSimilarity(self, vector, limit, query)
 
-    def CosineSimilarity(self, vector: "char const *", limit: "int", query: "char const *"=None) -> "char const *":
+    def CosineSimilarity(self, vector: "char const *", limit: "int", query: "char const *"=None) -> "std::string":
         return _btrievePython.BtrieveSpace_CosineSimilarity(self, vector, limit, query)
 
-    def DotProductSimilarity(self, vector: "char const *", limit: "int", query: "char const *"=None) -> "char const *":
+    def DotProductSimilarity(self, vector: "char const *", limit: "int", query: "char const *"=None) -> "std::string":
         return _btrievePython.BtrieveSpace_DotProductSimilarity(self, vector, limit, query)
 
     def VectorCreate(self, *args) -> "int":
         return _btrievePython.BtrieveSpace_VectorCreate(self, *args)
 
-    def VectorRetrieveBlob(self, id: "int", blobObject: "PyObject *", vectorBlobOffset: "int"=0, vectorBlobLength: "int"=0) -> "Btrieve::StatusCode":
-        return _btrievePython.BtrieveSpace_VectorRetrieveBlob(self, id, blobObject, vectorBlobOffset, vectorBlobLength)
+    def VectorRetrieveBlob(self, *args) -> "Btrieve::StatusCode":
+        return _btrievePython.BtrieveSpace_VectorRetrieveBlob(self, *args)
 
-    def VectorRetrieveJson(self, *args) -> "char const *":
+    def VectorRetrieveJson(self, *args) -> "std::string":
         return _btrievePython.BtrieveSpace_VectorRetrieveJson(self, *args)
 
     def VectorUpdate(self, *args) -> "Btrieve::StatusCode":

{btrievepython-16.10.30.0b0 → btrievepython-16.10.30.0b2}/btrievePython/btrieveC.h

@@ -403,6 +403,8 @@ typedef enum {
     BTRIEVE_STATUS_CODE_NO_RESOURCE_DLL = 2011,
     /// \brief 2012 - Operating system error.
     BTRIEVE_STATUS_CODE_OS_ERROR = 2012,
+    /// \brief 2013 - Filter limit exceeded.
+    BTRIEVE_STATUS_CODE_FILTER_LIMIT_EXCEEDED = 2013,
     /// \brief 3000 - MicroKernel router memory error.
     BTRIEVE_STATUS_CODE_MK_ROUTER_MEM_ERROR = 3000,
     /// \brief 3001 - MicroKernel no local access allowed.
@@ -2310,7 +2312,7 @@ extern LINKAGE btrieve_status_code_t BtrieveFileBulkRetrieveNext(btrieve_file_t
 /// \param[in] file The file. See BtrieveClientFileOpen().
 /// \param[in] comparison The comparison.
 /// \param[in] index The index.
-/// \param[in] key The key.
+/// \param[inout] key The key.
 /// \param[in] keyLength The key length.
 /// \param[in] bulkRetrieveAttributes The bulk retrieve attributes. See BtrieveBulkRetrieveAttributesAllocate().
 /// \param[out] bulkRetrieveResult The bulk retrieve result. See BtrieveBulkRetrieveResultAllocate().
@@ -2342,7 +2344,7 @@ extern LINKAGE btrieve_status_code_t BtrieveFileBulkRetrievePrevious(btrieve_fil
 /// \param[in] file The file. See BtrieveClientFileOpen().
 /// \param[in] comparison The comparison.
 /// \param[in] index The index.
-/// \param[in] key The key.
+/// \param[inout] key The key.
 /// \param[in] keyLength The key length.
 /// \param[in] bulkRetrieveAttributes The bulk retrieve attributes. See BtrieveBulkRetrieveAttributesAllocate().
 /// \param[out] bulkRetrieveResult The bulk retrieve result. See BtrieveBulkRetrieveResultAllocate().
@@ -2403,7 +2405,7 @@ extern LINKAGE btrieve_status_code_t BtrieveFileBulkDeleteNext(btrieve_file_t fi
 /// \param[in] file The file. See BtrieveClientFileOpen().
 /// \param[in] comparison The comparison.
 /// \param[in] index The index.
-/// \param[in] key The key.
+/// \param[inout] key The key.
 /// \param[in] keyLength The key length.
 /// \param[in] bulkDeleteAttributes The bulk delete attributes. See BtrieveBulkDeleteAttributesAllocate().
 /// \param[out] bulkDeleteResult The bulk delete result. See BtrieveBulkDeleteResultAllocate().
@@ -2433,7 +2435,7 @@ extern LINKAGE btrieve_status_code_t BtrieveFileBulkDeletePrevious(btrieve_file_
 /// \param[in] file The file. See BtrieveClientFileOpen().
 /// \param[in] comparison The comparison.
 /// \param[in] index The index.
-/// \param[in] key The key.
+/// \param[inout] key The key.
 /// \param[in] keyLength The key length.
 /// \param[in] bulkDeleteAttributes The bulk delete attributes. See BtrieveBulkDeleteAttributesAllocate().
 /// \param[out] bulkDeleteResult The bulk delete result. See BtrieveBulkDeleteResultAllocate().

{btrievepython-16.10.30.0b0 → btrievepython-16.10.30.0b2}/btrievePython/btrieveCpp.h

@@ -14,6 +14,8 @@
 
 #include <cstddef>
 #include <deque>
+#include <string>
+#include <vector>
 
 #include "btrieveC.h"
 
@@ -1081,6 +1083,8 @@ public:
       STATUS_CODE_NO_RESOURCE_DLL = 2011,
 		/// \brief 2012 - Operating system error.
       STATUS_CODE_OS_ERROR = 2012,
+      /// \brief 2013 - Filter limit exceeded.
+      STATUS_CODE_FILTER_LIMIT_EXCEEDED = 2013,
 		/// \brief 3000 - MicroKernel router memory error.
       STATUS_CODE_MK_ROUTER_MEM_ERROR = 3000,
 		/// \brief 3001 - MicroKernel no local access allowed.
@@ -1399,6 +1403,8 @@ public:
    /// \param[in] clientIdentifier The client identifier. Use 0 to automatically generate a client identifier based on the caller's thread identifier.
    /// \SNIPPET_CPP_PYTHON{BtrieveClient, btest.cpp, btest.py}
    BtrieveClient(int serviceAgentIdentifier, int clientIdentifier);
+   /// \par
+   /// Any open collections, files or spaces will remain open. See BtrieveClient::CollectionClose, BtrieveClient::FileClose, and BtrieveClient::SpaceClose. Also see BtrieveClient::Reset.
    ~BtrieveClient();
 
    /// \brief Get the version.
@@ -5089,14 +5095,17 @@ private:
 /// ----------      | ------------- | ---------------- | ------- | ------------------ | ----   | -----------
 /// _blobLength     | no            | yes              | yes     | yes                | number | The vector blob length.
 /// _createTime     | no            | yes              | yes     | yes                | number | The vector create time in microseconds since the Unix Epoch.
-/// _id             | no            | yes              | yes     | no                 | number | The vector identifier.
+/// _id             | yes           | yes              | yes     | no                 | number | The vector identifier.
 /// _jsonLength     | no            | yes              | yes     | yes                | number | The vector json length.
 /// _label          | yes           | no               | yes     | yes                | string | The vector label.
 /// _updateTime     | no            | yes              | yes     | yes                | number | The vector update time in microseconds since the Unix Epoch.
+/// _uuid           | yes           | yes              | yes     | no                 | string | The vector universally unique identifier.
+/// _vector         | yes           | no               | no      | yes                | array  | The vector as an array of numbers.
 /// \details
 /// Non-user settable JSON field names are silently ignored by BtrieveSpace::VectorCreate and BtrieveSpace::VectorUpdate.
+/// "_id" and "_uuid" are user settable on vector create only.
 /// Use of reserved JSON field names other than those listed above will generate an error.
-/// Reserved JSON field names are added to the vector JSON retrieved by BtrieveSpace::VectorRetrieveJson and BtrieveSpace::VectorRetrieve.
+/// Reserved JSON field names are added to the vector JSON retrieved by BtrieveSpace::VectorRetrieveJson.
 ///
 /// The vector identifier is an autoincrement positive integer with a maximum value of 2147483647 (2^31 - 1).
 class LINKAGE BtrieveSpace
@@ -5119,6 +5128,7 @@ public:
    /// \retval -1 \ERROR_HAS_OCCURRED
    /// \TO_DETERMINE_STATUS_CODE{BtrieveSpace::GetLastStatusCode}
    int VectorCreate(const char *json);
+   int VectorCreateFast(const char *json, const std::vector<float> &vector);
    /// \brief Create a vector.
    /// \param[in] json The json.
    /// \param[in] blob The blob.
@@ -5137,39 +5147,44 @@ public:
    /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
    /// \see Btrieve::StatusCodeToString
    Btrieve::StatusCode VectorRetrieveBlob(int id, char *blob, int blobSize, int vectorBlobOffset = 0, int vectorBlobLength = 0);
+   /// \brief Retrieve a vector blob.
+   /// \param[in] uuid The universally unique identifier.
+   /// \param[out] blob The blob. 
+   /// \param[in] blobSize The blob size.
+   /// \param[in] vectorBlobOffset The vector blob offset.
+   /// \param[in] vectorBlobLength The vector blob length. If vector blob length is 0, then the entire vector blob will be retrieved beginning at vector blob offset.
+   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
+   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
+   /// \see Btrieve::StatusCodeToString
+   Btrieve::StatusCode VectorRetrieveBlob(const char *uuid, char *blob, int blobSize, int vectorBlobOffset = 0, int vectorBlobLength = 0);
    /// \brief Retrieve a vector json.
-   /// \note This method is not thread safe. The string returned will be overwritten on subsequent calls.
    /// \param[in] id The identifier.
-   /// \retval "!= NULL" The json.
-   /// \retval NULL \ERROR_HAS_OCCURRED
-   const char *VectorRetrieveJson(int id);
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
+   std::string VectorRetrieveJson(int id);
+   /// \brief Retrieve a vector json.
+   /// \param[in] uuid The universally unique identifier.
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
+   std::string VectorRetrieveJson(const char *uuid);
    /// \brief Retrieve a vector json.
-   /// \note This method is not thread safe. The string returned will be overwritten on subsequent calls.
    /// \param[in] id The identifier.
    /// \param[out] blob The blob.
    /// \param[in] blobSize The blob size.
    /// \param[in] vectorBlobOffset The vector blob offset.
    /// \param[in] vectorBlobLength The vector blob length. If vector blob length is 0, then the entire vector blob will be retrieved beginning at vector blob offset.
-   /// \retval "!= NULL" The json.
-   /// \retval NULL \ERROR_HAS_OCCURRED
-   const char *VectorRetrieveJson(int id, char *blob, int blobSize, int vectorBlobOffset = 0, int vectorBlobLength = 0);
-#ifndef SWIG
-   /// \brief Retrieve a vector.
-   /// \note \METHOD_ONLY_CPP
-   /// \param[in] id The identifier.
-   /// \param[out] json The json.
-   /// \param[in] jsonSize The json size.
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
+   std::string VectorRetrieveJson(int id, char *blob, int blobSize, int vectorBlobOffset = 0, int vectorBlobLength = 0);
+   /// \brief Retrieve a vector json.
+   /// \param[in] uuid The universally unique identifier.
    /// \param[out] blob The blob.
    /// \param[in] blobSize The blob size.
    /// \param[in] vectorBlobOffset The vector blob offset.
    /// \param[in] vectorBlobLength The vector blob length. If vector blob length is 0, then the entire vector blob will be retrieved beginning at vector blob offset.
-   /// \par \DESCRIPTION
-   /// Remember to allocate enough space to retrieve not only the vector JSON but also the reserved JSON field names and values, e.g. "_bloblength" : 1234567890.
-   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
-   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
-   /// \see Btrieve::StatusCodeToString
-   Btrieve::StatusCode VectorRetrieve(int id, char *json = NULL, int jsonSize = 0, char *blob = NULL, int blobSize = 0, int vectorBlobOffset = 0, int vectorBlobLength = 0);
-#endif
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
+   std::string VectorRetrieveJson(const char *uuid, char *blob, int blobSize, int vectorBlobOffset = 0, int vectorBlobLength = 0);
    /// \brief Retrieve a vector entity tag.
    /// \param[in] id The identifier.
    /// \retval ">= 0" The vector entity tag.
@@ -5184,6 +5199,13 @@ public:
    /// \see Btrieve::StatusCodeToString
    Btrieve::StatusCode VectorUpdate(int id, const char *json);
    /// \brief Update a vector.
+   /// \param[in] uuid The universally unique identifier.
+   /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
+   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
+   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
+   /// \see Btrieve::StatusCodeToString
+   Btrieve::StatusCode VectorUpdate(const char *uuid, const char *json);
+   /// \brief Update a vector.
    /// \param[in] id The identifier.
    /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
    /// \param[in] blob The blob. If blob is NULL, then the vector blob will not be updated.
@@ -5193,6 +5215,15 @@ public:
    /// \see Btrieve::StatusCodeToString
    Btrieve::StatusCode VectorUpdate(int id, const char *json, const char *blob, int blobLength);
    /// \brief Update a vector.
+   /// \param[in] uuid The universally unique identifier.
+   /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
+   /// \param[in] blob The blob. If blob is NULL, then the vector blob will not be updated.
+   /// \param[in] blobLength The blob length. If blob is not NULL and blobLength is 0, then the vector blob will be deleted.
+   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
+   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
+   /// \see Btrieve::StatusCodeToString
+   Btrieve::StatusCode VectorUpdate(const char *uuid, const char *json, const char *blob, int blobLength);
+   /// \brief Update a vector.
    /// \param[in] id The identifier.
    /// \param[in] entityTag The entity tag. The entity tag must either equal the entity tag of the vector or -1.
    /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
@@ -5201,6 +5232,14 @@ public:
    /// \see Btrieve::StatusCodeToString
    Btrieve::StatusCode VectorUpdate(int id, int entityTag, const char *json);
    /// \brief Update a vector.
+   /// \param[in] uuid The universally unique identifier.
+   /// \param[in] entityTag The entity tag. The entity tag must either equal the entity tag of the vector or -1.
+   /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
+   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
+   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
+   /// \see Btrieve::StatusCodeToString
+   Btrieve::StatusCode VectorUpdate(const char *uuid, int entityTag, const char *json);
+   /// \brief Update a vector.
    /// \param[in] id The identifier.
    /// \param[in] entityTag The entity tag. The entity tag must either equal the entity tag of the vector or -1.
    /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
@@ -5210,6 +5249,16 @@ public:
    /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
    /// \see Btrieve::StatusCodeToString
    Btrieve::StatusCode VectorUpdate(int id, int entityTag, const char *json, const char *blob, int blobLength);
+   /// \brief Update a vector.
+   /// \param[in] uuid The universally unique identifier.
+   /// \param[in] entityTag The entity tag. The entity tag must either equal the entity tag of the vector or -1.
+   /// \param[in] json The json. If json is NULL, then the vector json will not be updated.
+   /// \param[in] blob The blob. If blob is NULL, then the vector blob will not be updated.
+   /// \param[in] blobLength The blob length. If blob is not NULL and blobLength is 0, then the vector blob will be deleted.
+   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
+   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
+   /// \see Btrieve::StatusCodeToString
+   Btrieve::StatusCode VectorUpdate(const char *uuid, int entityTag, const char *json, const char *blob, int blobLength);
    /// \brief Delete a vector.
    /// \param[in] id The identifier.
    /// \param[in] entityTag The entity tag. The entity tag must either equal the entity tag of the vector or -1.
@@ -5217,6 +5266,13 @@ public:
    /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
    /// \see Btrieve::StatusCodeToString
    Btrieve::StatusCode VectorDelete(int id, int entityTag = -1);
+   /// \brief Delete a vector.
+   /// \param[in] uuid The universally unique identifier.
+   /// \param[in] entityTag The entity tag. The entity tag must either equal the entity tag of the vector or -1.
+   /// \retval "= Btrieve::STATUS_CODE_NO_ERROR" \SUCCESS
+   /// \retval "!= Btrieve::STATUS_CODE_NO_ERROR" \ERROR_HAS_OCCURRED
+   /// \see Btrieve::StatusCodeToString
+   Btrieve::StatusCode VectorDelete(const char *uuid, int entityTag = -1);
    /// \brief Query the space.
    /// \param[out] btrieveVectorSet The %Btrieve vector set.
    /// \param[in] query The query. The maximum query length is Btrieve::MAXIMUM_RECORD_LENGTH bytes.
@@ -5275,12 +5331,16 @@ public:
    ///      "_sortOrder" : "descending" |
    ///      "_updateTime" : <number> | 
    ///      "_updateTime" : { <time_operator> : <number> }
+   ///      "_uuid" : <string> | 
+   ///      "_uuid" : { <uuid_operator> : <string> } |
    ///
-   ///   <sort_field> := "_blobLength" | "_createTime" | "_id" | "_jsonLength" | "_label" | "_updateTime"
+   ///   <sort_field> := "_blobLength" | "_createTime" | "_id" | "_jsonLength" | "_label" | "_updateTime" | "_uuid"
    ///
    ///   <time_operator> ::= "$eq" | "$gt" | "$gte" | "$lt" | "$lte"
    ///
    ///   <string_operator> ::= "$eq" | "$gt" | "$gte" | "$like" | "$lt" | "$lte" | "$ne" | "$notlike"
+   ///
+   ///   <uuid_operator> ::= "$eq" | "$gt" | "$gte" | "$lt" | "$lte" | "$ne"
    /// \endcode
    /// \par
    /// In a JSON expression, if the query value is not an array and the vector value is an array then each element in the array is evaluated. If any evaluation returns true then the JSON expression returns true.
@@ -5322,41 +5382,46 @@ public:
    Btrieve::StatusCode SetLastStatusCode(Btrieve::StatusCode statusCode);
 /// \endcond
    /// \brief Calculate the Euclidean distance similarity.
-   /// \note This method is not thread safe. The string returned will be overwritten on subsequent calls.
    /// \param[in] vector The vector.
    /// \param[in] limit The limit.
    /// \param[in] query The query. See BtrieveSpace::Query.
-   /// \retval "!= NULL" The similarity.
-   /// \retval NULL \ERROR_HAS_OCCURRED
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
    /// \TO_DETERMINE_STATUS_CODE{BtrieveSpace::GetLastStatusCode}
-   const char *EuclideanDistanceSimilarity(const char *vector, int limit, const char *query = NULL);
+   std::string EuclideanDistanceSimilarity(const char *vector, int limit, const char *query = NULL);
    /// \brief Calculate the cosine similarity.
-   /// \note This method is not thread safe. The string returned will be overwritten on subsequent calls.
    /// \param[in] vector The vector.
    /// \param[in] limit The limit.
    /// \param[in] query The query. See BtrieveSpace::Query.
-   /// \retval "!= NULL" The similarity.
-   /// \retval NULL \ERROR_HAS_OCCURRED
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
    /// \TO_DETERMINE_STATUS_CODE{BtrieveSpace::GetLastStatusCode}
-   const char *CosineSimilarity(const char *vector, int limit, const char *query = NULL);
+   std::string CosineSimilarity(const char *vector, int limit, const char *query = NULL);
    /// \brief Calculate the dot product similarity.
-   /// \note This method is not thread safe. The string returned will be overwritten on subsequent calls.
    /// \param[in] vector The vector.
    /// \param[in] limit The limit.
    /// \param[in] query The query. See BtrieveSpace::Query.
-   /// \retval "!= NULL" The similarity.
-   /// \retval NULL \ERROR_HAS_OCCURRED
+   /// \retval !="" The json.
+   /// \retval "" \ERROR_HAS_OCCURRED
    /// \TO_DETERMINE_STATUS_CODE{BtrieveSpace::GetLastStatusCode}
-   const char *DotProductSimilarity(const char *vector, int limit, const char *query = NULL);
+   std::string DotProductSimilarity(const char *vector, int limit, const char *query = NULL);
 
 private:
    BtrieveClient *btrieveClient = NULL;
    BtrieveFile *btrieveFile = NULL;
    Btrieve::StatusCode lastStatusCode = Btrieve::STATUS_CODE_NO_ERROR;
    int vectorLength = 0;
-   const char *ProcessSimilarity(const char *vector, int limit, const char *query,
-        Btrieve::StatusCode (BtrieveBulkRetrieveAttributes::*addSimilarity)(const char *, int, int), 
-        const char *similarityKey);
+   std::string ProcessSimilarity(const char *vector, int limit, const char *query, 
+      Btrieve::StatusCode (BtrieveBulkRetrieveAttributes::*addSimilarity)(const char *, int, int), const char *similarityKey);
+   Btrieve::StatusCode VectorRetrieveHelper(struct btrieveVector *btrieveVector, std::string *json = NULL, 
+      char *blob = NULL, int blobSize = 0, int vectorBlobOffset = 0, int vectorBlobLength = 0);
+   Btrieve::StatusCode VectorRetrieve(int id, std::string *json = NULL, char *blob = NULL, 
+      int blobSize = 0, int vectorBlobOffset = 0, int vectorBlobLength = 0);
+   Btrieve::StatusCode VectorRetrieve(const char *uuid, std::string *json = NULL, char *blob = NULL, int blobSize = 0, int vectorBlobOffset = 0, 
+      int vectorBlobLength = 0);
+   Btrieve::StatusCode VectorUpdateHelper(const char *uuid, int id, int entityTagIn, const char *json, const char *blob, int blobLength);
+   Btrieve::StatusCode VectorDeleteHelper(const char *uuid, int id, int entityTagIn);
+   int VectorCreateHelper(const char *json, const std::vector<float> *vector, const char *blob, int blobLength);
 };
 
 /// \brief The %Btrieve vector set class.