Collaboration diagram for ILIAS\Data\DataSize:

Public Member Functions
	__construct (int $size, int $unit)
	DataSize constructor. More...

	getSize ()
	The calculated data size. More...

	getUnit ()
	The unit which equals the class constant used to calculate the data size. More...

	inBytes ()
	Get the size in bytes. More...

	__toString ()
	Returns the data size with the corresponding suffix. More...

Data Fields
const	Byte = 1

const	KiB = 1024

const	MiB = 1048576

const	GiB = 1073741824

const	TiB = 1099511627776

const	PiB = 1125899906842624

const	EiB = 1152921504606846976

const	ZiB = 1180591620717411303424

const	YiB = 1208925819614629174706176

const	KB = 1000

const	MB = 1000000

const	GB = 1000000000

const	TB = 1000000000000

const	PB = 1000000000000000

const	EB = 1000000000000000000

const	ZB = 1000000000000000000000

const	YB = 1000000000000000000000000

Static Public Attributes
static	$abbreviations

Private Attributes
	$size

	$unit

	$suffix

Static Private Attributes
static	$suffixMap

Detailed Description

Class DataSize.

This class provides the data size with additional information to remove the work to calculate the size to different unit like GiB, GB usw.

Author: Nicolas Schäfli ns@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Since: 5.3

Version: 1.0

Definition at line 15 of file DataSize.php.

Constructor & Destructor Documentation

◆ __construct()

ILIAS\Data\DataSize::__construct	(	int	$size,
		int	$unit
	)

DataSize constructor.

Parameters

int	$size	The data size in bytes.
int	$unit	The unit which is used to calculate the data size.

Exceptions

Definition at line 126 of file DataSize.php.

References ILIAS\Data\DataSize\$unit.

     {
         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];
     }

Member Function Documentation

◆ __toString()

ILIAS\Data\DataSize::__toString ( )

Returns the data size with the corresponding suffix.

Example output: 1024 B 4096 GiB

Returns: string

Since: 5.3

Definition at line 178 of file DataSize.php.

     {
         return "{$this->size} {$this->suffix}";
     }

◆ getSize()

ILIAS\Data\DataSize::getSize ( )

The calculated data size.

Returns: float

Since: 5.3

Definition at line 143 of file DataSize.php.

References ILIAS\Data\DataSize\$size.

Referenced by ILIAS\Filesystem\Decorator\ReadOnlyDecorator\getSize(), ILIAS\Filesystem\Provider\FlySystem\FlySystemFileAccess\getSize(), ILIAS\Filesystem\FilesystemFacade\getSize(), and ILIAS\Filesystem\Decorator\FilesystemWhitelistDecorator\getSize().

     {
         return $this->size;
     }

Here is the caller graph for this function:

◆ getUnit()

ILIAS\Data\DataSize::getUnit ( )

The unit which equals the class constant used to calculate the data size.

(self::GiB, ...)

Returns: int

Since: 5.3

Definition at line 155 of file DataSize.php.

References ILIAS\Data\DataSize\$unit.

     {
         return $this->unit;
     }

◆ inBytes()

ILIAS\Data\DataSize::inBytes ( )

Get the size in bytes.

Definition at line 163 of file DataSize.php.

References ILIAS\Data\DataSize\$unit.

                               : int
     {
         return $this->size * $this->unit;
     }

Field Documentation

◆ $abbreviations

ILIAS\Data\DataSize::$abbreviations

static

Initial value:

= [

'B' => self::Byte

Definition at line 69 of file DataSize.php.

Referenced by ILIAS\Data\Factory\dataSize().

◆ $size

float ILIAS\Data\DataSize::$size

private

Initial value:

=> self::KB,
        'K' => self::KiB,
        'k' => self::KiB,
        'KiB' => self::KiB,
        'MB' => self::MB,
        'M' => self::MiB,
        'm' => self::MiB,
        'MiB' => self::MiB,
        'GB' => self::GB,
        'G' => self::GiB,
        'g' => self::GiB,
        'GiB' => self::GiB,
        'TB' => self::TB,
        'TiB' => self::TiB,
        'PB' => self::PB,
        'PiB' => self::PiB,
        'EB' => self::EB,
        'EiB' => self::EiB,
        'ZB' => self::ZB,
        'ZiB' => self::ZiB,
        'YB' => self::YB,
        'YiB' => self::YiB
    ]

