(PHP 4 >= 4.0.7, PECL yaz >= 0.9.0)
yaz_sort — Задаёт критерий сортировки
$id
, string $criteria
): voidФункция задаёт критерий сортировки и включает сортировку по Z39.50.
Эта функция должна быть вызвана до yaz_search(). Вызов этой функции отдельно не имеет никакого смысла. Когда она используется совместно с yaz_search(), параметры сортировки будут отосланы после поискового запроса и до того, как какая-либо запись будет получена по Z39.50 (yaz_present()).
id
Дескриптор соединения, возвращаемый yaz_connect().
criteria
Строка, принимающая вид поле1 флаг1 поле2 флаг2, где поле1 устанавливает первый атрибут сортировки, поле2 - второй и т.д.
Поле может определяться либо как числовая комбинация, состоящая из пары
тип=значение и разделяемое запятой (например, 1=4,2=1
),
либо как строковый параметр (например, title
). Флаг
представляет собой последовательность символов, которая не может быть
разделена пробелом.
a
Сортировка по возрастанию
d
Сортировка по убыванию
i
Сортировка без учёта регистра символов
s
Сортировка с учётом регистра символов
Функция не возвращает значения после выполнения.
Пример #1 Критерии сортировки
Чтобы отсортировать записи по заголовку, без учёта регистра по возрастанию следует использовать следующий критерий:
1=4 ia
Если второй критерий сортировки должен идти по автору с учётом регистра и по возрастанию, критерий будет выглядеть как:
1=4 ia 1=1003 sa