r_mapstring(C;S;X;D)
Returns a string consisting of a list of elements, each of which is the result of evaluating an expression on the current column, concatenated together using the specified delimiter.
Function type
Vector only
Syntax
r_mapstring(C;S;X;D)
Input
Argument | Type | Description |
---|---|---|
C |
any | A space- or comma-separated list of column names
If Note: The columns specified by
C must be either all numeric
(integer and decimal) or all text. |
S |
integer | A boolean column or an expression in
rcv_ /rcn_ /rct_ which determines
whether or not that column is selected to be included in the calculation. See System variables for more information about
rcv_ /rcn_ /rct_ .If
|
X |
any | A column nameX is an expression that is used to transform the value or
name of each of the selected columns.Note: Use the system variables
rcv_ and rcn_ to reference the column value
and name, respectively. |
D |
text | A scalar value or the name of a column The character to be used as the delimiter in the resultant string. If
|
Return Value
For each row of the table, r_mapstring
returns a text value that consists
of a list of elements delimited by D
. The list of elements is comprised of
the value or name of each selected column (as specified by C
and
S
) transformed using the expression defined by X
. If
X
is omitted, then the values are simply the values of each column (or
rcv_
, the default). If C
is a matching expression that
matches no columns, or if S
is false for all matching columns at a
particular row, r_mapstring
returns an empty string.