yaz_hits

(PHP 4 >= 4.0.1, PECL)

yaz_hits -- 直近の検索に関するヒット数を返す

説明

int yaz_hits ( resource id [, array searchresult] )

yaz_hits() は、直近の検索に関するヒット数を 返します。

パラメータ

id

yaz_connect() が返す接続リソース。

searchresult

詳細な検索結果情報の配列。

返り値

直近の検索に関するヒット数を返します。検索が行われていない場合は 0 を返します。

検索結果配列がもし指定されていた場合、そこには Z39.50 サーバが返す情報が 含まれます。この情報の形式は、検索結果の応答の一部である SearchResult-1 フォーマットとなります。 SearchResult-1 フォーマットは、さまざまなクエリ(サブクエリ)のヒット数に 関する情報を取得するために使用可能です。 特に、クエリ内の個々の検索語句に関するヒット数を得ることが可能です。 最初のサブクエリについての情報が $array[0] に、2 番目のサブクエリについての 情報が $array[1] に、というような形式となります。

表 1. 検索結果の項目

要素説明
idサブクエリの ID2 (string)
count結果のカウント / ヒット数 (integer)
subquery.termサブクエリの語句 (string)
interpretation.term解釈されたサブクエリの語句 (string)
recommendation.term推奨されるサブクエリの語句 (string)

注意: SearchResult 機能を使用するには、PECL YAZ 1.0.5 以降 および YAZ 2.1.9 以降が必要です。

注意: SearchResult 機能をサポートしている Z39.50 実装は ほとんどありません。