CascadiaPHP 2024

QuickHashIntHash::loadFromFile

(PECL quickhash >= Unknown)

QuickHashIntHash::loadFromFileСоздаёт хеш из файла

Описание

public static QuickHashIntHash::loadFromFile(string $filename, int $options = ?): QuickHashIntHash

Этот фабричный метод создаёт новый хеш из файла определения на диске. Формат файла состоит из сигнатуры 'QH\0x11\0', количества элементов в виде 32-битного целого числа со знаком в системном порядке байтов, за которым следуют 32-битные целые числа со знаком, которые упаковали вместе в порядок байтов, который использует система, в которой работает код. Для каждого элемента хеша хранятся два 32-битных целых числа со знаком. Первое из них — ключ, а второе — значение, которое принадлежит ключу. Пример может выглядеть вот так:

Пример #1 Пример формата файла QuickHash IntHash

00000000  51 48 11 00 02 00 00 00  01 00 00 00 01 00 00 00  |QH..............|
00000010  03 00 00 00 09 00 00 00                           |........|
00000018

Пример #2 Пример формата файла QuickHash IntHash

header signature ('QH'; key type: 1; value type: 1; filler: \0x00)
00000000  51 48 11 00

number of elements:
00000004  02 00 00 00

data string:
00000000  01 00 00 00 01 00 00 00  03 00 00 00 09 00 00 00

key/value 1 (key = 1, value = 1)
01 00 00 00  01 00 00 00

key/value 2 (key = 3, value = 9)
03 00 00 00  09 00 00 00

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

filename

Имя файла, из которого нужно считать хеш.

options

Те же параметры, которые принимает конструктор класса; за исключением того, что параметр size игнорируется. Размер автоматически вычисляется как количество записей в хеше, округляется в бо́льшую сторону до ближайшей степени числа 2 с максимальным пределом 4 194 304.

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

Метод возвращает новый объект QuickHashIntHash.

Примеры

Пример #3 Пример использования метода QuickHashIntHash::loadFromFile()

<?php

$file
= dirname(__FILE__) . "/simple.hash";

$hash = QuickHashIntHash::loadFromFile(
$file,
QuickHashIntHash::DO_NOT_USE_ZEND_ALLOC
);

foreach (
range(0, 0x0f) as $key) {
printf(
"Ключ %3d (%2x) %s\n",
$key,
$key,
$hash->exists($key) ? 'установлен' : 'не установлен'
);
}

?>

Вывод приведённого примера будет похож на:

Ключ   0 ( 0) не установлен
Ключ   1 ( 1) установлен
Ключ   2 ( 2) установлен
Ключ   3 ( 3) установлен
Ключ   4 ( 4) не установлен
Ключ   5 ( 5) установлен
Ключ   6 ( 6) не установлен
Ключ   7 ( 7) установлен
Ключ   8 ( 8) не установлен
Ключ   9 ( 9) не установлен
Ключ  10 ( a) не установлен
Ключ  11 ( b) установлен
Ключ  12 ( c) не установлен
Ключ  13 ( d) установлен
Ключ  14 ( e) не установлен
Ключ  15 ( f) не установлен

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top