1 /* 2 * Copyright 2018 Google Inc. All rights reserved. 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 //! # FlatBuffers 18 //! 19 //! A library for memory-efficient serialization of data. 20 //! 21 //! This crate provides runtime support for the FlatBuffers format in the Rust programming language. 22 //! To use this crate, first generate code with the `flatc` compiler, as described here: <https://google.github.io/flatbuffers/> 23 //! Then, include that code into your project. 24 //! Finally, add this crate to your `Cargo.toml`. 25 //! 26 //! At this time, Rust support is experimental, and APIs may change between minor versions. 27 //! 28 //! At this time, to generate Rust code, you will need the latest `master` version of `flatc`, available from here: <https://github.com/google/flatbuffers> 29 //! (On OSX, you can install FlatBuffers from `HEAD` with the Homebrew package manager.) 30 31 #![cfg_attr(feature = "no_std", no_std)] 32 33 #[cfg(feature = "no_std")] 34 extern crate alloc; 35 36 mod array; 37 mod builder; 38 mod endian_scalar; 39 mod follow; 40 mod get_root; 41 mod primitives; 42 mod push; 43 mod table; 44 mod vector; 45 mod verifier; 46 mod vtable; 47 mod vtable_writer; 48 49 pub use crate::array::{array_init, emplace_scalar_array, Array}; 50 pub use crate::builder::FlatBufferBuilder; 51 pub use crate::endian_scalar::{ 52 byte_swap_f32, byte_swap_f64, emplace_scalar, read_scalar, read_scalar_at, EndianScalar, 53 }; 54 pub use crate::follow::{Follow, FollowStart}; 55 pub use crate::primitives::*; 56 pub use crate::push::Push; 57 pub use crate::table::{buffer_has_identifier, Table}; 58 pub use crate::vector::{follow_cast_ref, SafeSliceAccess, Vector, VectorIter}; 59 pub use crate::verifier::{ 60 ErrorTraceDetail, InvalidFlatbuffer, SimpleToVerifyInSlice, Verifiable, Verifier, 61 VerifierOptions, 62 }; 63 pub use crate::vtable::field_index_to_field_offset; 64 pub use bitflags; 65 pub use get_root::*; 66 67 // TODO(rw): Unify `create_vector` and `create_vector_direct` by using 68 // `Into<Vector<...>>`. 69 // TODO(rw): Split fill ops in builder into fill_small, fill_big like in C++. 70