Definition at line 106 of file DataSize.php.

Referenced by ILIAS\Data\DataSize\getSize().

◆ $suffix

string ILIAS\Data\DataSize::$suffix

private

Definition at line 114 of file DataSize.php.

◆ $suffixMap

ILIAS\Data\DataSize::$suffixMap

staticprivate

Initial value:

= [

self::Byte => 'B'

Definition at line 41 of file DataSize.php.

◆ $unit

int ILIAS\Data\DataSize::$unit

private

Definition at line 110 of file DataSize.php.

Referenced by ILIAS\Data\DataSize\__construct(), ILIAS\Data\DataSize\getUnit(), and ILIAS\Data\DataSize\inBytes().

◆ Byte

const ILIAS\Data\DataSize::Byte = 1

Definition at line 17 of file DataSize.php.

Referenced by ILIAS\Filesystem\Finder\Iterator\SizeRangeFilterIterator\__construct().

◆ EB

const ILIAS\Data\DataSize::EB = 1000000000000000000

Definition at line 35 of file DataSize.php.

◆ EiB

const ILIAS\Data\DataSize::EiB = 1152921504606846976

Definition at line 25 of file DataSize.php.

◆ GB

const ILIAS\Data\DataSize::GB = 1000000000

Definition at line 32 of file DataSize.php.

◆ GiB

const ILIAS\Data\DataSize::GiB = 1073741824

Definition at line 22 of file DataSize.php.

Referenced by ILIAS\Filesystem\Provider\FlySystem\FlySystemFileAccessTest\testGetSizeWithMissingFileWhichShouldFail().

◆ KB

const ILIAS\Data\DataSize::KB = 1000

Definition at line 30 of file DataSize.php.

◆ KiB

const ILIAS\Data\DataSize::KiB = 1024

Definition at line 20 of file DataSize.php.

Referenced by ILIAS\Filesystem\Provider\FlySystem\FlySystemFileAccessTest\testGetSizeWhichShouldSucceed().

◆ MB

const ILIAS\Data\DataSize::MB = 1000000

Definition at line 31 of file DataSize.php.

◆ MiB

const ILIAS\Data\DataSize::MiB = 1048576

Definition at line 21 of file DataSize.php.

Referenced by ILIAS\Filesystem\Provider\FlySystem\FlySystemFileAccessTest\testGetSizeWithUnknownAdapterErrorWhichShouldFail().

◆ PB

const ILIAS\Data\DataSize::PB = 1000000000000000

Definition at line 34 of file DataSize.php.

◆ PiB

const ILIAS\Data\DataSize::PiB = 1125899906842624

Definition at line 24 of file DataSize.php.

◆ TB

const ILIAS\Data\DataSize::TB = 1000000000000

Definition at line 33 of file DataSize.php.

◆ TiB

const ILIAS\Data\DataSize::TiB = 1099511627776

Definition at line 23 of file DataSize.php.

◆ YB

const ILIAS\Data\DataSize::YB = 1000000000000000000000000

Definition at line 37 of file DataSize.php.

◆ YiB

const ILIAS\Data\DataSize::YiB = 1208925819614629174706176

Definition at line 27 of file DataSize.php.

◆ ZB

const ILIAS\Data\DataSize::ZB = 1000000000000000000000

Definition at line 36 of file DataSize.php.

◆ ZiB

const ILIAS\Data\DataSize::ZiB = 1180591620717411303424

Definition at line 26 of file DataSize.php.

The documentation for this class was generated from the following file:

src/Data/DataSize.php

Public Member Functions

Data Fields

Static Public Attributes

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ __toString()

◆ getSize()

◆ getUnit()

◆ inBytes()

Field Documentation

◆ $abbreviations

◆ $size

◆ $suffix

◆ $suffixMap

◆ $unit

◆ Byte

◆ EB

◆ EiB

◆ GB

◆ GiB

◆ KB

◆ KiB

◆ MB

◆ MiB

◆ PB

◆ PiB

◆ TB

◆ TiB

◆ YB

◆ YiB

◆ ZB

◆ ZiB