Struct ByteSequence 

pub struct ByteSequence { /* private fields */ }

A struct representing a sequence of bytes. It provides methods to create an empty sequence and compute the next lexicographical sequence.

Examples

let seq = ByteSequence::from("abc");
let next_seq = seq.next();
assert_eq!(next_seq.as_bytes(), b"abd");

Implementations

impl ByteSequence

pub fn as_bytes(&self) -> &[u8]

pub fn empty() -> Self

Creates an empty ByteSequence.

Examples

let empty_seq = ByteSequence::empty();
assert_eq!(empty_seq.as_bytes(), b"\0");

pub fn next(&self) -> Self

Computes the next lexicographical byte sequence. If the current sequence is empty, it returns an empty sequence. If all bytes are at their maximum value, it returns an empty sequence. If the last byte can be incremented, it increments it and truncates the sequence.

Examples

• Basic test case

let from = ByteSequence::from("abc");
let next_seq = from.next();
assert_eq!(next_seq, ByteSequence::from("abd"));

• Test case with 0xff bytes

let from = ByteSequence::from(b"ab\xff\xff" as &[u8]); // [0x61,0x62,0xff,0xff]
let next_seq = from.next();
assert_eq!(next_seq.as_bytes(), b"ac");

• Test case where all bytes are 0xff

let from = ByteSequence::from(b"\xff\xff" as &[u8]); // [0xff,0xff]
let next_seq = from.next();
assert_eq!(next_seq.as_bytes(), ByteSequence::empty().as_bytes());

pub fn to_vec(&self) -> Vec<u8>

Trait Implementations

impl Clone for ByteSequence

fn clone(&self) -> ByteSequence

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ByteSequence

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&[u8]> for ByteSequence

fn from(value: &[u8]) -> Self

Converts to this type from the input type.

impl From<&str> for ByteSequence

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<String> for ByteSequence

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for ByteSequence

fn from(value: Vec<u8>) -> Self

Converts to this type from the input type.

impl PartialEq for ByteSequence

fn eq(&self, other: &ByteSequence) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ByteSequence

impl StructuralPartialEq for ByteSequence