(PECL quickhash >= Unknown)
QuickHashIntStringHash::loadFromFile — Создаёт хеш из файла
$filename, int $size = 0, int $options = 0): QuickHashIntStringHash
Этот фабричный метод создаёт новый хеш из файла определения на диске.
Формат файла состоит из сигнатуры 'QH\0x12\0',
количества элементов в виде 32-битного целого числа со знаком в системном порядке байтов,
32-битного целого числа без знака, которое содержит количество следующих за ним данных элемента в символах.
Данные этого элемента содержат все строки.
После заголовка и строк элементы следуют парами из двух 32-битных целых чисел без знака,
где первое — ключ, а второе — индекс в строке данных элемента. Пример может выглядеть вот так:
Пример #1 Пример формата файла QuickHash IntString
00000000 51 48 12 00 02 00 00 00 09 00 00 00 4f 4e 45 00 |QH..........ONE.| 00000010 4e 49 4e 45 00 01 00 00 00 00 00 00 00 03 00 00 |NINE............| 00000020 00 04 00 00 00 |.....| 00000025
Пример #2 Пример формата файла QuickHash IntString
header signature ('QH'; key type: 1; value type: 2; filler: \0x00)
00000000 51 48 12 00
number of elements:
00000004 02 00 00 00
length of string values (9 characters):
00000008 09 00 00 00
string values:
0000000C 4f 4e 45 00 4e 49 4e 45 00
data string:
00000015 01 00 00 00 00 00 00 00 03 00 00 00 04 00 00 00
key/value 1 (key = 1, string index = 0 ("ONE")):
01 00 00 00 00 00 00 00
key/value 2 (key = 3, string index = 4 ("NINE")):
03 00 00 00 04 00 00 00
filenameИмя файла, из которого нужно считать хеш.
size
Количество списков бакетов для настройки.
Метод автоматически округлит заданное число в бо́льшую сторону до следующей степени числа 2.
Число также автоматически ограничивается значениями от 4 до 4 194 304.
options
Те же параметры, которые принимает конструктор класса;
за исключением того, что параметр size игнорируется.
Размер автоматически вычисляется как количество записей в хеше,
округляется в бо́льшую сторону до ближайшей степени числа 2
с максимальным пределом 4 194 304.
Метод возвращает новый объект QuickHashIntStringHash.
Пример #3 Пример использования метода QuickHashIntStringHash::loadFromFile()
<?php
$file = dirname(__FILE__) . "/simple.string.hash";
$hash = QuickHashIntStringHash::loadFromFile(
$file,
QuickHashIntStringHash::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) не установлен