@FtSearch

@FtSearch performs the actual search defined by FTSEARCHHANDLE FTSEARCHHANDLE1.
The parameter FN FNLIMIT2 can be used to limit the number of documents found. If 0 is specified here, all documents are found.
The parameters FN FNSTART5 and FN FNCOUNT6 can be used to define a portion of the found documents for the return value.
(for example, starting at the 20th document, the next 10: FNSTART5=20 FNCOUNT6=10)

IMPORTANT:
For Notes/Domino servers version 4.x:
The parameter FNRETHITS3 always returns 0.
The variant @FtSearch(FTSEARCHHANDLE1;FNLIMT2;FNRETHITS3;SCORESLIST4;FNSTART5;FNCOUNT6); can be called, but the parameters FNSTART5 and FNCOUNT6 are ignored.

SCORESLIST:
If the @Function was executed successfully, a NUMBERLIST (if fewer than 8064 IDs are returned in the return-value list) or an IDList is returned.
This list corresponds to the return-value list and contains the hit relevance. 100 represents the highest relevance and 0 the lowest.

In the parameter FNRETHITS the number of documents found is returned.

Return value:
If the @Function was executed successfully, a FLOATLIST (if fewer than 8064 IDs are returned) or an IDList is returned; otherwise @ERROR.

Example: @FtSearch(FTSEARCHHANDLE1;FNLIMT2;FNRETHITS3;SCORESLIST4;FNSTART5;FNCOUNT6);

DBHANDLE1:=@OpenDB("TEST.NSF");
FTSHANDLE:=@OpenFtSearch(DBHANDLE1;"print";8);
IDL:=@FtSearch(FTSHANDLE;100;FNRETHITS3;RETSCORESLIST;0;20);
FTSHANDLE:=@CloseFtSearch(FTSHANDLE);
DBHANDLE1:=@CloseDB(DBHANDLE1);

A full-text search is opened for the DB "TEST.NSF" and the search string "print" is opened. The option 8 must be specified.
Up to 100 documents are searched for, and the first 20 found documents are assigned to IDL.
In FNRETHITS3 the number of documents found is returned.
The full-text search is then closed again.

Note : This text was machine-translated and may contain inaccuracies.