List

Table of contents


Description

Lists are an ordered collection of strings. They allow you to receive data from a text document, save data to a file, or work with a set of lines in memory without being bound to a file. Detailed work with a list is described in the article Operations on a list .

List creation

You can create a new list from the context menu Add Action → Lists → List:

Or through the Static Blocks Panel (click on the “+” icon or right-click in the area)

Or use smart search .

The created list will be displayed on the static blocks panel:

When you open the list, the list settings will appear in the static blocks panel, as well as a preview of the list contents. If the list is attached to a file, then the contents of this file will be displayed. If there is no link to the file, then the list can be set to default values.

List settings

The main

Load from file

Take data for the list from a text file in .txt format;

If you DO NOT load the list from a file, then each thread will have its own, independent copy of the list.

Save list changes to a file

The result of working with the list will be automatically saved to an attached text file;

If you load data from a file, but did not enable the Save list changes to a file setting, then for each thread its own local copy of the list will be created based on the specified file. Changes to the list within threads will not affect the linked file in any way.

If the Save list changes to a file setting is enabled, then all threads will work with one copy of the list and all changes will be saved to the linked file.

Leave empty file

If all the data in the list runs out, should you leave an empty file or delete it.

Separator

Specifies what should be used to separate the lines of the list. As a separator, you can use “Enter“, any of custom text or custom regex.

File path

If you have selected to load the list from a file, you must specify the path to the text document in the .txt format. The data from it is loaded into the list at the start of the project.

If the path to the file is not known in advance and will be calculated only during the execution of the project, then you can use the list action and its Merge list function.

View the content

Allows you to view the entire contents of the entire list. In this section, you can enable the display of control characters, set a filter to find the desired string, and also use the filter constructor.

Detailed work with a list is described in the article Operations on a list .