yaz_sort

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

yaz_sortDefine critérios de classificação

Descrição

yaz_sort(resource $id, string $criteria): void

Esta função define critérios de classificação e habilita a classificação Z39.50.

Chame esta função antes de yaz_search(). Usar esta função sozinha não tem efeito algum. Quando usada em conjunto com yaz_search(), uma ordenação Z39.50 será enviada após uma resposta de pesquisa ser recebida e antes que quaisquer registros sejam recuperados com Z39.50 Present (yaz_present()).

Parâmetros

id

O recurso de conexão retornado por yaz_connect().

criteria

Uma string que assume o formato field1 flags1 field2 flags2 onde field1 especifica os atributos primários para ordenação, field2 os secundários, etc.

O campo especifica uma combinação de atributos numéricos consistindo de pares tipo=valor separados por vírgula (por exemplo, 1=4,2=1); ou o campo pode especificar um critério de string simples (por exemplo, title. Os sinalizadores são uma sequência dos seguintes caracteres que não podem ser separados por nenhum espaço em branco.

Sinalizadores de Ordenação
a

Ordem ascendente

d

Ordem descendente

i

Ordenação insensível a maiúsculas/minúsculas

s

Ordenação sensível a maiúsculas/minúsculas

Valor Retornado

Nenhum valor é retornado.

Exemplos

Exemplo #1 Critérios de Ordenação

Para classificar pelo título do atributo Bib1, sem diferenciação de maiúsculas e minúsculas e em ordem crescente, seriam usados os seguintes critérios de ordenação:

1=4 ia

Se os critérios de ordenação secundários forem autor, diferenciação entre maiúsculas e minúsculas e ordem crescente, seria usado:

1=4 ia 1=1003 sa