substringBefore

substringBefore(String, String): String

Gets the substring before the first occurrence of a separator. The separator is not returned.

Introduced in DataWeave 2.2.0. Supported by Mule 4.2 and later.

Parameters

Name Description

Name	Description
`text`	The input string.
`separator`	String to search for.

text

The input string.

separator

String to search for.

Example

This example shows how substringBefore behaves with different inputs and sizes.

Source

%dw 2.0
import * from dw::core::Strings
output application/json
---
{
  "a": substringBefore(null, "'"),
  "b": substringBefore("", "-"),
  "c": substringBefore("abc", "b"),
  "d": substringBefore("abc", "c"),
  "e": substringBefore("abc", "d"),
  "f": substringBefore("abc", "")
}DataWeave

Output

{
  "a": null,
  "b": "",
  "c": "a",
  "d": "ab",
  "e": "",
  "f": ""
}JSON

substringBefore(Null, String): Null

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