YAZ_HITS(3)								 1							       YAZ_HITS(3)

yaz_hits - Returns number of hits for last search

SYNOPSIS

       int yaz_hits (resource  $id, [array  &$searchresult])

DESCRIPTION

       yaz_hits(3) returns the number of hits for the last search.

PARAMETERS

	      o $id
		- The connection resource returned by yaz_connect(3).

	      o $searchresult
		- Result array for detailed search result information.

RETURN VALUES

	Returns the number of hits for the last search or 0 if no search was performed.

	The  search result array (if supplied) holds information that is returned by a Z39.50 server in the SearchResult-1 format part of a search
       response. The SearchResult-1 format can be used to obtain information about hit counts for various parts of the query (subquery).  In  par-
       ticular,  it  is  possible to obtain hit counts for the individual search terms in a query. Information for first subquery is in $array[0],
       second subquery in $array[1], and so forth.

       searchresult members

       +--------------------+---------------------------------------+
       |      Element	    |					    |
       |		    |					    |
       |		    |		   Description		    |
       |		    |					    |
       +--------------------+---------------------------------------+
       |		    |					    |
       |	id	    |					    |
       |		    |					    |
       |		    |	     Sub query ID2 (string)	    |
       |		    |					    |
       |		    |					    |
       |       count	    |					    |
       |		    |					    |
       |		    |	  Result count / hits (integer)     |
       |		    |					    |
       |		    |					    |
       |   subquery.term    |					    |
       |		    |					    |
       |		    |	     Sub query term (string)	    |
       |		    |					    |
       |		    |					    |
       |interpretation.term |					    |
       |		    |					    |
       |		    | Interpretated sub query term (string) |
       |		    |					    |
       |		    |					    |
       |recommendation.term |					    |
       |		    |					    |
       |		    |  Recommended sub query term (string)  |
       |		    |					    |
       +--------------------+---------------------------------------+
       Note

	       The SearchResult facility requires PECL YAZ 1.0.5 or later and YAZ 2.1.9 or later.

       Note

	       Very few Z39.50 implementations support the SearchResult facility.

PHP Documentation Group 													       YAZ_HITS(3)