Operators

Updated on Monday, 8 April, 2013 - 16:33

A stream must always have at least one operator. A simple stream is made up of two or three components:

       target + operator + argument

       target + operator

 

Many of the operators can be preceded by the cs keyword to make them case sensitive.

We recommend that you take a look at the way to handle special characters in CSDL code.

This operator: Performs this function:

contains
cs contains

 

Filter for a word or phrase.

substr
cs substr

 

 Filter for a sequence of characters that form a word or part of a word.

contains_any
cs contains_any
any
cs any

 

Filter for one or more string values from a list of strings.

contains_near
cs contains_near

 

Filter for two or more words that occur near to each other.

exists

 

 Check whether a target is present.

in

 

 Filter for one or more values from a list.

url_in

 

 To filter for an exact match with a normalized URL.

==
!=
cs ==
cs !=

 

 Check whether a string, int, or float is equal to or not equal to an argument.

>
>=
<
<=

 

 Compare a target against a value you specify.

regex_partial

Filter for content that contains text represented in a regular expression.

The text can appear anywhere within the target you select.

 

regex_exact

Filter for content that contains text represented in a regular expression.

The regular expression must match the entire content of the target you choose. 

 

geo_box

 Filter for content originating from geographical locations within a bounding box defined by the upper left and lower right latitude and longitude coordinates of a rectangle.

 

geo_radius

Filter for posts originating inside a circle.

You specify the radius of the circle in kilometers (km) and the center as a pair of latitude and longitude coordinates.

 

geo_polygon

Filter for content originating from geographical locations defined by a polygon with up to 32 vertices.

Each vertex is defined by a pair of latitude and longitude coordinates.

 

Notes

1.  In CSDL, targets, operators and logical operators are not case sensitive so, for example, contains and CONTAINS are both valid.

2.  The maximum size of a rule in CSDL is 1MB.