Removes all whitespace from a string, including leading and trailing whitespace and all whitespace within the string.
Spacing between words is removed.
Wrangle vs. SQL: This function is part of Wrangle, a proprietary data transformation language. Wrangle is not SQL. For more information, see Wrangle Language.
Basic Usage
Column reference example:
removewhitespace(MyName)
Output: Returns the value of the MyName column value with all whitespace removed.
String literal example:
removewhitespace(' Hello, World ')
Output: Returns the string: Hello,World.
Syntax and Arguments
removewhitespace(column_string)
| Argument | Required? | Data Type | Description |
|---|---|---|---|
| column_string | Y | string | Name of the column or string literal to be applied to the function |
For more information on syntax standards, see Language Documentation Syntax Notes.
column_string
Name of the column or string constant to be cleaned of whitespace.
- Missing string or column values generate missing string results.
- String constants must be quoted (
'Hello, World'). - Multiple columns and wildcards are not supported.
Usage Notes:
| Required? | Data Type | Example Value |
|---|---|---|
| Yes | String literal or column reference | myColumn |
Tip: For additional examples, see Common Tasks.
Examples
Example - String cleanup functions together
TRIM- remove leading and trailing whitespace. See TRIM Function.REMOVEWHITESPACE- remove leading and trailing whitespace and all whitespace in between. See REMOVEWHITESPACE Function.REMOVESYMBOLS- remove all characters that are not alpha-numeric or whitespace. See REMOVESYMBOLS Function.
Source:
In the following (space) and (tab) indicate space keys and tabs, respectively. Carriage return and newline characters are also supported by whitespace functions.
| Strings | source |
|---|---|
| String01 | this source(space)(space) |
| String02 | (tab)(tab)this source |
| String03 | (tab)(tab)this source(space)(space) |
| String04 | this source's? |
| String05 | Why, you @#$%^&*()! |
| String06 | this söurce |
| String07 | (space)this söurce |
| String08 | à mañana |
Transformation:
The following transformation steps generate new columns using each of the string cleanup functions:
| Transformation Name | New formula |
|---|---|
| Parameter: Formula type | Single row formula |
| Parameter: Formula | TRIM(source) |
| Parameter: New column name | 'trim_source' |
| Transformation Name | New formula |
|---|---|
| Parameter: Formula type | Single row formula |
| Parameter: Formula | REMOVEWHITESPACE(source) |
| Parameter: New column name | 'removewhitespace_source' |
| Transformation Name | New formula |
|---|---|
| Parameter: Formula type | Single row formula |
| Parameter: Formula | REMOVESYMBOLS(source) |
| Parameter: New column name | 'removesymbols_source' |
Results:
| Strings | source | removesymbols_source | removewhitespace_source | trim_source |
|---|---|---|---|---|
| String01 | this source(space)(space) | this source(space)(space) | thissource | this source |
| String02 | (tab)(tab)this source | (tab)(tab)this source | thissource | this source |
| String03 | (tab)(tab)this source(space)(space) | (tab)(tab)this source(space)(space) | thissource | this source |
| String04 | this source's? | this sources | thissource's? | this source's? |
| String05 | "Why, you @#$%^&*()!" | Why you | Why,you@#$%^&*()! | Why, you @#$%^&*()! |
| String06 | this söurce | this söurce | thissöurce | this söurce |
| String07 | (space)this söurce | (space)this söurce | thissöurce | this söurce |
| String08 | à mañana | à mañana | àmañana | à mañana |
This page has no comments.