Text Manipulation

Perform common text manipulation functions

Component key: text-manipulation

Description#

The text manipulation component allows you to perform common methods on some text. For example, you can join two or more strings together with the join action, find text with the match action, replace text with the replace function, and more.

Actions#

Decode Base64#

Convert the input string from base64 encoding | key: decodeBase64

InputKeyNotesExample

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

Encode Base64#

Convert the input string to base64 encoding | key: encodeBase64

InputKeyNotesExample

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

Extract Substring#

Extract a substring from a string | key: slice

InputKeyNotesExample

Slice start

string
/ Required
sliceStartThe index on which to start the slice of the text.5

Slice stop

string
sliceStopThe index on which to stop the slice of the text.7

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

This action uses the JavaScript slice method to extract substrings from a string.


Find & Replace#

Find and replace all instances of one substring with another | key: replace

InputKeyNotesExample

Substring to find and be replaced

string
/ Required
findThis is the substring that is to be replaced.Hi

The substring to replace instances of 'find' with

string
/ Required
replaceThe substring to replace instances of 'find' with. Can be a string or regular expression.Hello

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

This action uses the JavaScript replace method and a regex global flag to replace all instances of find with replace. Find can be a regular expression or a string.


Join#

Join strings together using an optional separator to form a single string. | key: join

InputKeyNotesExample

Separator

string
separatorThe character to split or concatenate text on./

Strings

string
stringsA set of strings to join together into a single string.

This action is helpful when you want to generate messages, file paths, etc., based off of results from several steps.

As an example, suppose you would like to generate a file path of the form:

${bucketName}://${customerName}/items/${itemNumber}.txt

Where bucketName and customerName are config variables, and itemNumber is an output from a previous step. You can reference the config variables, and step output, and place string literals (://, etc) between them:


Lower Case#

Convert the input string to lower case | key: lowerCase

InputKeyNotesExample

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

Match Regex#

Match a string against a regular expression | key: match

InputKeyNotesExample

Regex

string
/ Required
regexA regular expression to match against the text that is supplied.^[A-Z0-9._%+-]{1,64}@(?:[A-Z0-9-]{1,63}\.){1,125}[A-Z]{2,63}$

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

This action applies the Javascript match method to the text you input with a regex global flag.

For example, if you enter The quick brown fox jumps over the lazy dog. It barked. as your text input, and [A-Z] as your regular expression, this action will return the list ["T","I"].


Remove Whitespace#

Remove leading and trailing whitespace from a string | key: trim

InputKeyNotesExample

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

This action will remove leading and trailing whitespace, converting something like " This is a test! " to "This is a test!".


Split String#

Split a string into a list of strings on a separator character | key: split

InputKeyNotesExample

Separator

string
separatorThe character to split or concatenate text on./

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?

This action is useful to split a string into a list of strings. For example, given a string /usr/local/lib/python3 and separator /, this action produces ["usr","local","lib","python3"].


Upper Case#

Convert the input string to UPPER CASE | key: upperCase

InputKeyNotesExample

Text

string
/ Required
textThis is the text to manipulateHello, world; how are you?