DataSize.php

Go to the documentation of this file.

<?php

namespace ILIAS\Data;

final class DataSize
{
    const Byte = 1;

    //binary
    const KiB = 1024;
    const MiB = 1048576;      //pow(1024, 2)
    const GiB = 1073741824;
    const TiB = 1099511627776;
    const PiB = 1125899906842624;
    const EiB = 1152921504606846976;
    const ZiB = 1180591620717411303424;
    const YiB = 1208925819614629174706176;

    //decimal
    const KB = 1000;                            //kilobyte
    const MB = 1000000;                         //megabyte
    const GB = 1000000000;                      //gigabyte
    const TB = 1000000000000;                   //terabyte
    const PB = 1000000000000000;                //petabyte
    const EB = 1000000000000000000;             //exabyte
    const ZB = 1000000000000000000000;          //zettabyte
    const YB = 1000000000000000000000000;       //yottabyte
    private static $suffixMap = [
        self::Byte => 'B',

        self::KB => 'KB',
        self::KiB => 'KiB',

        self::MB => 'MB',
        self::MiB => 'MiB',

        self::GB => 'GB',
        self::GiB => 'GiB',

        self::TB => 'TB',
        self::TiB => 'TiB',

        self::PB => 'PB',
        self::PiB => 'PiB',

        self::EB => 'EB',
        self::EiB => 'EiB',

        self::ZB => 'ZB',
        self::ZiB => 'ZiB',

        self::YB => 'YB',
        self::YiB => 'YiB'
    ];
    private $size;
    private $unit;
    private $suffix;

    public function __construct($size, $unit)
    {
        if (!is_int($size)) {
            throw new \InvalidArgumentException("Size must be of the type int.");
        }

        if (!is_int($unit)) {
            throw new \InvalidArgumentException("Unit must be of the type int.");
        }

        if (!isset(self::$suffixMap[$unit])) {
            throw new \InvalidArgumentException('The given data size unit is not valid, please check the provided class constants of the DataSize class.');
        }

        $this->size = (float) $size / $unit; //the div operation can return int and float
        $this->unit = $unit;
        $this->suffix = self::$suffixMap[$unit];
    }

    public function getSize()
    {
        return $this->size;
    }


    public function getUnit()
    {
        return $this->unit;
    }

    public function __toString()
    {
        return "{$this->size} {$this->suffix}";
    }
}