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.
List and package types
pkg_default(P;K;D)
Returns a value from a package at a given key position, or returns a default value if the value is invalid. (Available as of version 15.03)

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
  - List and package types
    - conjsel(L)
      Returns a selection expression that consists of the conjunction of the pairs of columns and associated values specified in the given list-value. (Available as of version 11.06)
    - dejson(S;O)
      Converts a JSON string into 1010data values. (Available as of version 11.07)
    - dexml(S;O)
      Converts an XML string into a 1010data XML value or list of values (str → xml). (Available as of version 11.07)
    - encsv(X;FD;RD;QC;O)
      Converts a table or query value X into CSV or other delimiter-separated text. (Available as of version 19.77)
    - enjson(V;O)
      Converts values, including packages and lists, into a JSON string. (Available as of version 11.07)
    - 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)
    - exlst(L;E)
      Remove the contents of list-value E from list-value L.
    - inlst(L1 L2...LN)
      Find the intersection of two or more list-variables.
    - jnlst(L1 L2...LN)
      Returns a single list-value made up of the elements of multiple lists.
    - lst(X)
      Returns a single, indexed list-value when given one or more values.
    - lst_del(L;D)
      Remove the elements in list-value L at the index positions specified in list-value D.
    - lst_drop(L;N)
      Returns a list-value of all elements after a given element.
    - lst_len(L)
      Returns the number of elements in a list-value.
    - lst_pick(L;I)
      Find the value of an element in a list-value from a specified index position.
    - lst_position(L;P)
      Find the index positions of values in list-value L for values that appear in list-value P.
    - lst_remove(L;R)
      Remove elements from list-value L that are found in list-value R. This function does not remove duplicates that appear multiple times in list-value L from the returned list-value.
    - lst_reverse(L)
      Invert the order of the elements of a list-value.
    - lst_take(L;N)
      Returns a list-value containing a given number of elements.
    - lst_to_pkg(K;V)
      Returns a new package value by accepting a list of keys and a list of values of equal lengths.
    - lst_to_str(L;D)
      Returns a delimiter-separated string comprised of the elements in a list-value.
    - mklst(N;X)
      Returns a single, indexed list-value containing multiple instances of the given value.
    - param(M;P;I)
      Returns the numerical value of a particular model parameter extracted from a discrete or continuous model.
    - pkg(K;V)
      Returns a single, indexed list-value containing key-value pairs.
    - pkg_.contains(P;K)
      Returns a boolean indicating whether package P contains key K (a string).
    - pkg_.merge(P1;P2)
      When applied to a package, returns a new package that is the union of P1 and P2, with the values of P2 taking precedence.
    - pkg_.update(P1;P2)
      When applied to a package, returns a new package that is the union of P1 and P2, with the values of P2 taking precedence.
    - pkg_.without(P;K)
      When applied to a package, returns a copy of package P without key(s) K (a string or lst() of strings).
    - pkg_default(P;K;D)
      Returns a value from a package at a given key position, or returns a default value if the value is invalid. (Available as of version 15.03)
    - pkg_get(P;K)
      Returns a value from a package at a given key position.
    - pkg_names(X)
      Returns a single, indexed list-value containing the key values from a specified package variable.
    - qv(X)
      Returns a properly quoted and escaped string for insertion in Macro Language code.
    - str_to_lst(S;D)
      Returns a list-value from a delimiter-separated string.
    - table(P;)
      Produces a table value from a dictionary.
    - unlst(L1 L2...LN)
      Find the union of two or more list-values.
- 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.

`pkg_default(P;K;D)`

Returns a value from a package at a given key position, or returns a default value if the value is invalid. (Available as of version 15.03)

Syntax

pkg_default(P;K;D)

Input

Argument	Type	Description
`P`	any	The name of a package variable
`K`	any	The name of a key
`D`	any	If `P` does not contain the key `K` or its value does not have the same type as `D`, it will return the value in `D`.

Return Value

Returns a single value from a package at position K. The return type will always match that of the default value (D).

If P is N/A, an error is returned.

If the value at position K is N/A, the default (D) is returned.

If the value at position K is of a different type than D, the default (D) is returned.

If the value at position K is a charvec/cstring while D is a symbol (or vice versa), pkg_default(P;K;D) returns the value at position K, but it will convert the value to match the value in D.

Sample Usage

As an example, the following function call:

value="{pkg_default(@package;'keyN';'default')}"

returns the value located at keyN in list-value @package. If there is no value at keyN or if the type of keyN is different from the type of default, the function returns default.

Example

The following example shows how dejson(string;) converts a "mixed" JSON string into package of name-value pairs that 1010data can use, and then pkg_default(P;K;D) returns a scalar value located at key position K in package P.

<base table="default.test.json"/>
<colord cols="mixed"/>
<willbe name="p" value="dejson(mixed;'symbols')"/>
<willbe name="a" value="pkg_default(p;'a';98.6)"/>
<willbe name="c" value="pkg_default(p;'c';'noun')"/>

The resulting table is as follows:

In column p, dejson(string;) converts the mixed JSON into a package of name-value pairs. Column a contains the value of a, and column c contains the value of c. In the third row of the table, the data type for c does not match the default, so the default value, noun, is used. The last row of the table does not contain an a or c value at all, so the a and c columns contain the default values 98.6 and noun, respectively.