String actions

11 actions in the String category. Each block mirrors how the action appears in the editor's sidebar.

Build String

Every Frame

Build String String

Prefix '' | Value '' | Suffix ''

Joins a prefix, a value, and a suffix into one piece of text and stores it. The value is turned into text first, so any type works.

Input	Type	Default	Description
Prefix	String	''	Text placed before the value.
Value	Variant	''	The value to turn into text and place in the middle.
Suffix	String	''	Text placed after the value.

Output	Type	Description
Result	String	Where to store the joined text.

Phases StartEvery FramePhysicsEnd

Format String

Every Frame

Format String String

Template '%s' | Value ''

Fills placeholders in a template with a value and stores the result. A value bound to an array fills several placeholders at once.

Input	Type	Default	Description
Template	String	'%s'	The text with placeholders such as %s to fill in.
Value	Variant	''	The value to place into the template.

Output	Type	Description
Result	String	Where to store the filled-in text.

Phases StartEvery FramePhysicsEnd

Join Text

Every Frame

Join Text String

Array not set | Separator ', '

Joins the items of an array into one piece of text, placing a separator between them.

Input	Type	Default	Description
Array	Array	-	The array of items to join.
Separator	String	', '	The text placed between each item.

Output	Type	Description
Result	String	Where to store the joined text.

Phases StartEvery FramePhysicsEnd

Pad Number

Every Frame

Pad Number String

Value '' | Width 4 | Pad '0'

Pads text on the left with a character until it reaches a width. This is what turns 42 into 0042 for a scoreboard.

Input	Type	Default	Description
Value	String	''	The text or number to pad.
Width	int	4	The least number of characters the result should have.
Pad	String	'0'	The single character used to fill the gap.

Output	Type	Description
Result	String	The padded text.

Phases StartEvery FramePhysicsEnd

String Case

Every Frame

String Case String

Function 'to_upper' | Value ''

Transforms text using the chosen method and stores the result.

Input	Type	Default	Description
Function	String	'to_upper'	The transformation to apply to the text.
Value	String	''	The text to transform.

Output	Type	Description
Result	String	Where to store the transformed text.

Phases StartEvery FramePhysicsEnd

String Contains

Every Frame

String Contains String

Value '' | Substring '' | → True | → False

Answers whether a piece of text appears inside another. It can branch on the answer or hand it to a field that takes a yes or no.

Input	Type	Default	Description
Value	String	''	The text to search within.
Substring	String	''	The piece of text to look for.

Output	Type	Description
Yes	bool	Where to store whether the text was found.

Branch	Goes to
True	Where to go when the substring is found.
False	Where to go when the substring is not found.

Phases StartEvery FramePhysics

String Length

Every Frame

String Length String

''

Counts how many characters a piece of text holds and stores the number.

Input	Type	Default	Description
Value	String	''	The text to measure.

Output	Type	Description
Length	int	Where to store the number of characters.

Phases StartEvery FramePhysicsEnd

String Replace

Every Frame

String Replace String

Value '' | From '' | To ''

Replaces every occurrence of one piece of text with another and stores the result.

Input	Type	Default	Description
Value	String	''	The text to search through.
From	String	''	The piece of text to replace.
To	String	''	The text to put in its place.

Output	Type	Description
Result	String	Where to store the updated text.

Phases StartEvery FramePhysicsEnd

String Split

Every Frame

String Split String

Value '' | Separator ' '

Splits text into pieces wherever a separator appears and stores them as an array.

Input	Type	Default	Description
Value	String	''	The text to split.
Separator	String	' '	The text that marks where to split.

Output	Type	Description
Result	Array	Where to store the array of pieces.

Phases StartEvery FramePhysicsEnd

To Text

Every Frame

To Text String

Value 0 | Format 'whole'

Turns a number into text in the chosen format. Use it to feed a label without writing the conversion by hand.

Input	Type	Default	Description
Value	Variant	0	The number to turn into text.
Format	String	'whole'	How much of the number to keep. Whole rounds to the nearest, cut drops the decimals.

Output	Type	Description
Result	String	Where to store the resulting text.

Phases StartEvery FramePhysicsEnd

Trim Text

Every Frame

Trim Text String

''

Removes the spaces and line breaks from the start and end of a piece of text. Useful to clean up what was typed into a field.

Input	Type	Default	Description
Value	String	''	The text to trim.

Output	Type	Description
Result	String	The trimmed text.

Phases StartEvery FramePhysicsEnd