DtSearchHighlight man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

DtSearchHighlight(library call)		       DtSearchHighlight(library call)

NAME
       DtSearchHighlight   —  Generate	DtSrHitwords  table  for  highlighting
       DtSearch document

SYNOPSIS
       #include <Dt/Search.h>
       intDtSearchHighlight(
       char *dbname,
       char *cleartext,
       DtSrHitword **hitwptr,
       long *hitwcount,
       int search_type,
       char *stems,
       int stemcount);

DESCRIPTION
       The DtSearchHighlight  function	generates  an  array  of  offsets  and
       lengths	(DtSrHitword) of parsed linguistic terms (stems) in the passed
       document cleartext to enable a browser to highlight the	words  in  the
       text as appropriate for its user interface.

ARGUMENTS
       dbname	 Specifies  which database is to be searched. It is any one of
		 the database  name  strings  returned	from  DtSearchInit  or
		 DtSearchReinit.  If  dbname  is NULL, the first database name
		 string is used.

       cleartext Pointer to a zero terminated C string containing the document
		 text  to  be  highlighted. Usually, but not necessarily, this
		 value is returned from DtSearchRetrieve.

       hitwptr and hitwcount
		 The hitwords array will be stored in hitwptr, the address  of
		 a  DtSrHitword pointer. The array is dynamically allocated by
		 this function and remains valid until the next call  to  this
		 function.   The  size of the hitwords array will be stored in
		 hitwcount.

       search_type
		 Specifies the search_type of the DtSearchQuery that generated
		 the  stems array. It must be zero, 'P', 'W', or 'S'.  If zero
		 is passed, the search_type of the last call to	 DtSearchQuery
		 is assumed.

       stems and stemcount
		 stems	and  stemcount are optional; they can be NULL and zero
		 respectively. However, if either is specified, both  must  be
		 specified.  If	 specified, they refer to the stems array that
		 was returned from the previous	 call  to  DtSearchQuery  that
		 ultimately resulted in the cleartext argument.

		 If  these  arguments are not passed, the stems array from the
		 most recent call to DtSearchQuery is assumed.

RETURN VALUE
       This function returns DtSrOK, as well as a DtSrHitword table, when  the
       table generation is completely successful.

       Any  other  return code signifies failure and user messages on the Mes‐
       sageList explain why.

       Any API function can also return DtSrREINIT and the  return  codes  for
       fatal engine errors at any time.

SEE ALSO
       DtSrAPI(3), DtSearchQuery(3), DtSearchRetrieve(3)

					       DtSearchHighlight(library call)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net