String Manipulation (Multi Column)

The String Manipulation (Multi Column) node is an extension of the String Manipulation node, applying the provided expression to every selected column in turn. This can be used to search and replace, compare, or concatenate strings in multiple columns at once.

In each iteration, one column name from the selection will be used as replacement for the $$CURRENTCOLUMN$$ placeholder in the expression. For instance, when selecting columns first_name and last_name , the expression capitalize($$CURRENTCOLUMN$$) would first evaluate capitalize($first_name$) and then capitalize($last_name$) .

Simple Examples

Search and Replace

replace($$CURRENTCOLUMN$$, "Old", "New") searches for "Old" and replaces with "New" in all selected columns.

Concatenate Strings

join($$CURRENTCOLUMN$$, $Unit$) appends the string in the Unit column to each string in the selected columns. When selecting the Freeze and Boil columns and appending the results as new columns, the following table could result:

FreezeBoilUnitFreeze with UnitBoil with Unit0100˚C0˚C100˚C32212F32F212F273.15373.15K273.15K373.15K

Advanced Examples

Use Columns or Flow Variables to Control String Manipulation

You can use the value of an integer column to control integer parameters of a string manipulator: substr($$CURRENTCOLUMN$$, $Start Position$) extracts the substring of $$CURRENTCOLUMN$$ that starts at offset k , where k is the integer value in the column Start Position in the current row. For example, when the selected column is Customer and the results are appended as Customer Name Only , the expression substr($$CURRENTCOLUMN$$, $Start Position$) could be used to generate the following ouput:

CustomerStart PositionCustomer Name OnlyMr. Jones3JonesProf. Desmond5Desmond

Flow variables can also be used to control the parameter of a string manipulation function. For instance, if there is an integer flow variable start-position available, the above example could be rewritten as substr($$CURRENTCOLUMN$$, $${Istart-position}$$).

Convert Strings to Missing Values

toNull(replace($$CURRENTCOLUMN$$, "N.A.", "")) searches for "N.A." in all selected columns, replaces them with "" and returns a missing value, if the resulting string is empty ( toNull converts empty strings to a missing value). For multiple strings to replace, a regular expression separating the target strings with | can be used: regexReplace($$CURRENTCOLUMN$$, "N.A.|-", "") . This replaces both occurrences of "N.A." and "-" with empty strings.

Input ports

1. Type: Table
   Input data
   Input data with multiple columns to proces.

Output ports

1. Type: Table
   Output data
   Input data with replaced or appended columns.