Positional numeral system

Allows convert numbers in different positional numeral system. The most used are binary, octal, decimal and hexadecimal

numeral_system.positional.decode(number, base, alphabet=('0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'), sign_literal='-')

Convert number from given base and alphabet to integer

Parameters
  • number (int | str) – given number to convert

  • base (int | str for less base) – base of given number

  • alphabet (tuple) – alphabet of numeric system

  • sign_literal (str) –

Returns

converted number

Return type

str

numeral_system.positional.encode(number, base, alphabet=('0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'), sign_literal='-')

Convert integer number to number with given base and alphabet

Parameters
  • number (int | str) – given number to convert

  • base – base of given number

  • base – int | str for less base

  • alphabet (tuple) – alphabet of numeric system

  • sign_literal (str) –

Returns

converted number

Return type

str

numeral_system.positional.from_binary(number)

To hexadecimal number representation from integer

Parameters

number (int | str) –

Returns

Return type

str

numeral_system.positional.from_hex(number)

From hexadecimal number representation to integer

Parameters

number (str) –

Returns

Return type

str

numeral_system.positional.from_octal(number)

From hexadecimal number representation to integer

Parameters

number (int | str) –

Returns

Return type

str

numeral_system.positional.is_valid(number, base, alphabet=('0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'), sign_literal='-')

Check if given number is valid in given base and alphabet

Parameters
  • number (int | str) – given number to check

  • base (int | str for less base) – base of given number

  • alphabet (tuple) – alphabet of numeric system

  • sign_literal (str) –

Returns

True if given number is valid in positional numeral system with base

Return type

bool

numeral_system.positional.max_base(alphabet=('0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z'))

Get max base for given alphabet

Parameters

alphabet (tuple) –

Returns

Return type

int

numeral_system.positional.to_binary(number)

To binary number representation from integer

Parameters

number (int | str) –

Returns

Return type

str

numeral_system.positional.to_hex(number)

To hexadecimal number representation from integer

Parameters

number (str) –

Returns

Return type

str

numeral_system.positional.to_octal(number)

To hexadecimal number representation from integer

Parameters

number (int | str) –

Returns

Return type

str