Type conversion#

To working string#

Arokettu\Unsigned\from_int(int $value, int $sizeof) string#

Imports a regular PHP int.

Parameters:
  • $value (int) – The value. Negative values are accepted but they will be cast to unsigned

  • $sizeof (int) – Length of the unsigned number in bytes.

Returns:

Binary string in the form this library accepts

If $sizeof <= PHP_INT_SIZE, value may be truncated. (but do you really need this lib then?)

Arokettu\Unsigned\from_hex(string $value, int $sizeof) string#

Imports a number written as a hexadecimal string.

Parameters:
  • $value (string) – String of hex digits

  • $sizeof (int) – Length of the unsigned number in bytes

Returns:

Binary string in the form this library accepts

If strlen($value) >= $sizeof * 2, value may be truncated.

Arokettu\Unsigned\from_dec(string $value, int $sizeof) string#

Imports a number written as a decimal string.

Parameters:
  • $value (string) – String of digits

  • $sizeof (int) – Length of the unsigned number in bytes

Returns:

Binary string in the form this library accepts

If intval($value) >= 2 ** $sizeof, value will be truncated.

Arokettu\Unsigned\from_base(string $value, int $base, int $sizeof) string#

Imports a number written in base specified in $base.

Parameters:
  • $value (string) – String of digits

  • $base (int) – Number base between 2 and 36

  • $sizeof (int) – Length of the unsigned number in bytes

Returns:

Binary string in the form this library accepts

If intval($value) >= 2 ** $sizeof, value will be truncated.

From working string#

Arokettu\Unsigned\fits_into_int(string $value) bool#
Parameters:
  • $value (string) – Binary string in the form this library accepts

Returns:

If value can be represented as a native PHP integer value, i.e. less than PHP_INT_MAX.

Arokettu\Unsigned\to_int(string $value) int#
Parameters:
  • $value (string) – Binary string in the form this library accepts

Returns:

The int representation

Arokettu\Unsigned\to_signed_int(string $value) int#

If the most significant bit is set, return value as a negative int.

Parameters:
  • $value (string) – Binary string in the form this library accepts

Returns:

The int representation

Arokettu\Unsigned\to_hex(string $value) bool#

Exports a number to a hexadecimal string.

Parameters:
  • $value (string) – Binary string in the form this library accepts

Returns:

String of hex digits

Arokettu\Unsigned\to_dec(string $value) bool#

Exports a number to a decimal string.

Parameters:
  • $value (string) – Binary string in the form this library accepts

Returns:

String of digits

Arokettu\Unsigned\to_base(string $value, int $base) bool#

Exports a number to a string in a specified base.

Parameters:
  • $value (string) – Binary string in the form this library accepts

  • $base (int) – Number base between 2 and 36

Returns:

String of digits