carrontiger/conversion

Conversion from/to decimal numerals.

v1.0.2 2024-04-07 21:53 UTC

Requires

• php: ^7.4|^8.0|^8.1|^8.2

Requires (Dev)

• phpunit/phpunit: ^9.5

Apache-2.0

• Callum Stotter

README

Conversion from/to decimal numerals

Comparison of Converters

Examples

Converter	Result of toDecimal()	Result of fromDecimal()
BinaryConverter	2147483647	1111111111111111111111111111111
OctalConverter	2147483647	17777777777
HexadecimalConverter	2147483647	7FFFFFFF
CaseInsensitiveAlphaDecimalConverter	2147483647	ZIK0ZJ
CaseSensitiveAlphaDecimalConverter	2147483647	2LKcb1
AsciiDecimalConverter	2147483647	Rll}&

Meta Information

Converter	Base	“Digits”
BinaryConverter	2	01
OctalConverter	8	01234567
HexadecimalConverter	16	0123456789ABCDEF
CaseInsensitiveAlphaDecimalConverter	36	0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ
CaseSensitiveAlphaDecimalConverter	62	0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
AsciiDecimalConverter	94	0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~

Individual Examples

Binary Numerals

Conversion of decimal numeral to a binary numeral

use carrontiger\Conversion\BinaryConverter;

$binaryConverter = new BinaryConverter();

echo $binaryConverter->fromDecimal(123);
//  "01111011"

Conversion of binary numeral to a decimal numeral

use carrontiger\Conversion\BinaryConverter;

$binaryConverter = new BinaryConverter();

echo $binaryConverter->toDecimal('01111011');
//  123

Octal Numerals

Conversion of decimal numeral to a octal numeral

use carrontiger\Conversion\OctalConverter;

$octalConverter = new OctalConverter();

echo $octalConverter->fromDecimal(123);
//  "173"

Conversion of octal numeral to a decimal numeral

use carrontiger\Conversion\BinaryConverter;

$octalConverter = new OctalConverter();

echo $octalConverter->toDecimal('173');
//  123

Hexadecimal Numerals

Conversion of decimal numeral to a hexadecimal numeral

use carrontiger\Conversion\HexadecimalConverter;

$hexadecimalConverter = new HexadecimalConverter()

echo $hexadecimalConverter->fromDecimal(123);
//  "7B"

Conversion of hexadecimal numeral to a decimal numeral

use carrontiger\Conversion\HexadecimalConverter;

$hexadecimalConverter = new HexadecimalConverter();

echo $hexadecimalConverter->toDecimal('7B');
//  123

Case-Insensitive Alpha-Decimal Numerals

The case-insensitive alpha-decimal numeral encoding uses the following 36 “digits”:

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ

Conversion of decimal numeral to a case-insensitive alpha-decimal numeral

use carrontiger\Conversion\CaseInsensitiveAlphaDecimalConverter;

$ciAlphaDecimalConverter = new CaseInsensitiveAlphaDecimalConverter()

echo $ciAlphaDecimalConverter->fromDecimal(123);
//  "3F"

Conversion of a case-insensitive alpha-decimal numeral to a decimal numeral

use carrontiger\Conversion\CaseInsensitiveAlphaDecimalConverter;

$ciAlphaDecimalConverter = new CaseInsensitiveAlphaDecimalConverter();

echo $ciAlphaDecimalConverter->toDecimal('3F');
//  123

Case-Sensitive Alpha-Decimal Numerals

The case-sensitive alpha-decimal numeral encoding uses the following 62 “digits”:

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

Conversion of decimal numeral to a case-sensitive alpha-decimal numeral

use carrontiger\Conversion\CaseSensitiveAlphaDecimalConverter;

$alphaDecimalConverter = new CaseSensitiveAlphaDecimalConverter()

echo $alphaDecimalConverter->fromDecimal(123);
//  "1z"

Conversion of a case-sensitive alpha-decimal numeral to a decimal numeral

use carrontiger\Conversion\CaseSensitiveAlphaDecimalConverter;

$alphaDecimalConverter = new CaseSensitiveAlphaDecimalConverter();

echo $alphaDecimalConverter->toDecimal('1z');
//  123

ASCII-Numerals

The ASCII numeral encoding uses the following 94 “digits”:

0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz!"#$%&'()*+,-./:;<=>?@[\]^_`{\|}~

Due to the use of non-alphabetic characters, it is not practical for ASCII numerals to be embedded in texts or be used as plain HTTP query arguments, for example. One purpose would be to encode large integer numbers, compactly. But most of all, this is an example of an arbitrary numeral system, than one can define.

If you were to define a numeral system (by extending the AbstractDecimalConverter class), be advised, to use only one-byte characters as digits.

Conversion of decimal numeral to an ASCII numeral

use carrontiger\Conversion\AsciiDecimalConverter;

$asciiDecimalConverter = new AsciiDecimalConverter()

echo $asciiDecimalConverter->fromDecimal(123);
//  "1T"

Conversion of an ASCII numeral to a decimal numeral

use carrontiger\Conversion\AsciiDecimalConverter;

$asciiDecimalConverter = new AsciiDecimalConverter()

echo $asciiDecimalConverter->toDecimal('1T');
//  123