ComfyUI Node: get random or loop text

get random or loop text:

The text-util-loop-text node is designed to help you manage and manipulate text by looping through a list of items separated by a specified character. This node allows you to select an item from the list based on a given seed value, which can be used to either randomly or sequentially pick an item. This functionality is particularly useful for tasks that require repetitive text processing or for generating variations of text based on a predefined list. By leveraging the seed value, you can ensure consistent and reproducible results, making it easier to manage and automate text-based workflows.

get random or loop text Input Parameters:

text

This parameter represents the input text that you want to process. The text should contain multiple items separated by a specified character. The default value is an empty string (''), and it does not support multiline input. The text is split into a list of items based on the character specified in the char parameter.

seed

The seed parameter is an integer value used to determine the index of the item to be selected from the list. The seed value ensures that the selection process is consistent and reproducible. The default value is 0, with a minimum value of 0 and a maximum value of 0xffffffffffffffff. If the seed value is 0, the first item in the list is selected. If the seed value exceeds the length of the list, it is wrapped around using the modulo operation.

char

This parameter specifies the character used to split the input text into a list of items. The default value is the pipe character ('|'), and it does not support multiline input. The character should be chosen based on the structure of your input text to ensure proper splitting.

get random or loop text Output Parameters:

text

This output parameter returns the selected item from the list based on the seed value. The item is a string and represents one of the items from the input text that was split using the specified character.

seed

This output parameter returns the seed value used in the selection process. It is an integer and helps in verifying the consistency and reproducibility of the results.

index

This output parameter returns the index of the selected item in the list. The index is a string and provides information about the position of the selected item within the list.

get random or loop text Usage Tips:

• Ensure that the input text is properly formatted with items separated by the specified character to avoid unexpected results.
• Use a consistent seed value to reproduce the same selection from the list, which is useful for debugging and verification purposes.
• Experiment with different characters for the char parameter to find the most suitable one for your input text structure.

get random or loop text Common Errors and Solutions:

"IndexError: list index out of range"

• Explanation: This error occurs when the seed value results in an index that is out of the range of the list of items.
• Solution: Ensure that the seed value is within the valid range by using the modulo operation as implemented in the node. Verify that the input text is correctly split into a list of items.

"TypeError: 'NoneType' object is not iterable"

• Explanation: This error occurs when the input text is None or not properly formatted, resulting in a failure to split the text into a list.
• Solution: Ensure that the input text is a valid string and properly formatted with items separated by the specified character.

"ValueError: invalid literal for int() with base 10"

• Explanation: This error occurs when the seed value is not a valid integer.
• Solution: Ensure that the seed value is a valid integer within the specified range. Verify that the input parameters are correctly set.