MAS (1)

Filters

A lot of methods accept a filter parameter. This parameter can be used to filter on specific fields in the output. We use a special custom-made syntax for this parameter, which allows you to filter on all fields in the returned structure. The syntax consists of a field name, followed by an operator, followed by a value. The field name is alphabetical and case-sensitive. The value can optionally be quoted in single- or double-quotes. Quoting is required to search for a value with a single- or double-quote, comma or space in it. The backslash can be used to escape quotes and commas. Multiple filters can be joined together using a comma. Whitespace around the operator and comma is ignored.

Operators

• == or =: Check for exact value.
• ~=: Check for extact string value, case-insensitive.
• !=: Check for non-equal value.
• >, <, >=, <=: Standard mathematical operators.
• *=: Contains: search for text in string or for item in list (exact matching).
• ^=: Search for start of a value.
• $=: Search for end of a value.

Examples

• Year=2007, Actors*='George Clooney': Look for items from 2007 in which George Clooney starred.
• Title^=A, Year >= 2007: Look for items from 2007 or newer which start with the A.

Sorting

All methods that return a list accept a sort and order parameter. The sort parameter can be used to specify on which field there should be sorted. The accepted values are listed along with the method in the documentation. The order parameter sets the order, 0 for ascending (default) and 1 for descending.

Providers

See the separate article for more details about this.