Description
ObjectBox is a superfast cross-platform object-oriented database.
It's best explained via example code. For a task database application, these few lines show CRUD operations (create, read, update, delete):
obx::Box box(store);
obx_id id = box.put({.text = "Buy milk"}); // Create
std::unique_ptr task = box.get(id); // Read
if (task) {
task->text += " & some bread";
box.put(*task); // Update
box.remove(id); // Delete
}
ObjectBox C/C++ database alternatives and similar libraries
Based on the "Database" category.
Alternatively, view ObjectBox C/C++ database alternatives based on common mentions on social networks and blogs.
-
RocksDB
A library that provides an embeddable, persistent key-value store for fast storage. -
ClickHouse
ClickHouse® is a free analytics DBMS for big data -
LevelDB
LevelDB is a fast key-value storage library written at Google that provides an ordered mapping from string keys to string values. -
SQLite
Unofficial git mirror of SQLite sources (see link for build instructions) -
LMDB
Read-only mirror of official repo on openldap.org. Issues and pull requests here are ignored. Use OpenLDAP ITS for issues. -
Sophia
Modern transactional key-value/row storage library. -
SOCI
Official repository of the SOCI - The C++ Database Access Library -
sqlite_orm
❤️ SQLite ORM light header only library for modern C++ -
cpp_redis
C++11 Lightweight Redis client: async, thread-safe, no dependency, pipelining, multi-platform. -
MongoDB C Driver
A high-performance MongoDB driver for C -
libmdbx
One of the fastest embeddable key-value ACID database without WAL. libmdbx surpasses the legendary LMDB in terms of reliability, features and performance. -
Bedrock
Rock solid distributed database specializing in active/active automatic failover and WAN replication -
sqlite_modern_cpp
The C++14 wrapper around sqlite library -
MongoDB Libbson
A BSON utility library. [Apache2] -
upscaledb
A very fast lightweight embedded database engine with a built-in query language. -
SimDB
A high performance, shared memory, lock free, cross platform, single file, no dependencies, C++11 key-value store -
LMDB++
C++11 wrapper for the LMDB embedded B+ tree database library. -
BerylDB
BerylDB is a fully modular data structure data manager that can be used to store data as key-value entries. The server allows channel subscription and is optimized to be used as a cache repository. Supported structures include lists, sets, multimaps, and keys. -
RethinkDB driver for C++
RethinkDB driver for C++ -
tntdb
Tntdb is a c++-class-library for easy access to databases.
Less time debugging, more time building
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of ObjectBox C/C++ database or a related project?
README
ObjectBox C and C++ APIs
ObjectBox is a superfast database and data synchronization solution. This is the ObjectBox runtime library to run ObjectBox as an embedded database in your C or C++ application.
Here's a C++ example that inserts a Task
data object (a plain user defined struct
) into the database:
obx::Box<Task> box(store);
box.put({.text = "Buy milk"});
See ObjectBox C and C++ docs for API details.
Latest version: 0.14.0 (2021-05-13). See [changelog](CHANGELOG.md) for more details.
Feature Highlights
🏁 High performance: improving response rates and enabling real-time applications.\ 🪂 ACID compliance: Atomic, Consistent, Isolated, Durable.\ 🔗 Relations: object links / relationships are built-in.\ 🌱 Scalable: grows with your needs, handling millions of objects with ease.\ 💐 Queries: filter data as needed, even across relations.\ 🦮 Statically typed: compile time checks & optimizations.\ 💻 Multiplatform: Linux, Windows, Android, iOS, macOS.\ 📃 Automatic schema migrations: no update scripts needed.\ 👥 ObjectBox Sync: keeps data in sync between devices and servers.\ 🕒 ObjectBox TS: time series extension for time based data.
And some more technical details:
- Zero-copy reads for highest possible performance; access tens of millions of objects on commodity hardware
- Lightweight for smart devices; its binary size is only around 1 MB (special feature reduced versions with 1/3 - 1/2 size are available on request)
- Direct support for FlatBuffers data objects (aka "flatbuffers table")
- Secondary indexes based on object properties
- Async API for asynchronous puts, inserts, updates, removes
- Optimized Time series types (TS edition only)
- Data synchronization across the network (sync edition only)
Usage and Installation
In most cases you want to use the C and C++ APIs in combination with the ObjectBox Generator tool. This way, you get a convenient C or C++ API which requires minimal code on your side to work with the database.
The APIs come as single header file for C and C++:
- C: [include/objectbox.h](include/objectbox.h)
- C++: [include/objectbox.hpp](include/objectbox.hpp) (depends on objectbox.h)
Compile your code against it and use the binary library (.so, .dylib, .dll depending on the platform) to link against. Head over to ObjectBox C and C++ installation docs for step-by-step instructions.
C++ API
The C++ API is built on top of the C API exposed by the library (e.g. you still need objectbox.h).
You can also use both APIs from your code if necessary.
For example, you use the C++ obx::Box
class for most database operations, but "break out" into the C API for a special function you need.
Note that to use the obx::Box
class, you also need the ObjectBox Generator to generate binding code.
Find more details how to use it the Getting started section of the docs.
Examples
Have a look at the following TaskList example apps, depending on your programming language and preference:
- [C, cursor, no generated code](examples/c-cursor-no-gen) - plain C; using flatcc directly; without any generated code
- [C, with generated code](examples/c-gen) - plain C, using code generated by
objectbox-generator
- [C++, with generated code](examples/cpp-gen) - C++, using code generated by
objectbox-generator
- also includes sync client application example
Documentation
- C and C++ docs - official ObjectBox C and C++ documentation
- [include/objectbox.h](include/objectbox.h) - C API header file contains docs as code comments
- [include/objectbox.hpp](include/objectbox.hpp) - C++ API header file contains docs as code comments
- C and C++ API reference docs - online HTML docs (Doxygen)
Current state / Changelog
The C API is a thin wrapper around a robust DB core, which is version 2.x and already used on millions of devices.
Beta notice: the C API will become stable starting from version 1.0. Until then, API improvements may result in breaking changes. For example, functions may still be renamed.
[Changelog](CHANGELOG.md): If you update from a previous version, please check the [changelog](CHANGELOG.md). Besides new features, there may be breaking changes requiring modifications to your code.
Supported platforms:
- Linux 64-bit
- Linux ARMv6hf (e.g. Raspberry PI Zero)
- Linux ARMv7hf (e.g. Raspberry PI 3/4)
- Linux ARMv8/AArch64 (e.g. Raspberry PI 3/4 with a 64 bit OS like Ubuntu)
- MacOS 64-bit
- Windows 32-bit
- Windows 64-bit
C API as the Foundation for Higher Languages
The plain C API (without the Generator) also serves as a basis for ObjectBox bindings in higher languages. For example, the official APIs for Go, Swift, Dart/Flutter and Python rely on the C API. In the same way, you could create an ObjectBox API for another programming language, e.g. for JavaScript. For the C API, data consists of bytes representing FlatBuffers tables, which you can build and read in your language of choice.
License
Copyright 2018-2021 ObjectBox Ltd. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*Note that all licence references and agreements mentioned in the ObjectBox C/C++ database README section above
are relevant to that project's source code only.