yaz_sort

(PHP 4 >= 4.0.7, PECL yaz >= 0.9.0)

yaz_sort — Задає критерій сортування

Опис

yaz_sort(resource $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