bindec

(PHP 4, PHP 5, PHP 7, PHP 8)

bindecПреобразовывает двоичное число в десятичное

Описание

function bindec(string $binary_string): int|float

Возвращает десятичный эквивалент двоичного числа binary_string.

Функция bindec() преобразовывает двоичное число в целое число (int), а если размер числа слишком большой, то в число с плавающей точкой (float).

Функция bindec() интерпретирует значения аргумента binary_string как беззнаковые числа. Это потому, что функция bindec() рассматривает старший бит как ещё один порядок величины, а не как бит знака.

Список параметров

binary_string

Бинарная строка для преобразования. Любые недопустимые символы в строке binary_string будут проигнорированы без предупреждения. Начиная с PHP 7.4.0 передача некорректных символов устарела.

Внимание

Параметр принимает только строки. Данные других типов приведут к непредсказуемому результату.

Возвращаемые значения

Возвращает десятичное значение строки binary_string.

Список изменений

Версия Описание
7.4.0 Передача недопустимых символов теперь выдаёт уведомление об устаревании. Результат по-прежнему будет вычислен, как если бы недопустимые символы не передавались.

Примеры

Пример #1 Пример использования функции bindec()

<?php

echo bindec('110011') . "\n";
echo bindec('000110011') . "\n";

echo bindec('111');

?>

Результат выполнения приведённого примера:

51
51
7

Пример #2 Функция bindec() интерпретирует ввод как беззнаковое число

<?php

/*
 * Смысл этого примера — в выводе скрипта,
 * а не в PHP-коде.
 */

$magnitude_lower = pow(2, (PHP_INT_SIZE * 8) - 2);
p($magnitude_lower - 1);
p($magnitude_lower, 'Видите резкую смену значений? Смотрите в следующий раз...');

p(PHP_INT_MAX, 'PHP_INT_MAX');
p(~PHP_INT_MAX, 'интерпретируется как увеличенное на единицу значение PHP_INT_MAX');

if (PHP_INT_SIZE == 4) {
    $note = 'интерпретируется как самое большое целое без знака (unsigned integer)';
} else {
    $note = 'интерпретируется как самое большое целое без знака (unsigned integer)
              (18446744073709551615), но искажается из-за недостаточной точности float';
}
p(-1, $note);


function p($input, $note = '') {
    echo "input:        $input\n";

    $format = '%0' . (PHP_INT_SIZE * 8) . 'b';
    $bin = sprintf($format, $input);
    echo "binary:       $bin\n";

    ini_set('precision', 20);  // Для надёжности на 64-битных системах.
    $dec = bindec($bin);
    echo 'bindec():     ' . $dec . "\n";

    if ($note) {
        echo "NOTE:         $note\n";
    }

    echo "\n";
}
?>

Результат выполнения приведённого примера на 32-битных машинах:

input:        1073741823
binary:       00111111111111111111111111111111
bindec():     1073741823

input:        1073741824
binary:       01000000000000000000000000000000
bindec():     1073741824
NOTE:         Видите резкую смену значений? Смотрите в следующий раз...

input:        2147483647
binary:       01111111111111111111111111111111
bindec():     2147483647
NOTE:         PHP_INT_MAX

input:        -2147483648
binary:       10000000000000000000000000000000
bindec():     2147483648
NOTE:         интерпретируется как увеличенное на единицу значение PHP_INT_MAX

input:        -1
binary:       11111111111111111111111111111111
bindec():     4294967295
NOTE:         интерпретируется как самое большое целое без знака (unsigned integer)

Результат выполнения приведённого примера на 64-битных машинах:

input:        4611686018427387903
binary:       0011111111111111111111111111111111111111111111111111111111111111
bindec():     4611686018427387903

input:        4611686018427387904
binary:       0100000000000000000000000000000000000000000000000000000000000000
bindec():     4611686018427387904
NOTE:         Видите резкую смену значений? Смотрите в следующий раз...

input:        9223372036854775807
binary:       0111111111111111111111111111111111111111111111111111111111111111
bindec():     9223372036854775807
NOTE:         PHP_INT_MAX

input:        -9223372036854775808
binary:       1000000000000000000000000000000000000000000000000000000000000000
bindec():     9223372036854775808
NOTE:         интерпретируется как увеличенное на единицу значение PHP_INT_MAX

input:        -1
binary:       1111111111111111111111111111111111111111111111111111111111111111
bindec():     18446744073709551616
NOTE:         интерпретируется как самое большое целое без знака (unsigned integer)
              (18446744073709551615), но искажается из-за недостаточной точности float

Примечания

Замечание:

Функция умеет конвертировать числа, которые слишком велики, чтобы вписаться в целочисленный тип данных (int) платформ, результатом обработки таких значений будет число с плавающей точкой float.

Смотрите также

  • decbin() - Переводит число из десятичной системы счисления в двоичную
  • octdec() - Переводит число из восьмеричной системы счисления в десятичную
  • hexdec() - Переводит число из шестнадцатеричной системы счисления в десятичную
  • base_convert() - Преобразовывает числа между произвольными системами счисления