Contact Us 1-800-596-4880
  1. Homepage
  2. DataWeave (2.1)
  3. DataWeave Reference
  4. Core (dw::Core)

  5. splitBy

splitBy

DataWeave 2.1 is compatible with Mule 4.1. Standard Support for Mule 4.1 ended on November 2, 2020, and this version of Mule will reach its End of Life on November 2, 2022, when Extended Support ends.

Deployments of new applications to CloudHub that use this version of Mule are no longer allowed. Only in-place updates to applications are permitted.

MuleSoft recommends that you upgrade to the latest version of Mule 4 that is in Standard Support so that your applications run with the latest fixes and security enhancements.

splitBy(String, Regex): Array<String>

Splits a string based on a regex.

The separator can match any character in the input. Note that splitBy performs the opposite operation of joinBy.

Parameters

Name Description

text

The string to split.

regex

A regular expression used to separate string. If it does not match some part of the string, the function will return the string unseparated in an array.

Example

This example uses the regular expression \/^*.b./\ to find and use -b- as a separator. Notice that the separator is omitted from the output.

Source

%dw 2.0
output application/json
---
{ "split" : "a-b-c" splitBy(/^*.b./) }

Output

{
  "split": ["a","c"]
}

splitBy(String, String): Array<String>

Splits a string based on a separator.

The separator can match any character in the input. Note that splitBy performs the opposite operation of joinBy.

Parameters

Name Description

text

The string to split.

separator

A string used to separate the input string. It must match some part of the string.

Example

This example uses the hyphen (-) as the separator. Note that the selector is not retained in the output.

Source

%dw 2.0
output application/json
---
{ "split" : "a-b-c" splitBy("-") }

Output

{
  "split": ["a", "b", "c"]
}