ComfyUI Node: Yieldable Iterator String

Yieldable Iterator String:

The YieldableIteratorString node is designed to sequentially yield elements from a given list of strings, which are separated by a specified delimiter. This node is particularly useful when you need to iterate over a list of items in a controlled manner, allowing you to reset the iteration to start from the beginning if needed. It provides a straightforward way to manage and access elements in a list one at a time, making it ideal for scenarios where you need to process or display items sequentially. The node's primary function is to split an input string into components based on a separator and then yield each component in sequence, offering a simple yet effective mechanism for handling string lists in a logical and organized manner.

Yieldable Iterator String Input Parameters:

input_string

The input_string parameter is the main input for the node, representing the string that contains multiple elements separated by a specific delimiter. This parameter is crucial as it defines the list of items that the node will iterate over. The default value is a$b$c, which means that by default, the node will consider a, b, and c as separate elements. This parameter does not have a minimum or maximum value, as it is a string, but it should be formatted correctly with the chosen separator to ensure proper functionality.

separator

The separator parameter specifies the character or string used to divide the input_string into individual elements. It plays a vital role in determining how the input string is split into components. The default separator is $, but you can choose any character or string that suits your needs. This parameter allows flexibility in defining how the input string is parsed, enabling you to work with various formats of string lists.

reset

The reset parameter is a boolean value that controls whether the iteration should start over from the beginning of the list. When set to True, the node resets the index to the start, allowing you to reprocess the list from the first element. The default value is False, meaning the node will continue from where it left off in the previous iteration. This parameter is essential for managing the flow of iteration, especially in cases where you need to revisit the list from the start.

Yieldable Iterator String Output Parameters:

STRING

The output parameter is a STRING, which represents the current element yielded from the list based on the current index. This output is crucial as it provides the specific item from the list that you are currently accessing, allowing you to use or display it as needed. The output value changes with each iteration, reflecting the sequential nature of the node's operation. This parameter is essential for obtaining the individual components of the input string in a controlled and orderly manner.

Yieldable Iterator String Usage Tips:

• Use the reset parameter to restart the iteration from the beginning when you need to process the list multiple times or if you want to ensure that the iteration starts fresh for a new task.
• Choose an appropriate separator that matches the format of your input_string to ensure that the string is split correctly into the desired components.

Yieldable Iterator String Common Errors and Solutions:

IndexError: list index out of range

• Explanation: This error occurs when the node tries to access an index that is beyond the range of the list created from the input_string.
• Solution: Ensure that the input_string is correctly formatted with the specified separator and that the list contains the expected number of elements. If the list is empty or shorter than expected, check the input_string and separator for any discrepancies.

ValueError: empty separator

• Explanation: This error happens when the separator is an empty string, which is not allowed as it would result in an undefined split operation.
• Solution: Provide a valid non-empty separator to ensure that the input_string can be split into meaningful components.