README

Conversion from/to decimal numerals

Comparison of Converters

Examples

Meta Information

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