Strings (dw::core::Strings)

This module contains helper functions for working with strings.

To use this module, you must import it to your DataWeave code, for example, by adding the line import * from dw::core::Strings to the header of your DataWeave script.

Functions

Name Description

Name	Description
appendIfMissing	Appends the `suffix` to the end of the `text` if the `text` does not already ends with the `suffix`.
camelize	Returns a string in camel case based on underscores in the string.
capitalize	Capitalizes the first letter of each word in a string.
charCode	Returns the Unicode for the first character in an input string.
charCodeAt	Returns the Unicode for a character at the specified index.
collapse	Collapses the string into substrings of equal characters.
countCharactersBy	Counts the number of times an expression that iterates through each character in a string returns `true`.
countMatches	Counts the number of matches in a string.
dasherize	Replaces spaces, underscores, and camel-casing in a string with dashes (hyphens).
everyCharacter	Checks whether a condition is valid for every character in a string.
first	Returns characters from the beginning of a string to the specified number of characters in the string, for example, the first two characters of a string.
fromCharCode	Returns a character that matches the specified Unicode.
hammingDistance	Returns the Hamming distance between two strings.
isAlpha	Checks if the `text` contains only Unicode digits. A decimal point is not a Unicode digit and returns `false`.
isAlphanumeric	Checks if the `text` contains only Unicode letters or digits.
isLowerCase	Checks if the `text` contains only lowercase characters.
isNumeric	Checks if the `text` contains only Unicode digits.
isUpperCase	Checks if the `text` contains only uppercase characters.
isWhitespace	Checks if the `text` contains only whitespace.
last	Returns characters from the end of string to a specified number of characters, for example, the last two characters of a string.
leftPad	The specified `text` is left-padded to the `size` using the `padText`. By default `padText` is `" "`.
levenshteinDistance	Returns the Levenshtein distance (or edit distance) between two strings.
lines	Returns an array of lines from a string.
mapString	Applies an expression to every character of a string.
ordinalize	Returns a number as an ordinal, such as `1st` or `2nd`.
pluralize	Pluralizes a singular string.
prependIfMissing	Prepends the `prefix` to the beginning of the string if the `text` does not already start with that prefix.
remove	Removes all occurrences of a specified pattern from a string.
repeat	Repeats a `text` the number of specified `times`.
replaceAll	Replaces all substrings that match a literal search string with a specified replacement string.
reverse	Reverses sequence of characters in a string.
rightPad	The specified `text` is right-padded to the `size` using the `padText`. By default `padText` is `" "`.
singularize	Converts a plural string to its singular form.
someCharacter	Checks whether a condition is valid for at least one of the characters or blank spaces in a string.
substring	Returns a substring that spans from the character at the specified `from` index to the last character before the `until` index.
substringAfter	Gets the substring after the first occurrence of a separator. The separator is not returned.
substringAfterLast	Gets the substring after the last occurrence of a separator. The separator is not returned.
substringBefore	Gets the substring before the first occurrence of a separator. The separator is not returned.
substringBeforeLast	Gets the substring before the last occurrence of a separator. The separator is not returned.
substringBy	Splits a string at each character where the `predicate` expression returns `true`.
substringEvery	Splits a string into an array of substrings equal to a specified length.
underscore	Replaces hyphens, spaces, and camel-casing in a string with underscores.
unwrap	Unwraps a given `text` from a `wrapper` text.
withMaxSize	Checks that the string length is no larger than the specified `maxLength`. If the string’s length is larger than the `maxLength`, the function cuts characters from left to right, until the string length meets the length limit.
words	Returns an array of words from a string.
wrapIfMissing	Wraps `text` with `wrapper` if that `wrapper` is missing from the start or end of the given string.
wrapWith	Wraps the specified `text` with the given `wrapper`.

appendIfMissing

Appends the suffix to the end of the text if the text does not already ends with the suffix.

camelize

Returns a string in camel case based on underscores in the string.

capitalize

Capitalizes the first letter of each word in a string.

charCode

Returns the Unicode for the first character in an input string.

charCodeAt

Returns the Unicode for a character at the specified index.

collapse

Collapses the string into substrings of equal characters.

countCharactersBy

Counts the number of times an expression that iterates through each character in a string returns true.

countMatches

Counts the number of matches in a string.

dasherize

Replaces spaces, underscores, and camel-casing in a string with dashes (hyphens).

everyCharacter

Checks whether a condition is valid for every character in a string.

first

Returns characters from the beginning of a string to the specified number of characters in the string, for example, the first two characters of a string.

fromCharCode

Returns a character that matches the specified Unicode.

hammingDistance

Returns the Hamming distance between two strings.

isAlpha

Checks if the text contains only Unicode digits. A decimal point is not a Unicode digit and returns false.

isAlphanumeric

Checks if the text contains only Unicode letters or digits.

isLowerCase

Checks if the text contains only lowercase characters.

isNumeric

Checks if the text contains only Unicode digits.

isUpperCase

Checks if the text contains only uppercase characters.

isWhitespace

Checks if the text contains only whitespace.

last

Returns characters from the end of string to a specified number of characters, for example, the last two characters of a string.

leftPad

The specified text is left-padded to the size using the padText. By default padText is " ".

levenshteinDistance

Returns the Levenshtein distance (or edit distance) between two strings.

lines

Returns an array of lines from a string.

mapString

Applies an expression to every character of a string.

ordinalize

Returns a number as an ordinal, such as 1st or 2nd.

pluralize

Pluralizes a singular string.

prependIfMissing

Prepends the prefix to the beginning of the string if the text does not already start with that prefix.

remove

Removes all occurrences of a specified pattern from a string.

repeat

Repeats a text the number of specified times.

replaceAll

Replaces all substrings that match a literal search string with a specified replacement string.

reverse

Reverses sequence of characters in a string.

rightPad

The specified text is right-padded to the size using the padText. By default padText is " ".

singularize

Converts a plural string to its singular form.

someCharacter

Checks whether a condition is valid for at least one of the characters or blank spaces in a string.

substring

Returns a substring that spans from the character at the specified from index to the last character before the until index.

substringAfter

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

substringAfterLast

Gets the substring after the last occurrence of a separator. The separator is not returned.

substringBefore

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

substringBeforeLast

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

substringBy

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

substringEvery

Splits a string into an array of substrings equal to a specified length.

underscore

Replaces hyphens, spaces, and camel-casing in a string with underscores.

unwrap

Unwraps a given text from a wrapper text.

withMaxSize

Checks that the string length is no larger than the specified maxLength. If the string’s length is larger than the maxLength, the function cuts characters from left to right, until the string length meets the length limit.

words

Returns an array of words from a string.

wrapIfMissing

Wraps text with wrapper if that wrapper is missing from the start or end of the given string.

wrapWith

Wraps the specified text with the given wrapper.