FlatBuffers: Memory Efficient Serialization Library
Go to file
mustiikhalil 1f4a9038ce
[Swift] Improves vectors performance & arrays within lib (#8415)
* Improves vectors performance and adds a benchmark to vectors of offsets in swift

Improves performance for all arrays and for loops

Uses a tuple instead of allocating a struct each time we start iterating over fieldloc

Updates benchmark library

* Fixing swift Wasm ci
2024-11-19 07:02:47 +01:00
.bazelci Bazel: Just target flatc and flatbuffers_test for presubmit 2024-08-19 16:42:51 -07:00
.github [Swift] Improves vectors performance & arrays within lib (#8415) 2024-11-19 07:02:47 +01:00
CMake FlatBuffers Version v24.3.25 2024-03-26 05:18:07 +00:00
android FlatBuffers Version v24.3.25 2024-03-26 05:18:07 +00:00
bazel [grpc] Support latest version of grpc PoC (#6338) 2021-03-25 12:12:35 -07:00
benchmarks [Swift] Improves vectors performance & arrays within lib (#8415) 2024-11-19 07:02:47 +01:00
conan remove travis config (#7522) 2022-09-10 12:36:51 -07:00
dart dart: use enhanced enums (#8313) 2024-11-18 17:31:19 +00:00
docs [gRPC] Update the code generator for Python to produce typed handlers (#8326) 2024-06-18 16:02:57 -07:00
examples/go-echo Go: make generated code more compliant to "go fmt" (#7907) 2023-04-26 05:19:07 +00:00
go Support file_identifier in Go (#7904) 2023-04-26 05:15:09 +00:00
goldens FlatBuffers Version v24.3.25 2024-03-26 05:18:07 +00:00
grpc Update grpc-core version (#8412) 2024-10-05 18:24:05 -07:00
include FlexBuffers: support "natural utf8" output in ToString (#8426) 2024-10-12 14:34:06 -07:00
java FlatBuffers Version v24.3.25 2024-03-26 05:18:07 +00:00
js [JS/TS] Rewrite flexbuffers JS to TS (#6148) 2020-10-19 13:11:35 -07:00
kotlin Update libs.versions.toml (#8387) 2024-09-06 01:26:51 +00:00
lobster [Lobster] file_identifier support 2022-03-08 15:39:12 -08:00
lua [Lua] manipulate byte array as string (#6624) 2021-05-07 22:57:13 -07:00
mjs [JS/TS] Modernize TypeScript / JavaScript flatbuffers support (#6095) 2020-09-17 12:21:14 -07:00
net/FlatBuffers [.NET] Add netstandard2.0 as target (#8295) 2024-05-28 18:07:43 -07:00
nim [Nim] Bfbs Nim Generator (#7534) 2022-10-21 14:30:04 -04:00
php Fix PHP byte validation and reenable builds (#7670) 2022-11-29 08:12:28 -08:00
python Fixes LICENSE file in python 2024-08-19 16:09:27 -07:00
reflection [Bazel] Fix gen_reflections for flatbuffers_ts_library (#7981) 2023-05-31 18:07:37 +00:00
rust use ALIGN for Push::alignment in struct types (#8398) 2024-10-28 08:42:55 -07:00
samples Removes 'size' and 'alignment' as Rust keywords (#8139) 2024-11-12 05:13:02 +00:00
scripts Update release.sh (#8322) 2024-05-28 18:44:37 -07:00
snap use improved versioning (#6691) 2021-06-11 15:27:59 -07:00
src dart: use enhanced enums (#8313) 2024-11-18 17:31:19 +00:00
swift [Swift] Improves vectors performance & arrays within lib (#8415) 2024-11-19 07:02:47 +01:00
tests [Swift] Improves vectors performance & arrays within lib (#8415) 2024-11-19 07:02:47 +01:00
ts Remove npm/rules_js dependency for C++ only use cases (#7990) 2024-04-18 05:06:06 +00:00
.bazelignore Remove npm/rules_js dependency for C++ only use cases (#7990) 2024-04-18 05:06:06 +00:00
.bazelrc Trying to fix bazel on macOS and Xcode 14.3 (#8304) 2024-05-28 17:29:41 -07:00
.clang-format Made all C++ files clang-formatted. 2017-12-21 11:45:02 -08:00
.clang-tidy Add clang-tidy, fix some bugpron problems. (#7708) 2022-12-14 21:58:55 -08:00
.editorconfig Editorconfig: als configure to trim whitespaces end EOL. (#7833) 2023-02-27 19:56:18 -08:00
.eslintrc.js [JS/TS] Modernize TypeScript / JavaScript flatbuffers support (#6095) 2020-09-17 12:21:14 -07:00
.gitattributes Unify line ending rules in '.editorconfig' and '.gitattributes' (#5231) 2019-03-18 12:47:07 -07:00
.gitignore [BinaryAnnotator] Add more options that control the generation of `.afb` files (#8323) 2024-05-29 13:34:38 -07:00
.npmrc Migrate from rules_nodejs to rules_js/rules_ts (take 2) (#7928) 2023-05-03 11:48:15 -07:00
BUILD.bazel [Python] Generate `.pyi` stub files when `--python-typing` is on. (#8312) 2024-05-29 12:47:29 -07:00
CHANGELOG.md FlatBuffers Version v24.3.25 2024-03-26 05:18:07 +00:00
CMakeLists.txt [gRPC] Update the code generator for Python to produce typed handlers (#8326) 2024-06-18 16:02:57 -07:00
CONTRIBUTING.md Fixed link to Google C++ Style Guide. 2017-02-08 16:37:25 -08:00
FlatBuffers.podspec [Swift] Updates CocoaPods author info & fixes bug with versioning not working as expected (#8328) 2024-10-05 00:17:05 +02:00
Formatters.md Ran clang-format-all.sh. Removed default --style=file parameter (#6639) 2021-05-15 12:54:08 -07:00
LICENSE Rename LICENSE.txt to LICENSE (#7808) 2023-01-30 21:36:30 -08:00
MODULE.bazel [Python] Generate `.pyi` stub files when `--python-typing` is on. (#8312) 2024-05-29 12:47:29 -07:00
MODULE.bazel.lock [Python] Generate `.pyi` stub files when `--python-typing` is on. (#8312) 2024-05-29 12:47:29 -07:00
Package.swift Sets Swift minimum version to 5.8 (#8228) 2024-05-29 13:07:54 -07:00
README.md docs: update README.md (#8383) 2024-09-05 18:50:35 -07:00
SECURITY.md Create Security.md 2021-05-19 11:55:50 -07:00
WORKSPACE Trying to fix bazel on macOS and Xcode 14.3 (#8304) 2024-05-28 17:29:41 -07:00
build_defs.bzl [Bazel] Fix gen_reflections for flatbuffers_ts_library (#7981) 2023-05-31 18:07:37 +00:00
composer.json (PHP) add experimental support for PHP language. 2015-11-18 00:26:39 +09:00
conanfile.py Updated remaining usages of LICENSE.txt 2023-03-03 12:01:08 -08:00
package.json FlatBuffers Version v24.3.25 2024-03-26 05:18:07 +00:00
pnpm-lock.yaml [TS/JS] Upgrade dependencies (#7996) 2023-12-13 16:57:46 -08:00
swift.swiftformat Sets Swift minimum version to 5.8 (#8228) 2024-05-29 13:07:54 -07:00
tsconfig.json Simplify and fix TypeScript compilation output (#7815) 2023-02-06 13:10:20 -08:00
tsconfig.mjs.json [TS/JS] Upgrade dependencies (#7996) 2023-12-13 16:57:46 -08:00
typescript.bzl Migrate from rules_nodejs to rules_js/rules_ts (take 2) (#7928) 2023-05-03 11:48:15 -07:00

README.md

logo FlatBuffers

Build status BuildKite status Fuzzing Status OpenSSF Scorecard Join the chat at https://gitter.im/google/flatbuffers Discord Chat Twitter Follow Twitter Follow

FlatBuffers is a cross platform serialization library architected for maximum memory efficiency. It allows you to directly access serialized data without parsing/unpacking it first, while still having great forwards/backwards compatibility.

Quick Start

  1. Build the compiler for flatbuffers (flatc)

    Use cmake to create the build files for your platform and then perform the compilation (Linux example).

    cmake -G "Unix Makefiles"
    make -j
    
  2. Define your flatbuffer schema (.fbs)

    Write the schema to define the data you want to serialize. See monster.fbs for an example.

  3. Generate code for your language(s)

    Use the flatc compiler to take your schema and generate language-specific code:

    ./flatc --cpp --rust monster.fbs
    

    Which generates monster_generated.h and monster_generated.rs files.

  4. Serialize data

    Use the generated code, as well as the FlatBufferBuilder to construct your serialized buffer. (C++ example)

  5. Transmit/store/save Buffer

    Use your serialized buffer however you want. Send it to someone, save it for later, etc...

  6. Read the data

    Use the generated accessors to read the data from the serialized buffer.

    It doesn't need to be the same language/schema version, FlatBuffers ensures the data is readable across languages and schema versions. See the Rust example reading the data written by C++.

Documentation

Go to our landing page to browse our documentation.

Supported operating systems

  • Windows
  • macOS
  • Linux
  • Android
  • And any others with a recent C++ compiler (C++ 11 and newer)

Supported programming languages

Code generation and runtime libraries for many popular languages.

  1. C
  2. C++ - snapcraft.io
  3. C# - nuget.org
  4. Dart - pub.dev
  5. Go - go.dev
  6. Java - Maven
  7. JavaScript - NPM
  8. Kotlin
  9. Lobster
  10. Lua
  11. PHP
  12. Python - PyPI
  13. Rust - crates.io
  14. Swift - swiftpackageindex
  15. TypeScript - NPM
  16. Nim

Versioning

FlatBuffers does not follow traditional SemVer versioning (see rationale) but rather uses a format of the date of the release.

Contribution

To contribute to this project, see CONTRIBUTING.

Community

Security

Please see our Security Policy for reporting vulnerabilities.

Licensing

Flatbuffers is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.