Operators

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.

See also: logical operators.

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 values from a list of strings.
wildcard
cs wildcard
wild
cs wild		 Perform contains_any filtering with wildcards.
contains_all
cs contains_all
all
cs all		 Filter for all the 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 filter in CSDL is 1MB including any comments embedded in the filter.