Loading TOC...

cts.notQuery

cts.notQuery(
   $query as cts.query
) as cts.notQuery

Summary

Returns a query specifying the matches not specified by its sub-query.

Parameters
$query A negative query, specifying the search results to filter out.

Usage Notes

The cts:not-query constructor is fragment-based, so it returns true only if the specified query does not produce a match anywhere in a fragment. Therefore, a search using cts:not-query is only guaranteed to be accurate if the underlying query that is being negated is accurate from its index resolution (that is, if the unfiltered results of the $query parameter to cts:not-query are accurate). The accuracy of the index resolution depends on the many factors such as the query, if you search at a fragment root (that is, if the first parameter of cts:search specifies an XPath that resolves to a fragment root), the index options enabled on the database, the search options, and other factors. In cases where the $query parameter has false-positive matches, the negation of the query can miss matches (have false negative matches). In these cases, searches with cts:not-query can miss results, even if those searches are filtered.

Example

  cts.search(
    cts.notQuery(
      cts.wordQuery("summer")));
  => ...  a ValueIterator of documents not containing
          any text node with the word 'summer'.

Example

// Insert the following documents:

declareUpdate();
var doc1 = {doc:"Dogs, cats, and pigs"}; 
var doc2 = {doc:"Trees, frogs, and cats"};
var doc3 = {doc:"Dogs, alligators, and wolves"};
xdmp.documentInsert("/cat1.json", doc1);
xdmp.documentInsert("/cat2.json", doc2);
xdmp.documentInsert("/nocat.json", doc3);

******
// Now run the following search:

cts.search(cts.notQuery("cat"));

=>
The document /nocat.json with the following json:

{"doc":"Dogs, alligators, and wolves"}

Comments

    Powered by MarkLogic Server 7.0-4.1 and rundmc | Terms of Use | Privacy Policy