QuickHashIntStringHash::loadFromFile

(PECL quickhash >= Unknown)

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

Описание

public static QuickHashIntStringHash::loadFromFile(string $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) не установлен