dart run ffigen to update C API Dart bindings.

Author: greenrobot-team

objectbox/lib/src/native/bindings/objectbox_c.dart

@@ -1120,9 +1120,11 @@ class ObjectBoxC {
       _store_is_open_ptr.asFunction<_dart_store_is_open>();
 
   /// Attach to a previously opened store matching the path of the DB directory, which was used for opening the store.
-  /// The returned store is a new instance (e.g. different pointer value) with its own lifetime and must also be closed.
+  /// The returned store is a new instance (e.g. different pointer value) with its own lifetime and must also be closed
+  /// via obx_store_close().
   /// The actual underlying store is only closed when the last store OBX_store instance is closed.
   /// @returns nullptr if no open store was found (i.e. not opened before or already closed)
+  /// @see obx_store_clone() for "attaching" to a available store instance.
   ffi.Pointer<OBX_store> store_attach(
     ffi.Pointer<ffi.Int8> path,
   ) {
@@ -1160,6 +1162,27 @@ class ObjectBoxC {
   late final _dart_store_attach_or_open _store_attach_or_open =
       _store_attach_or_open_ptr.asFunction<_dart_store_attach_or_open>();
 
+  /// Clone a previously opened store; while a store instance is usable from multiple threads, situations may exist
+  /// in which cloning a store simplifies the overall lifecycle.
+  /// E.g. when a store is used for multiple threads and it may only be fully released once the last thread completes.
+  /// The returned store is a new instance (e.g. different pointer value) with its own lifetime and must also be closed
+  /// via obx_store_close().
+  /// The actual underlying store is only closed when the last store OBX_store instance is closed.
+  /// @returns nullptr if the store could not be cloned
+  /// @see obx_store_attach() for "cloning" using the store's path.
+  ffi.Pointer<OBX_store> store_clone(
+    ffi.Pointer<OBX_store> store,
+  ) {
+    return _store_clone(
+      store,
+    );
+  }
+
+  late final _store_clone_ptr =
+      _lookup<ffi.NativeFunction<_c_store_clone>>('obx_store_clone');
+  late final _dart_store_clone _store_clone =
+      _store_clone_ptr.asFunction<_dart_store_clone>();
+
   /// For stores created outside of this C API, e.g. via C++ or Java, this is how you can use it via C too.
   /// Like this, it is OK to use the same store instance (same database) from multiple languages in parallel.
   /// Note: the store's life time will still be managed outside of the C API;
@@ -7679,6 +7702,14 @@ typedef _dart_store_attach_or_open = ffi.Pointer<OBX_store> Function(
   ffi.Pointer<ffi.Uint8> out_attached,
 );
 
+typedef _c_store_clone = ffi.Pointer<OBX_store> Function(
+  ffi.Pointer<OBX_store> store,
+);
+
+typedef _dart_store_clone = ffi.Pointer<OBX_store> Function(
+  ffi.Pointer<OBX_store> store,
+);
+
 typedef _c_store_wrap = ffi.Pointer<OBX_store> Function(
   ffi.Pointer<ffi.Void> core_store,
 );