$removeSplitTextElement — Remove Split Text Element

$removeSplitTextElement deletes a single element from the current split text array. After removal, the array shrinks by one, and all subsequent elements shift down to fill the gap.

Syntax

$removeSplitTextElement[index]

Parameters

• index (integer, required) — The zero-based position of the element to remove. Negative indices are supported.

Behavior

• Action-only: This function modifies the split text array directly and does not return a value.
• Elements after the removed one shift left by one position.
• The total length decreases by 1.
• Removing an out-of-bounds index has no effect.

Usage

Before and After

$textSplit[A;B;C;D;E;]
$removeSplitTextElement[2]   // Remove "C"

Before: [A, B, C, D, E]  (length: 5)
After:  [A, B, D, E]     (length: 4)

Now $splitText[2] returns "D" instead of "C".

With Negative Index

$textSplit[one;two;three;four;]
$removeSplitTextElement[-1]   // Remove "four"
$joinSplitText[ ]  → "one two three"

Common Patterns

Remove Known Value

$textSplit[$getUserVar[tags];,]
$removeSplitTextElement[0]   // Remove first tag
$var[updatedTags;$joinSplitText[,]]

Clean Up Before Rejoining

$textSplit[$message; ]
$removeSplitTextElement[0]      // Remove command prefix
$removeSplitTextElement[0]      // Remove another prefix
$var[args;$joinSplitText[ ]]

Filter First/Last

$textSplit[$message; ]
$removeSplitTextElement[-1]     // Drop last word
$sendMessage[$joinSplitText[ ]]

Important Notes

• Index shift: After removal, all higher indices shift down. If you need to remove multiple elements, work from highest index to lowest to avoid index corruption.
• Out-of-bounds: Removing an invalid index silently does nothing.
• No return: Do not use inline; it’s an action function.
• Permanent for this execution: The removal cannot be undone within the same command, but the original text is not permanently lost — it can be re-split from the source.