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.
Transformations
string(X)
Returns the input value expressed as a text string.

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
  - Comparison
  - Transformations
    - dexml(S;O)
      Converts an XML string into a 1010data XML value or list of values (str → xml). (Available as of version 11.07)
    - enhtml(X;Z)
      Returns an HTML-encoded version of the given string. (Available as of version 11.25)
    - enxml(V;O)
      Converts a 1010data XML value, or a list of values, into an XML string (xml → str). (Available as of version 11.07)
    - lst_to_str(L;D)
      Returns a delimiter-separated string comprised of the elements in a list-value.
    - prettyxml(X;)
      Converts an XML special value X into a fully formatted (indented, etc.) text representation. (Available as of version 16.13)
    - qv(X)
      Returns a properly quoted and escaped string for insertion in Macro Language code.
    - regex_subst(X;L;Y;I;Z)
      Returns the given string with a particular match (or all matches) of a specified regular expression replaced by a given substring.
    - str_to_lst(S;D)
      Returns a list-value from a delimiter-separated string.
    - strdist(X;Y;M;N)
      Returns the edit distance between two given strings using a specified method.
    - stredit(X;P;N;Y)
      Returns a given string, with a specified number of characters starting at a certain position replaced by a given substring.
    - 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.
    - string(X)
      Returns the input value expressed as a text string.
    - strmap(X;Y;Z;C)
      Returns the given string with certain characters replaced or deleted according to a particular mapping.
    - strrange(X)
      Returns the unique characters of a given string sorted in ascending order.
    - 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.
    - strsubst(X;Y;I;Z)
      Returns the given string with a particular occurrence (or all occurrences) of a given substring replaced with a different substring.
    - strtrim(X;Y;C;D)
      Returns the given string with certain characters trimmed from either or both ends.
    - transcode(X;F;T;S;O)
      Converts a string from one encoding into a different encoding. (Available as of version 12.24)
    - urldecode(X)
      Converts raw URI, URL, or HTTP messages with hex-encoded values into human-readable strings.
  - 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.

`string(X)`

Returns the input value expressed as a text string.

Syntax

string(X)

Input

Argument	Type	Description
`X`	any	The value on which to apply the function A scalar value or the name of a column

Return Value

Returns the input value expressed as a text string. If X is a number, it is converted to text.

If X is N/A, the result is N/A.

Example

In the "Monthly Statewide Seasonally Adjusted Unemployment Statistics" table (pub.fin.fred2.bls.smsa), you can create a computed column that displays the value in the column named unemp_rate expressed as a text value.

<base table="pub.fin.fred2.bls.smsa"/>
<willbe name="example" value="string(unemp_rate)" 
label="String`Rate"/>

For a value of 6.6, the result would be "6.6".

For a value of 11.0, the result would be "11".

You can create a computed column that displays the value in the month column expressed as a text value.

<note type="base">Applied to table: pub.fin.fred2.bls.smsa</note>
<willbe name="month_example" value="string(month)" label="String`Month"/>

For a value of 01/76, the result would be "197601" because the value of the underlying integer in <month> form is 197601. It is displayed as 01/76 in the table because of the display format applied to the month column.