Struct RandHexStr

pub struct RandHexStr<const L: usize = 16, const RP: usize = 1, const LP: usize = 0>;

Randon hex-like string, with fix length.

For better performance, the underlying random number is generated by xorshift algorithm then converted to hex string with NumStr.

By default, the length is 16.

Generic Parameters

• L: The length of the string. Max 16 (u64).
• RP: Repeat L for RP times.
• LP: Lefted length. Max 16.

For example, if you need a string with length 56, you may specify L as 16, RP as 56 / 16 = 3, and LP as 56 % 16 = 8.

Since #![feature(generic_const_exprs)] is not stable, we have to make use of these complex const generics.

Notice: will check if params are valid when you push this to a string, or panic in debug mode, work normally but slower in release mode.

Implementations

impl RandHexStr

pub const fn new_default() -> Self

Create a new RandHexStr and generate simple random hex-like string with length 16 (default).

Example

let random_str = RandHexStr::new_default().to_string_ext();
assert_eq!(random_str.len(), 16);

impl<const L: usize, const RP: usize, const LP: usize> RandHexStr<L, RP, LP>

pub const fn new() -> Self

Create a new RandStr and generate random hex-like string with length setting by L, RP, LP.

Example

let random_str = RandHexStr::<16, 3, 8>::new().to_string_ext();
assert_eq!(random_str.len(), 56);

pub const fn with_l<const NL: usize>(self) -> RandHexStr<NL, RP, LP>

Set L.

You may prefer RandHexStr::<L, RP, LP>::new.

pub const fn with_rp<const NRP: usize>(self) -> RandHexStr<L, NRP, LP>

Set RP.

You may prefer RandHexStr::<L, RP, LP>::new.

pub const fn with_lp<const NLP: usize>(self) -> RandHexStr<L, RP, NLP>

Set LP.

You may prefer RandHexStr::<L, RP, LP>::new.

Trait Implementations

impl<const L: usize, const RP: usize, const LP: usize> Clone for RandHexStr<L, RP, LP>

fn clone(&self) -> RandHexStr<L, RP, LP>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<const L: usize, const RP: usize, const LP: usize> Debug for RandHexStr<L, RP, LP>

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

Formats the value using the given formatter.

impl<const L: usize, const RP: usize, const LP: usize> Default for RandHexStr<L, RP, LP>

fn default() -> RandHexStr<L, RP, LP>

Returns the “default value” for a type.

impl<const L: usize, const RP: usize, const LP: usize> StringExtT for RandHexStr<L, RP, LP>

fn with_prefix<P: StringExtT + Copy>(self, prefix: P) -> impl StringExtT

With prefix.

fn with_suffix<S: StringExtT + Copy>(self, suffix: S) -> impl StringExtT

With suffix.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_separator(self, separator: &str) -> String

Encode the value(s) to the string with separator.

impl<const L: usize, const RP: usize, const LP: usize> StringT for RandHexStr<L, RP, LP>

fn encode_to_buf(self, string: &mut Vec<u8>)

Push the value to the string (the underlying Vec<u8>).

fn encode_to_buf_with_separator(self, string: &mut Vec<u8>, separator: &str)

Push the value to the string (the underlying Vec<u8>) with a separator.

fn encode_to_bytes_buf(self, string: &mut BytesMut)

Push the value to the string (the underlying bytes::BytesMut).

fn encode_to_bytes_buf_with_separator( self, string: &mut BytesMut, separator: &str, )

Push the value to the string (the underlying bytes::BytesMut) with a separator.

impl<const L: usize, const RP: usize, const LP: usize> Copy for RandHexStr<L, RP, LP>