#string #debug #ascii

byte_string

Wrapper types for outputting byte strings (b"Hello") using the Debug ({:?}) format

1 stable release

Uses old Rust 2015

1.0.0 Sep 26, 2016

#839 in Text processing

Download history 3235/week @ 2023-11-21 3156/week @ 2023-11-28 5826/week @ 2023-12-05 4588/week @ 2023-12-12 3156/week @ 2023-12-19 2426/week @ 2023-12-26 4250/week @ 2024-01-02 4017/week @ 2024-01-09 4322/week @ 2024-01-16 3907/week @ 2024-01-23 9252/week @ 2024-01-30 9679/week @ 2024-02-06 9269/week @ 2024-02-13 8216/week @ 2024-02-20 8525/week @ 2024-02-27 10794/week @ 2024-03-05

38,312 downloads per month
Used in 10 crates (8 directly)

MIT/Apache

15KB
333 lines

byte_string Build Status

The byte_string crate provides two types: ByteStr and ByteString. Both types provide a Debug implementation that outputs the slice using the Rust byte string syntax. ByteStr wraps a byte slice ([u8]). ByteString wraps a vector of bytes (Vec<u8>).

For example:

extern crate byte_string;

use byte_string::ByteStr;

fn main() {
    let s = b"Hello, world!";
    let bs = ByteStr::new(s);
    assert_eq!(format!("{:?}", bs), "b\"Hello, world!\"");
}

ByteStr is an unsized type, as [u8] is. ByteStr::new() returns a &ByteStr and ByteStr::new_mut() returns a &mut ByteStr.

ByteStr and ByteString are meant to be used as an implementation detail. You should generally avoid exposing a ByteStr or a ByteString as part of a struct or enum; prefer exposing the underlying slice or vector instead. However, ByteStr and ByteString implement many traits, including derivable traits, which makes them suitable for use as a private member of a struct or enum.

License

byte_string is licensed under the terms of both the MIT license and the Apache License, version 2.0.

No runtime deps