Proximity Operator
The proximity operator is available in content queries for searching with proximity thresholds (for example, within 40 words of another term, or within the same sentence or paragraph). The proximity operator works as a weighted AND query, where the rank of the match increases as the terms appear "closer" together in the content stream. The proximity operator and its long form and short form are the following.
| Operator | Long form | Short form | Notes |
|---|---|---|---|
| NEAR | {NEARdist = dist_value, unit = unit_value} | Near, ~ | Only the English spelling of the long form is available in Dialect 2. |
In Dialect 1, the proximity operator is localized for several non-English languages. See Incompatibilities of Dialect 2 with Dialect 1 for complete details.
The dist_value of the dist attribute specifies the threshold count of units to use between text clauses. The text clauses must appear within each other's specified counted units. If dist = 0 is specified, the text clauses must all occur within the particular unit.
The unit_value of the unit attribute specifies the distance unit to use. The following table gives the valid values of the unit attribute.
| Value | Description |
|---|---|
| Word | word |
| Sent | sentence |
| Par | paragraph |
| Chap | chapter |
If dist = 0 and unit = sent, then the text clause must appear in the same sentence. If unit = word, then dist = 0 is illegal.
The short-form version of the NEAR operator assumes the default value of 50 for dist and assumes that the unit is word. The following examples are equivalent in Indexing Service.
Dog ~ Cat
Dog near Cat
Dog {near dist = 50, unit = word} Cat