Crate typed_bytesize

Typed Bytesize

The library provides two types to represent bytesize:

• ByteSizeSi for decimal prefix unit (SI)
• ByteSizeIec for binary prefix unit (IEC 80000-13)

Functions

• Bytesize types can parse each other’s units (e.g. ByteSizeIec can parse SI values like 114514GB);
• Bytesize values will only be formatted as the unit has their owned prefix;
• Bytesize types can be converted to each other;
• Supporting addition, subtraction, scalar multiplication arithmetic operations;
• Optional serde support.

Example

use typed_bytesize::{ByteSizeIec, ByteSizeSi};

// SI
assert_eq!(ByteSizeSi::b(114u64), "114".parse().unwrap());
assert_eq!(ByteSizeSi::mb(114), "114MB".parse().unwrap());
print!("{}", ByteSizeSi::kb(310)); // 310.0kB

// IEC
assert_eq!(ByteSizeIec::b(514u64), "514".parse().unwrap());
assert_eq!(ByteSizeIec::mib(514), "514MiB".parse().unwrap());
print!("{}", ByteSizeIec::gib(93696)); // 91.5GiB

For more detailed examples, refer to tests.

BNF

Parsing follows the rule:

expr    ::= num | term
term    ::= decimal " "* unit
decimal ::= num | float
float   ::= num "." num
num     ::= [0-9]+

Features

• serde: enable serde on ByteSizeSi and ByteSizeIec.
• u128: use u128 instead of u64 as inner numeric type to support larger units. (TODO)

Structs

• ByteSizeIec
  Binary prefix bytesize
• ByteSizeSi
  Decimal prefix bytesize

Enums

• Error

Constants

• B
  1 byte
• EB
  1 exabyte
• EIB
  1 exbibyte
• GB
  1 gigabyte
• GIB
  1 gibibyte
• KB
  1 kilobyte
• KIB
  1 kibibyte
• MB
  1 megabyte
• MIB
  1 mebibyte
• PB
  1 petabyte
• PIB
  1 pebibyte
• TB
  1 terabyte
• TIB
  1 tebibyte