Skip to main content

List

Please read the Material Usage Rules on this site.

🔗 Original page — Source for this material

Description​

Lists are an ordered set of strings. They allow you to retrieve data from a text document, save data to a file, or work with a set of strings in memory without a file. Detailed work with lists is described in the article ❗→ List operations.

Creating a list​

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

image-20201221-095312

Or via ❗→ Static Block Panel (click the “+” icon or right-click in the area)

image-20201221-095615

Or use the ❗→ smart search.

The newly created list will show up in the static blocks panel:

image-20200809-193933

When you open the list in the static blocks panel, you'll see the list settings as well as a preview of the list's contents. If the list is linked to a file, the contents of that file will be displayed. If there's no file link, you can set default values for the list.

3

List settings​

Main​

image-20200809-194251

Load from file​

Use data for the list from a .txt text file;

Note

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

Save list changes to file​

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

Note

If you load data from a file but don't enable the Save list changes to file setting, each thread will have its own local copy of the list based on the specified file. Any changes to the list within a thread will not affect the linked file. But if the Save list changes to file option is enabled, then all threads will work with one copy of the list, and all changes will be saved to the attached file.

Keep file empty​

If all the data in the list runs out, should an empty file be left or removed.

Separator​

Specifies what should be used to separate the lines in the list. The separator can be “Enter,“ any custom text, or a regular expression.

image-20200809-194850

File path​

image-20200809-194949

If you choose to load the list from a file, you need to specify the path to the .txt text document. The data will be loaded into the list when the project starts.

Note

If the file path is not known in advance and will only be determined while the project is running, you can use the list action and its Bind to file function.

View contents​

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

image-20200809-194510

image-20200809-194619

Detailed work with lists is described in the article ❗→ List operations.