scroll-buffer 0.3.1

Extra writable buffers for Scroll
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
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# scroll-buffer
[![Cargo](https://github.com/nickbclifford/scroll-buffer/actions/workflows/cargo.yml/badge.svg)](https://github.com/nickbclifford/scroll-buffer/actions/workflows/cargo.yml)
[![Crates.io](https://img.shields.io/crates/v/scroll-buffer)](https://crates.io/crates/scroll-buffer)

Additional `Pwrite` buffers for use with [Scroll](https://github.com/m4b/scroll).

## Documentation
Docs are available at [docs.rs](https://docs.rs/scroll-buffer/0.2.0/scroll_buffer/).

## Overview
Since Scroll's writing traits are generic over their destination buffer, if you find
the default mutable byte slice too restrictive, you can use the types in this crate
for more powerful features like dynamic allocation.

Currently, this crate only defines one such buffer: the `DynamicBuffer` type, which
grows on-demand when writing types into it.

## Usage
Add to your `Cargo.toml`:
```toml
[dependencies]
scroll-buffer = "0.3.0"
```

You can now change your `TryIntoCtx` implementations and start writing!

```rust
use scroll::{LE, Pwrite, ctx::TryIntoCtx};
use scroll_buffer::DynamicBuffer;

fn main() -> Result<(), scroll::Error> {
    let mut buf = DynamicBuffer::new();
    
    // works with regular ints, of course...
    buf.pwrite_with(0xbeefu16, 0, LE)?;
    assert_eq!(buf.get(), [0xef, 0xbe]);
    
    // ...but also custom types!
    struct MyCoolStruct(bool, u32);
    impl TryIntoCtx<(), DynamicBuffer> for MyCoolStruct {
        type Error = scroll::Error;

        fn try_into_ctx(self, buf: &mut DynamicBuffer, _: ()) -> Result<usize, Self::Error> {
            let offset = &mut 0;
            
            if self.0 {
                buf.gwrite_with(0xffu8, offset, LE)?;
            } else {
                buf.gwrite_with(self.1, offset, LE)?;
            }
            
            Ok(*offset)
        }
    }
    
    buf.clear();
    buf.pwrite(MyCoolStruct(false, 1), 0)?;
    assert_eq!(buf.get(), [0x01, 0x00, 0x00, 0x00]);
    
    buf.pwrite(MyCoolStruct(true, 0), 4)?;
    assert_eq!(buf.get(), [0x01, 0x00, 0x00, 0x00, 0xff]);
    
    Ok(())
}
```