sizefmt 0.2.0

sizefmt

A small library to format file sizes.

Synopsis

unittest
{
    assert("%s".format(Size(1)) == "1 B");
    assert("%s".format(Size(42)) == "42 B");
    assert("%g".format(Size(1024)) == "1 KB");
    assert("%.2f".format(Size(2_590_000)) == "2.47 MB");
}

You can control the formatting by creating a new type with different options:

unittest
{
    alias MySize = SizeBase!(config!`{
        symbol: "O",
        unitName: "octet",
        unitNamePlural: "octets",
        prefixUse: PrefixUse.IEC,
        spacing: Spacing.tabular,
        useNameIfNoPrefix: true
    }`);
    
    assert("|%4.1f|".format(MySize(1))         == "|   1 octet |");
    assert("|%4.1f|".format(MySize(42))        == "|  42 octets|");
    assert("|%4.1f|".format(MySize(1024))      == "| 1.0 KiO   |");
    assert("|%4.1f|".format(MySize(2_590_000)) == "| 2.5 MiO   |");
}

License: BSL 1.0

Copyright 2014, Nicolas Sicard