QuickHashStringIntHash::loadFromFile
(No version information available, might only be in Git)
QuickHashStringIntHash::loadFromFile — Фабричный метод создаёт хеш из файла
Описание
$filename, int $size = 0, int $options = 0): QuickHashStringIntHash
Этот фабричный метод создаёт новый хеш из файла определения на диске.
Формат файла состоит из сигнатуры 'QH\0x21\0',
количества элементов в виде 32-битного целого числа со знаком в системном порядке байтов,
32-битного целого числа без знака, содержащего количество данных элемента в символах.
Данные этого элемента содержат все строки. Далее следует другое32-битное целое число со знаком,
содержащее количество списков.
После заголовка и строк следуют элементы. Они упорядочены по списку,
так что ключи не нужно хешировать, чтобы восстановить хеш.
Для каждого списка хранится следующая информация (все как 32-битные целые числа):
индекс списка, количество элементов в этом списке, а затем парами по два 32-битных целых числа без знака - элементы,
где первый - это индекс в строковом списке, содержащем ключи, а второй - значение.
Примером может быть:
Пример #1 Формат файла QuickHash StringIntHash
00000000 51 48 21 00 02 00 00 00 09 00 00 00 40 00 00 00 |QH!.........@...| 00000010 4f 4e 45 00 4e 49 4e 45 00 07 00 00 00 01 00 00 |ONE.NINE........| 00000020 00 00 00 00 00 01 00 00 00 2f 00 00 00 01 00 00 |........./......| 00000030 00 04 00 00 00 03 00 00 00 |.........| 00000039
Пример #2 Формат файла QuickHash IntHash
header signature ('QH'; key type: 2; value type: 1; filler: \0x00)
00000000 51 48 21 00
number of elements:
00000004 02 00 00 00
length of string values (9 characters):
00000008 09 00 00 00
number of hash bucket lists (this is configured for hashes as argument to the
constructor normally, 64 in this case):
0000000C 40 00 00 00
string values:
00000010 4f 4e 45 00 4e 49 4e 45 00
bucket lists:
bucket list 1 (with key 7, and 1 element):
header:
07 00 00 00 01 00 00 00
elements (key index: 0 ('ONE'), value = 0):
00 00 00 00 01 00 00 00
bucket list 2 (with key 0x2f, and 1 element):
header:
2f 00 00 00 01 00 00 00
elements (key index: 4 ('NINE'), value = 3):
04 00 00 00 03 00 00 00
Список параметров
-
filename -
Имя файла, из которого нужно считать хеш.
-
size -
Количество списков, которое необходимо настроить. Переданное число будет автоматически округлено до следующей степени числа 2. Оно также автоматически ограничивается от
4до4194304. -
options -
Те же параметры, которые принимает конструктор класса; за исключением того, что игнорируется параметр
size. Размер считывается из формата файла (в отличие от классов QuickHashIntHash и QuickHashIntStringHash, где он автоматически вычисляется из количества записей в хеше).
Возвращаемые значения
Возвращает новый объект QuickHashStringIntHash.
Примеры
Пример #3 Пример использования QuickHashStringIntHash::loadFromFile()
<?php
$file = dirname( __FILE__ ) . "/simple.hash.string";
$hash = QuickHashStringIntHash::loadFromFile(
$file,
QuickHashStringIntHash::DO_NOT_USE_ZEND_ALLOC
);
foreach( range( 0, 0x0f ) as $key )
{
$i = 48712 + $key * 1631;
$k = base_convert( $i, 10, 36 );
echo $k, ' => ', $hash->get( $k ), "\n";
}
?>Вывод приведённого примера будет похож на:
11l4 => 48712 12uf => 50343 143q => 51974 15d1 => 53605 16mc => 55236 17vn => 56867 194y => 58498 1ae9 => 60129 1bnk => 61760 1cwv => 63391 1e66 => 65022 1ffh => 66653 1gos => 68284 1hy3 => 69915 1j7e => 71546 1kgp => 73177
add a note
