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 into the StringExt, or panic in debug mode, work normally but slower in release mode (unless feature feat-unsafe is enabled and you will come across with UB).

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 rand_str = RandHexStr::new_default().to_string_ext();
assert_eq!(rand_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 rand_str = RandHexStr::<16, 3, 8>::new().to_string_ext();
assert_eq!(rand_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 push_to_string(self, string: &mut Vec<u8>)

Push the value to the string.

fn push_to_string_with_separator( self, string: &mut Vec<u8>, separator: impl SeparatorT, )

Push the value to the string with a separator.

fn to_string_ext(self) -> String

Encode the value to the string.

fn to_string_ext_with_sep(self, separator: impl SeparatorT) -> String

Push the value to the string with separator

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

With prefix.

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

With suffix.

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