substringBy

substringBy(text: String, predicate: (character: String, index: Number) -> Boolean): Array<String>

Splits a string at each character where the predicate expression returns true.

Introduced in DataWeave version 2.4.0.

Parameters

Name Description

Name	Description
`text`	The string to split. The string is treated as an array of characters.
`predicate`	Expression that tests each character and returns a Boolean value. The expression can iterate over each character and index of the string.

text

The string to split. The string is treated as an array of characters.

predicate

Expression that tests each character and returns a Boolean value. The expression can iterate over each character and index of the string.

Example

This example splits a string where any of the specified characters ("~", "=", or "_") are present.

Source

%dw 2.0
import substringBy from dw::core::Strings
output application/json
---
"hello~world=here_data-weave" substringBy $ == "~" or $ == "=" or $ == "_"DataWeave

Output

["hello", "world", "here", "data-weave"]Json

substringBy(text: Null, predicate: (character: Nothing, index: Nothing) -> Any): Null

Helper function that enables substringBy to work with a null value.

Introduced in DataWeave version 2.4.0.