Skip to main content

String

This node stores and manages a text string.

The String node holds a text value that can be updated, read, and monitored for changes.

The String node is a variable container for text data. It stores a string value and provides mechanisms to update it either immediately or upon a signal trigger. It also provides the length of the string as a convenient output.

Inputs​

General​

DataDescription
ValueThe text string to store. Default: "" (empty string).

Actions​

SignalDescription
SetTriggers the update of the stored value. If connected, the Value input is buffered until this signal is received.

Outputs​

Data​

DataDescription
ValueThe currently stored string value.
LengthThe number of characters in the stored string.

Signals​

SignalDescription
ChangedTriggered whenever the stored value changes (i.e., new value is different from old value).
StoredTriggered when the Set action is completed, regardless of whether the value changed.

Usage​

Use the String node to store text states, user inputs, or configuration values.

Modes of Operation​

  1. Direct Update (Default):
    • Leave the Set input disconnected.
    • Any change to the Value input immediately updates the stored value and triggers the Changed signal.
  2. Explicit Update (Buffered):
    • Connect a signal to the Set input.
    • Changes to the Value input are "buffered" internally.
    • The stored value only updates (and outputs change) when the Set signal is triggered.

Example Use Cases​

  1. User Name: Store a user's name and display it in multiple places.
  2. Input Buffering: Connect a Text Input field to Value and a "Submit" button to Set. The String node will only update when the button is clicked.
  3. Character Count: Use the Length output to validate input size (e.g., "Password must be at least 8 characters").

Detailed Behavior​

  • Type Casting: Any input provided to Value is automatically converted to a string (e.g., 123 becomes "123").
  • Change Detection: The Changed signal only fires if the new value is strictly different from the current value.
  • Stored Signal: The Stored signal fires every time Set is triggered, even if the value remains the same.

Troubleshooting​

  • Value Not Updating: If you have connected a wire to the Set input, the node enters "Explicit Update" mode. You must trigger the Set signal for the value to update.