gmp_export

(PHP 5 >= 5.6.1, PHP 7, PHP 8)

gmp_export — Экспортирует в бинарную строку

Описание

function gmp_export(GMP|int|string $num, int $word_size = 1, int $flags = GMP_MSW_FIRST | GMP_NATIVE_ENDIAN): string

Функция экспортирует GMP-число в бинарную строку. Функция работает с числами произвольной разрядности, которые выходят за пределы диапазона встроенного целочисленного типа PHP, и умеет настраивать размер машинного слова и порядок байтов — по духу напоминает функцию pack().

Знак числа не учитывается: результат экспорта отрицательного числа аналогичен экспорту абсолютного значения.

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

num

GMP-число для экспорта.

word_size

Количество байтов в одном слове результата. Общая длина возвращаемой функцией строки станет кратна этому значению. Значение по умолчанию: 1.

flags

Битовая маска, которая управляет порядком слов и порядком байтов. Порядок слов: GMP_MSW_FIRST — сначала самое старшее слово, по умолчанию, или GMP_LSW_FIRST — сначала самое младшее слово. Порядок байтов внутри слова: GMP_NATIVE_ENDIAN — по умолчанию, GMP_BIG_ENDIAN или GMP_LITTLE_ENDIAN. Значение по умолчанию: GMP_MSW_FIRST | GMP_NATIVE_ENDIAN.

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

Функция возвращает строку с бинарным представлением GMP-числа; для нуля возвращается пустая строка.

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

Версия Описание
8.0.0 Функция больше не возвращает false, если возникла ошибка.

Примеры

Пример #1 Пример экспорта числа функцией gmp_export()

<?php

$number = gmp_init(16705);
echo gmp_export($number) . "\n";

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

AA

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

  • gmp_import() - Импортировать из бинарной строки

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке
＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы