taped 1.0.1

A lightweight cursor for non-linear parsing of slices.
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

# taped


A lightweight cursor for non-linear parsing of byte slices.

[![Crates.io](https://img.shields.io/crates/v/taped.svg)](https://crates.io/crates/taped)

## Documentation


[https://docs.rs/taped](https://docs.rs/taped)

## Overview


`Tape` wraps a byte slice with a position cursor, providing methods for
scanning, backtracking, and consuming bytes without allocating.
[`memchr`](https://github.com/BurntSushi/memchr) is used to provide SIMD-optimized
functions for fixed-length character search.

Originally developed as the byte reader for [`bincake`](https://github.com/aeckar/bincake),
extracted as a standalone primitive after the same pattern appeared
across multiple projects.

## Example


```rust
use taped::Tape;

let data = b"hello world";
let mut tape = Tape::new(data);

tape.seek(|&b| b == b' '); // advance to space
let word = tape.consume(|&b| b != b' '); // consume "hello"
assert_eq!(word, b"hello");
```

## When to use this


- Writing a parser for a binary or text format
- Scanning byte sequences without regex or [`nom`](https://github.com/rust-bakery/nom)
- Anywhere you need backtracking via cheap position snapshots (`tape.clone()`)

## When not to use this


- Full parser combinator framework → use [`nom`](https://github.com/rust-bakery/nom) or [`winnow`](https://github.com/winnow-rs/winnow)
- Lexer generation → use [`logos`](https://github.com/maciejhirsz/logos)
- Async byte streams → use [`tokio::io::AsyncBufRead`](https://docs.rs/tokio/latest/tokio/io/trait.AsyncBufRead.html)