arrow_buffer/lib.rs
1// Licensed to the Apache Software Foundation (ASF) under one
2// or more contributor license agreements. See the NOTICE file
3// distributed with this work for additional information
4// regarding copyright ownership. The ASF licenses this file
5// to you under the Apache License, Version 2.0 (the
6// "License"); you may not use this file except in compliance
7// with the License. You may obtain a copy of the License at
8//
9// http://www.apache.org/licenses/LICENSE-2.0
10//
11// Unless required by applicable law or agreed to in writing,
12// software distributed under the License is distributed on an
13// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14// KIND, either express or implied. See the License for the
15// specific language governing permissions and limitations
16// under the License.
17
18//! Low-level buffer abstractions for [Apache Arrow Rust](https://docs.rs/arrow)
19//!
20//! # Byte Storage abstractions
21//! - [`MutableBuffer`]: Raw memory buffer that can be mutated and grown
22//! - [`Buffer`]: Immutable buffer that is shared across threads
23//!
24//! # Typed Abstractions
25//!
26//! There are also several wrappers over [`Buffer`] with methods for
27//! easier manipulation:
28//!
29//! - [`BooleanBuffer`][]: Bitmasks (buffer of packed bits)
30//! - [`NullBuffer`][]: Arrow null (validity) bitmaps ([`BooleanBuffer`] with extra utilities)
31//! - [`ScalarBuffer<T>`][]: Typed buffer for primitive types (e.g., `i32`, `f64`)
32//! - [`OffsetBuffer<O>`][]: Offsets used in variable-length types (e.g., strings, lists)
33//! - [`RunEndBuffer<E>`][]: Run-ends used in run-encoded encoded data
34
35#![doc(
36 html_logo_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_white-bg.svg",
37 html_favicon_url = "https://arrow.apache.org/img/arrow-logo_chevrons_black-txt_transparent-bg.svg"
38)]
39#![cfg_attr(docsrs, feature(doc_cfg))]
40#![warn(missing_docs)]
41
42pub mod alloc;
43pub mod buffer;
44pub use buffer::*;
45
46pub mod builder;
47pub use builder::*;
48
49mod bigint;
50pub use bigint::i256;
51
52mod bytes;
53
54mod native;
55pub use native::*;
56
57mod util;
58pub use util::*;
59
60mod interval;
61pub use interval::*;
62
63mod arith;
64
65#[cfg(feature = "pool")]
66mod pool;
67#[cfg(feature = "pool")]
68pub use pool::*;