Açıklama

yaz_search(resource $id, string $tür, string $sorgu): bool

yaz_search() işlevi belirtilen bağlantı için bir arama düzenler.

yaz_connect() işlevi gibi bu işlev de engellenmeyen kipte çalışır ve yaz_wait() çağrısına hazırlık olarak bir arama işlemi düzenler.

Bağımsız Değişkenler

id

yaz_connect() tarafından döndürülmüş bağlantı özkaynağı.

tür

Sorgu türü - şimdilik sadece "rpn" desteklenmekte olup, bu durumda üçüncü bağımsız değişken, önek sorgu gösteriminde bir Type-1 sorgusu belirtir.

sorgu

Z39.50 standardında tanımlandığı gibi Type-1 sorgusunun dizgesel gösterimi olarak RPN sorgusu. Sorgu dizgesi boşluklarla ayrılmış dizgeciklerden oluşur ve boşluk içeren dizgeciklerin tırnak içine alınması gerekir. @ (kuyruklu a) karakteri ile başlayan dizgecikler işleç olarak, diğerleri arama terimleri olarak ele alınır.

**RPN İşleçleri**
İfade Sözdizimi	Açıklama
`@and` sorgu1 sorgu2	sorgu1 ve sorgu2'nin kesişimi
`@or` sorgu1 sorgu2	sorgu1 ve sorgu2'nin birleşimi
`@not` sorgu1 sorgu2	sorgu1 değildir sorgu2
`@set` isim	Sonuç kümesi gönderimi
`@attrset` küme sorgu	Sorgu için öznitelik kümesi belirtir. Bu ifadeye sadece tüm sorgunun en başında bir defalığına izin verilir.
`@attr` [küme] tür=değer sorgu	Sorguya özniteliği uygular. tür ve değer birer tamsayı olup öznitelik türünü ve değerini belirtir. küme ise kullanıldığı takdirde öznitelik kümesini belirtir.

Öznitelikler hakkında bilgi edinmek için » Z39.50 Maintenance Agency sitesine bakınız.

Bilginize:
Daha hoş bir gösterim isterseniz CCL çözümleyici - yaz_ccl_conf() ve yaz_ccl_parse() işlevlerini - kullanın.

Dönen Değerler

Başarı durumunda true, başarısızlık durumunda false döner.

Örnekler

Örnek 1 - Sorgu örnekleri - Aşağıdaki gibi basit ifadeleri aratabilirsiniz

computer

İçinde "computer" geçen belgelerle eşleşir. Hiçbir öznitelik belirtilmemiştir.

"knuth donald"

İçinde "knuth donald" geçen belgelerle eşleşir (sunucu deyim aramayı destekliyorsa).

@attr 1=1003 @attr 4=1 "knuth donald"

Aynı deyimi iki öznitelikle sorgular. İlk öznitelik 1. türde (Bib-1 kullanımı) olup özniteliğin değeri 1003'tür (Yazar). İkinci öznitelik 4. türde (veri yapısı) olup değeri 1'dir (cümle). Dolayısıyla bu ifade, yazarı Donald Knuth olan belgelerle eşleşir.

@and @or a b @not @or c d e

Açılımı:

(a or b) and ((c or d) not e)

Daha karmaşık bir örnek:

@attrset gils @and @attr 1=4 art @attr 1=2000 company

Sorgu bir bütün olarak GILS öznitelik kümesini kullanır. Dağıtımcı (GILS) olarak company ve başlık (GILS,BIB-1) olarak art içeren belgelerle eşleşir.