damus

nostr ios client
git clone git://jb55.com/damus
Log | Files | Refs | README | LICENSE

Documentation.md (1902B)


      1 # ``FlatBuffers``
      2 
      3 FlatBuffers: Memory Efficient Serialization Library
      4 
      5 ## Overview
      6 
      7 - Access to serialized data without parsing/unpacking - What sets FlatBuffers apart is that it represents hierarchical data in a flat binary buffer in such a way that it can still be accessed directly without parsing/unpacking, while also still supporting data structure evolution (forwards/backwards compatibility).
      8 - Memory efficiency and speed - The only memory needed to access your data is that of the buffer. It requires 0 additional allocations (in C++, other languages may vary). FlatBuffers is also very suitable for use with mmap (or streaming), requiring only part of the buffer to be in memory. Access is close to the speed of raw struct access with only one extra indirection (a kind of vtable) to allow for format evolution and optional fields. It is aimed at projects where spending time and space (many memory allocations) to be able to access or construct serialized data is undesirable, such as in games or any other performance sensitive applications. See the benchmarks for details.
      9 - Flexible - Optional fields means not only do you get great forwards and backwards compatibility (increasingly important for long-lived games: don't have to update all data with each new version!). It also means you have a lot of choice in what data you write and what data you don't, and how you design data structures.
     10 - Tiny code footprint - Small amounts of generated code, and just a single small header as the minimum dependency, which is very easy to integrate. Again, see the benchmark section for details.
     11 - Strongly typed - Errors happen at compile time rather than manually having to write repetitive and error prone run-time checks. Useful code can be generated for you.
     12 
     13 ## Topics
     14 
     15 ### Read this first
     16 
     17 - <doc:Tutorial_Table_of_Contents>
     18 
     19 ### Where to start
     20 
     21 - ``FlatBufferBuilder``
     22 - ``ByteBuffer``