php-extended/php-integer-capacity-object

A library that implements the php-extended/php-integer-capacity-interface package

7.0.6 2024-07-31 13:44 UTC

Requires

• php: >=8.0
• php-extended/php-integer-capacity-interface: ^7

Requires (Dev)

• php-extended/placeholder-phpunit: ^9

MIT

• Anastaszor

• php
• integer
• implementation
• bits
• bytes
• capacity

README

A library that implements the php-extended/php-integer-capacity-interface package

Installation

The installation of this library is made via composer and the autoloading of all classes of this library is made through their autoloader.

• Download composer.phar from their website.
• Then run the following command to install this library as dependency :
• php composer.phar php-extended/php-integer-capacity-object ^7

Basic Usage

This library provides 4 classes to specify integer capacities from different containers.

• The BitIntegerCapacity class uses bits to count the capacity of integers
• The ByteIntegerCapacity class uses 8-bits bytes to count the capacity of integers
• The StringIntegerCapacity class uses decimal digits arranged in a string to count the capacity of integers
• The HexaIntegerCapacity class uses hexadecimal digits arranged in a string to count the capacity of integers.

All those classes are usable the following way:

use PhpExtended\Model\BitIntegerCapacity;
use PhpExtended\Model\ByteIntegerCapacity;
use PhpExtended\Model\StringIntegerCapacity;

$capacity = new BitIntegerCapacity(32);
// $capacity is now a 32-bit integer capacity

$capacity = new ByteIntegerCapacity($capacity);
// $capacity is now a 4-byte integer capacity

$capacity = new StringIntegerCapacity($capacity);
// $capacity is now a 10-digits integer capacity

$capacity = new BitIntegerCapacity($capacity);
// $capacity is now a 33-bit integer capacity
// note that due to roundings and the ever expanding 
// available maximum value, the number of bits needed to
// encode the same information increases !

All those classes may be built with a positive non-zero integer as capacity, or another instance of the PhpExtended\Model\IntegerCapacityInterface.

A resolver is also provided to unserialize the data given by the __toString() method that may be used with integer capacities.

use PhpExtended\Model\IntegerCapacityResolver;

$resolver = new IntegerCapacityResolver();
$capacity = $resolver->resolveCapacity('8 bits');
// $capacity is now a BitIntegerCapacity with 8 as bit value.

License

MIT (See license file).