io-buffer 1.0.7

A buffer abstracted for disk and network IO, with static lifetime. Unify Vec and *libc::c_void into one type, with smallest mem footprint.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# io-buffer

[![Build Status](https://github.com/NaturalIO/io-buffer-rs/workflows/Rust/badge.svg)](
https://github.com/NaturalIO/io-buffer-rs/actions)
[![Cargo](https://img.shields.io/crates/v/io-buffer.svg)](
https://crates.io/crates/io-buffer)
[![Documentation](https://docs.rs/io-buffer/badge.svg)](
https://docs.rs/io-buffer)
[![Rust 1.36+](https://img.shields.io/badge/rust-1.36+-lightgray.svg)](
https://www.rust-lang.org)

This crate provide a 16 Bytes [Buffer] type, to unify the difference of different types of buffer,
for disk and network IO:

* max buffer size 1 << 31,

* Converts owned buffer, `From<Vec<u8>>` and `To<Vec<u8>>`.

* Allocation with [malloc()](Buffer::alloc())

* Allocation with [posix_memalign()](Buffer::aligned())

* Converts from [const reference](Buffer::from_c_ref_const()),  or from
[mutable reference](Buffer::from_c_ref_mut()) of unsafe c code.

On debug mode, provides runtime checking if you try to as_mut() a const buffer.

## Usage

Cargo.toml:

``` toml
[dependencies]
io-buffer = "1"
```

## Feature flags

* compress: enable [Compression] trait

* lz4: enable lz4 compression

* rand: enable `rand_buffer()` function

* fail: enable `fail` injection point "alloc_buf" of return buffer allocate with random uninit content