[−][src]Crate ubyte
A simple, complete, const
-everything, saturating, human-friendly,
#![no_std]
library for byte units.
use ubyte::{ByteUnit, ToByteUnit}; // Constructors and associated units for all SI units up to exbibyte. let half_mb = 500.kilobytes(); let half_mb = ByteUnit::Kilobyte(500); let half_mb = 500 * ByteUnit::kB; // All arithmetic operations and conversions saturate. let exbibyte_too_large_a = 1024 * ByteUnit::EiB; let exbibyte_too_large_b = ByteUnit::Exbibyte(1024); let exbibyte_too_large_c = 1024.exbibytes(); assert_eq!(exbibyte_too_large_a, ByteUnit::max_value()); assert_eq!(exbibyte_too_large_b, ByteUnit::max_value()); assert_eq!(exbibyte_too_large_c, ByteUnit::max_value()); // Printing is human-friendly and customizeable. assert_eq!(323.kilobytes().to_string(), "323kB"); assert_eq!(3.mebibytes().to_string(), "3MiB"); assert_eq!((7.gigabytes() + 58.mebibytes() + 3.kilobytes()).to_string(), "7.06GB"); assert_eq!(format!("{:.0}", 7.gibibytes() + 920.mebibytes()), "8GiB"); assert_eq!(format!("{:.3}", 7.gibibytes() + 920.mebibytes()), "7.898GiB"); assert_eq!(format!("{:04.2}", 999.kilobytes() + 990.bytes()), "0976.55KiB"); assert_eq!(format!("{:02.0}", 999.kilobytes() + 990.bytes()), "01MB");
Overview
-
ByteUnit
constructors --ByteUnit::Byte
and friends -- for all SI units of bytes up to the exbibyte are provided; all constructors areconst
and saturating. Associated constants --ByteUnit::B
and friends -- for1
-valued units are provided. Saturating arithmetic operations betweenByteUnit
and all integers types are implemented.From<{integer}> for ByteUnit
for all integer types is implemented.From<ByteUnit> for {u64, u128}>
is implemented. -
ToByteUnit
provides human-friendly methods on all integer types for converting into aByteUnit
:512.kilobytes()
. -
The
Display
implementation displaysByteUnit
s in a human-friendly format. For truly custom printing,ByteUnit::repr()
splits a value into its minimal components. -
The
FromStr
implementation parses byte units in a case-free manner:1B
or1b
or1 b
=>1.bytes()
. -
With the
serde
feaure enabled (disabled by default),ByteUnit
implementsDeserialize
from strings and all integer types as well asSerialize
into au64
. -
All operations -- constructors, arithmetic, conversions -- saturate. Overflow, underflow, and divide-by-zero are impossible.
Structs
ByteUnit | A unit of bytes with saturating |
Traits
ToByteUnit | Extension trait for conversion from integer types to |