split
This block is part of the value group and was last modified in core v13.0.8.
split v13.0.8 takes a pattern and divides this string into an ordered list of substrings by searching for the pattern, puts these substrings into an array, and returns the array
- value required
value - separator required
value - limit
v13.0.8numberA non-negative integer specifying a limit on the number of substrings to be included in the array. If provided, splits the string at each occurrence of the specified separator, but stops when limit entries have been placed in the array. Any leftover text is not included in the array at all.
- join exceeding
v13.0.8conditionWill join the exceeding entries and add them to the last item in the array if set to true.
- array
array
Splits value_0 on the LITERAL separator value_1 (not a regex) into an array of strings. When limit is 0 or greater the array is capped at limit entries and the leftover text is DROPPED, unless join_exceeding=true, which appends the entire remainder (separators included) to the last entry. Example: "a,b,c" sep="," limit=2 -> ["a","b"]; with join_exceeding=true -> ["a","b,c"]. limit=0 yields []; an empty separator splits into single characters.
array split |
A typical wiring for split: value feeds the value_0 pin; number feeds the limit pin; value feeds the value_1 pin; the array out pin feeds get at index.
Commonly used with
In production blueprints, this block is most often wired together with:
- value: feeds into this block. Simply returns the provided value.
- get at index: this block feeds into it. Returns the element stored at the given zero-based index. An index outside the array, or an element that is null, outputs null.
- get last item: this block feeds into it. Get the last item from the array.
- number: feeds into this block. Generates a valid number from the filled custom value in the blueprint.
- create: feeds into this block. Creates a new function that can be executed using the given name.
- get first item: this block feeds into it. Get the first item from the array.
Version history
Introduced in v13.0.8.
Back to
value Return to the main group to view all sub-groups Back to value Return to the group to view all blocks within this group