Crate display_bytes

Human-readable display of byte sequences.

Supports printing of both UTF-8 and ASCII-only sequences.

For easy usage, see the free functions display_bytes() and display_bytes_string() in this crate. For more control over formatting, see the statics in this crate or build an instance of DisplayBytesConfig yourself.

extern crate display_bytes;
 
use display_bytes::{display_bytes, display_bytes_string};
 
fn main() {
    let bytes = b"Hello, world!\x89\x90\xAB\xCD";
    println!("{:?}", bytes);
    println!("{}", display_bytes(bytes));
    assert_eq!(display_bytes_string(bytes),
               "Hello, world! {{ 89 90 AB CD }} ");
}

Structs

DisplayBytes	A wrapper around a byte sequence which implements Display.
DisplayBytesConfig	Configuration builder for DisplayBytes.
FormatBase64	Formats byte sequences in Base-64.
FormatHex	Formats bytes in hexadecimal pairs (00 - FF).

Constants

BASE64_ASCII	Prints byte sections as Base-64 wrapped in {{ }}. Prints only ASCII sequences.
BASE64_UTF8	Prints byte sections as Base-64 wrapped in {{ }}. Prints all valid UTF-8 strings.
DEFAULT_HEX	Default hexadecimal byte format used by this crate.
HEX_ASCII	Prints byte sections with hexadecimal bytes wrapped in {{ }}. Prints only ASCII sequences.
HEX_UTF8	Prints byte sections with hexadecimal bytes wrapped in {{ }}. Prints all valid UTF-8 strings.

Traits

ByteFormat

Formats byte sequences in human-readable representations.

Functions

display_bytes	Wrap a byte slice in an adapter which implements Display.
display_bytes_string	Attempt to convert the byte slice to a string, or else format it to a string using the default DisplayBytesConfig.