Struct Bytesize

pub struct Bytesize(pub usize);

Human-readable byte size representation with parsing/serialization support

Example:

use rmqtt_utils::Bytesize;

// Create from string
let size = Bytesize::try_from("2G512M").unwrap();
assert_eq!(size.as_usize(), 2_684_354_560);

// Create from integer
let size = Bytesize::from(1024);
assert_eq!(size.string(), "1K");

Tuple Fields

0: usize

Implementations

impl Bytesize

pub fn as_u32(&self) -> u32

Convert to u32 (may truncate on 32-bit platforms)

Example:

let size = rmqtt_utils::Bytesize(5000);
assert_eq!(size.as_u32(), 5000);

pub fn as_u64(&self) -> u64

Convert to u64

Example:

let size = rmqtt_utils::Bytesize(usize::MAX);
assert_eq!(size.as_u64(), usize::MAX as u64);

pub fn as_usize(&self) -> usize

Get underlying usize value

Example:

let size = rmqtt_utils::Bytesize(1024);
assert_eq!(size.as_usize(), 1024);

pub fn string(&self) -> String

Format bytesize to human-readable string

Example:

let size = rmqtt_utils::Bytesize(3145728);
assert_eq!(size.string(), "3M");

let mixed = rmqtt_utils::Bytesize(2148532224);
assert_eq!(mixed.string(), "2G1M");

Methods from Deref<Target = usize>

pub const MIN: usize = 0usize

pub const MAX: usize = 18_446_744_073_709_551_615usize

pub const BITS: u32 = 64u32

Trait Implementations

impl Clone for Bytesize

fn clone(&self) -> Bytesize

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Bytesize

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

Formats the value using the given formatter.

impl Default for Bytesize

fn default() -> Bytesize

Returns the “default value” for a type.

impl Deref for Bytesize

type Target = usize

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Bytesize

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for Bytesize

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Bytesize

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

Formats the value using the given formatter.

impl From<usize> for Bytesize

fn from(v: usize) -> Self

Converts to this type from the input type.

impl FromStr for Bytesize

type Err = ParseSizeError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Serialize for Bytesize

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&str> for Bytesize

type Error = ParseSizeError

The type returned in the event of a conversion error.

fn try_from(v: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Bytesize