Home
Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
Categorization functions
Categorization functions are vector functions that organize data and determine logical groupings. These functions can be used for conditionalizing results and/or bucketing value ranges.
Conditional
case(X;V1;R1;V2;R2;...;D)
Returns the value corresponding to the case that a given value matches; if no cases match, returns the specified default value.

Function Reference
1010data Insights Platform offers a rich set of functions that may be used in value expressions when creating computed columns and in selection expressions when performing row selections.
- All 1010data Functions
  1010data provides a whole range of functions that can provide information and act on your data.
- Time/Date functions
  The time/date functions are vector functions that operate on columns containing time-related data and return specific information about the date/time for each row.
- Group functions (g_functions)
  Group functions, or g_functions, are used to perform operations, such as summarizations, on rows that have the same values in a set of given columns.
- Math functions
  Math functions are vector functions that perform mathematical operations on one or more columns and return a column of results based on the operation.
- Matrix functions
- Categorization functions
  Categorization functions are vector functions that organize data and determine logical groupings. These functions can be used for conditionalizing results and/or bucketing value ranges.
  - Conditional
    - case(X;V1;R1;V2;R2;...;D)
      Returns the value corresponding to the case that a given value matches; if no cases match, returns the specified default value.
    - decode(X;V1 V2 ...;R1 R2 ... RD)
      Returns the value from the second list that corresponds to the particular element a given value matches in the first list; if there are no matches, returns the specified default value.
    - g_and(G;S;X)
      Returns a boolean value indicating whether all values within a given group are true.
    - g_cumand(G;S;O;X)
      Returns a boolean value indicating whether all values up to and including a particular row within a given group are true.
    - g_cumor(G;S;O;X)
      Returns a boolean value indicating whether any value up to and including a particular row within a given group is true.
    - g_or(G;S;X)
      Returns a boolean value indicating whether any value within a given group is true.
    - if(C1;R1;C2;R2;...;D)
      Returns the value corresponding to the first condition that evaluates to true; if no conditions are true, it returns the specified default value.
    - iff(C1;R1;C2;R2;...;D)
      Returns the value corresponding to the first condition that evaluates to true; if no conditions are true, it returns the specified default value. (Available as of version 18.40)
    - ifinf(X;Y)
      Returns a specified value when the value in a given column is an infinite value.
    - ifnull(X;Y)
      Returns a specified value when the value in a given column is N/A.
    - nullif(X;Y)
      Returns N/A if the two given values match.
    - nullinf(X)
      Returns N/A if the given value is an infinite value.
    - rep(X;L)
      Returns the value paired up with the first item in a specified list that matches the given value.
  - Bucketing
- String functions
  String functions are vector functions that manipulate vectors of strings to provide information about a string or substring, concatenate and split strings, or transform strings based on specified criteria.
- List functions
  List functions are scalar functions that return lists, subsets of lists, and combinations of lists, among other functionality. Lists, along with packages, are compound scalar data types that facilitate programmatic interaction with scalar data values and variables.
- Data-handling functions
  Data-handling functions are vector functions that return a hash value based on an input column or columns.
- Row functions
  Row functions are vector functions that return computational outputs for row inputs, as opposed to column outputs. Row inputs are defined as a space- or comma-separated list of column names.
- SQL compatibility functions
  SQL compatibility functions are functions that treat null values as SQL nulls.
- Financial functions
- System functions
  System functions are special functions in 1010data that return information about users, tables, and other system objects.
- Object functions
  The object functions can be used to check the existence, type, and accessibility of objects such as folders, tables, and queries on the 1010data Insights Platform.
- Miscellaneous functions
  This category of functions contains special functions that don't neatly fit into other categories of functions.

`case(X;V1;R1;V2;R2;...;D)`

Returns the value corresponding to the case that a given value matches; if no cases match, returns the specified default value.

Syntax

case(X;V1;R1;V2;R2;...;D)

Input

Argument	Type	Description
`X`	any simple type	A scalar value or the name of a column
`V[N]`	any simple type	The value (or expression that evaluates to a value) to test for equality to `X`. The values specified for all instances of `V` must be the same type as `X`. A scalar value or the name of a column
`R[N]`	any simple type	The value to return if `V[N]` matches `X`. The values specified for all instances of `R` must be the same type (integer, decimal, or text). A scalar value or the name of a column
`D`	any simple type	The default return value (if `X` doesn't match any of the instances of `V`). The value specified for `D` must be the same type as the values specified for all instances of `R`. A scalar value or the name of a column

Note: There must be an even number of arguments (i.e., X, a series of C and R pairs, and one D argument).

Return Value

Returns a numeric or text value (depending on the type of the elements specified for R and D) corresponding to the following:

If X is V1, return R1; else if X is V2, return R2; and so on.
If X does not match any of the values specified by V[N], return D.

If any of the values corresponding to C[N] are N/A, an error is returned.

Sample Usage


`X`	`V1`	`R1`	`V2`	`R2`	`V3`	`R3`	`D`	`case(X;V1;R1;V2;R2;V3;R3;D)`
2	1	'one'	2	'two'	3	'three'	'too many'	'two'
99	1	'one'	2	'two'	3	'three'	'too many'	'too many'

Example

Let's use the table pub.demo.retail.item to illustrate the use of case(X;V1;R1;V2;R2;...;D).

Let's say we have three stores and that store 1 is located in New York, store 2 is located in Miami, and store 3 is in London. To add a column to our table that corresponds to the location for each store, we can use the following Macro Language code:

<willbe name="location" value="case(store;1;'New York';2;'Miami';3;'London';'Not a valid location')"/>

This will give us the following new column:

Since, in our example, there are no values in the store column that are not 1, 2, or 3, the default value ('Not a valid location') is never used.