dtsearchmergeresults(3) [hpux man page]

DtSearchMergeResults(library call)										DtSearchMergeResults(library call)

NAME

       DtSearchMergeResults -- Merge two DtSearch results lists into one

SYNOPSIS

       #include <Dt/Search.h>
       int DtSearchMergeResults(
       DtSrResult **targlist,
       DtSrResult **srclist);

DESCRIPTION

       DtSearchMergeResults  merges  the  srclist  results list into the targlist list using proximity for sort order, and sets the srclist source
       list pointer to NULL.

       This function is used to merge results from separate database searches for presentation to the user as a single results list.

       It presumes both lists are initially sorted by ascending proximity. It does nothing if source list is empty and returns	DtSrOK.  It  moves
       the source list as is to the target list if the target list is empty and returns DtSrOK.

ARGUMENTS

       srclist	 Specifies the results list to be merged into the target list.

       targlist  Specifies the results list into which the source list is to be merged.

RETURN VALUE

       DtSearchMergeResults returns DtSrERROR if either the srclist pointer or the srclist pointer is NULL. Otherwise, it returns DtSrOK, indicat-
       ing a successful merge.

SEE ALSO

       DtSrAPI(3), DtSearchQuery(3), DtSearchSortResults(3), DtSearchFreeResults(3)

														DtSearchMergeResults(library call)

DtSearchReinit(library call)											      DtSearchReinit(library call)

NAME

       DtSearchReinit -- Reinitialize the DtSearch online API

SYNOPSIS

       #include <Dt/Search.h>
       int DtSearchReinit(
       char ***dbnames,
       int *dbcount);

DESCRIPTION

       DtSearchReinit closes and reopens databases and other files as necessary, and reinitializes the search engine API.

       It is typically used after either databases or the ocf file have been externally changed to force the search engine to reinitialize itself,
       and to acquire the new database names if any.

       It can also be used after any function returns DtSrREINIT to acquire the new database names.

ARGUMENTS

       dbnames	 Specifies the address where a pointer to an array of static database name string pointers will be  placed.  The  dbnames  pointer
		 from  a previous DtSearchInit or DtSearchReinit may no longer be valid. Each string identifies a single successfully opened data-
		 base.

		 A database name string from this array is required for most other API function calls. The dbn member in DtSrResult  is  an  index
		 into this array.

       dbcount	 Specifies a pointer where the size of the dbnames array will be stored.

RETURN VALUE

       DtSearchReinit  returns	DtSrOK	and the current dbnames array if the reinitialization was successful or if reinitialization was not neces-
       sary.

       It returns DtSrERROR and messages on the MessageList on any other condition.

SEE ALSO

       DtSrAPI(3), DtSearchInit(3), DtSearchGetMessages(3), dtsrocffile(4), DtSearch(5)

														      DtSearchReinit(library call)