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.
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.
Delimited lists
position(X;L)
Returns the position of a given value in a specified list.

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.
- 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.
  - Delimited lists
    - csl_drop(X;Y)
      Returns all but the first number of elements in a given comma-separated list.
    - csl_len(X)
      Returns the number of elements in a given comma-separated list.
    - csl_pick(X;Y)
      Returns a particular element in a given comma-separated list.
    - csl_take(X;Y)
      Returns the first number of elements in a given comma-separated list.
    - pick(X;L)
      Returns the item in a specified list at the position denoted by the given value.
    - position(X;L)
      Returns the position of a given value in a specified list.
    - strdrop(X;Y;N)
      Returns all but the first number of characters, or the substring consisting of all but the first number of elements delimited by a particular value, within a given string.
    - strpick(X;Y;I)
      Returns the character at a particular position, or the element delimited by a particular value, within a given string.
    - strreverse(X;Y)
      Returns the characters, or the elements delimited by a particular value, of a given string in reverse.
    - strsort(X;Y;U;D)
      Returns the characters, or the elements delimited by a particular value, of a given string sorted in ascending or descending order.
    - strsplit(X;Y;I)
      Returns the character at a particular position, or the substring delimited by a particular value, within a given string.
    - strsplitpos(X;Y;I)
      Returns the position of a certain element delimited by a particular value within a given string.
    - strtake(X;Y;N)
      Returns the first number of characters, or the substring consisting of the first number of elements delimited by a particular value, within a given string.
  - List and package types
- 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.

`position(X;L)`

Returns the position of a given value in a specified list.

Syntax

position(X;L)

Input

Argument	Type	Description
`X`	any	The value to find within in the list `L` A column name
L	any	A space or comma-separated literal list of values All of the values in `L` must be the same type as `X`.

Return Value

Returns an integer value corresponding to the position of X in L. If X is not in L, the value returned is one plus the number of items in L.

If X is N/A, the result is N/A. However, if X is the empty string (''), and L contains one or more empty strings, the result is the position of the first empty string in the list.

Sample Usage


`X`	`L`	`position(X;L)`
'b'	'a' 'b' 'c'	2
100	1,10,100	3
1.9	1.1 1.2 1.3	4
NA	2.1,21.0,1.1,11.0	5
''	'2.1','','1.1',''	2
''	'2.1','21.0','1.1','11.0'	5

Example

Selecting the position of the 'bar' element from the literal list of values supplied to the position() function.

<base table="default.lonely"/>
<willbe name="position_result" value="position('bar';'foo' 'bar' 'baz')"/>

Returns the following table:

Position Result