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.
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.
Concatenation
colunion(X;Y)
Returns a string consisting of the union of values from a given set of columns concatenated together using the specified separator, sorted in ascending order.

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.
  - Length
  - Position
  - Case
  - Substrings
  - Concatenation
    - colunion(X;Y)
      Returns a string consisting of the union of values from a given set of columns concatenated together using the specified separator, sorted in ascending order.
    - g_splice(G;S;O;X;D;N)
      Returns a concatenated list of values ordered in a specified manner within a given group.
    - g_uval(G;S;X;D;N)
      Returns a concatenated list of distinct values within a given group.
    - padleft(X;Y)
      Returns the given string with a certain number of characters, adding blanks at the beginning if necessary.
    - padright(X;Y)
      Returns the given string with a certain number of characters, adding blanks at the end if necessary.
    - r_splice(C;S;D)
      Returns a string consisting of a list of elements across a given set of columns, concatenated together using the specified delimiter.
    - repstr(X;L)
      Returns the given string with substrings replaced based on a given list of string pairs.
    - splice(X;Y)
      Returns a string consisting of the list of given values concatenated together using the specified separator.
    - strembed(X;N;P;Y;D)
      Returns a given string embedded within a template that consists of a string value repeated a particular number of times.
    - strrepeat(X;N)
      Return the given string repeated a certain number of times.
  - Comparison
  - Transformations
  - Regular expressions
- 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.

`colunion(X;Y)`

Returns a string consisting of the union of values from a given set of columns concatenated together using the specified separator, sorted in ascending order.

Syntax

colunion(X;Y)

Input

Argument	Type	Description
`X`	any	A list of column names
`Y`	text	One or more characters to be used as the separator

Return Value

For each row of the table, colunion returns the text string consisting of the union of the values for that row from all columns in X, concatenated together using the separator specified by Y. The values in the resultant string are sorted in ascending order. Duplicate values are eliminated in the union. This function provides a way of combining the values of several columns into one column.

Note: Numeric values are automatically converted to text.

N/A values are ignored.

Sample Usage


`values`	`sep`	`colunion(values;sep)`
'dog' 'cat' 'dog'	','	'cat,dog'

Example

In the "Product Master" table (pub.demo.retail.prod), let's say we wanted to create a computed column that consisted of the division (div), department number (dept), and department description (deptdesc), separated by slashes ("/"). We could do this by using the colunion(X;Y) function and specifying the three column names in the list for the X parameter and the slash for the Y parameter.

<base table="pub.demo.retail.prod"/>
<willbe name="colunion_results" 
 value="colunion(dept div deptdesc;'/')"/>
<colord cols="colunion_results"/>

This would give us the following results:

Note: Although the column names are specified to the function in the order: dept, div, and deptdesc, colunion orders the results in ascending order. So, in our example, the results are ordered: div, dept, and deptdesc.