each

Typekeyword
DictionaryLCS
LibraryLiveCode Script
Syntax
each
Summary

Used with the sort container command to specify that the sort key consists of the specified chunk of each line or item. Also used with the for keyword in a repeat control structure to specify that the repeat loop should be executed for each chunk of the specified string or each element of the specified array.

Introduced1.0
Changes

The ability to specify each element of an array in a repeat control structure was introduced in version 1.1. In previous versions, you could use the each keyword to iterate over all chunks in a string, but not over all elements in an array.

OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
sort lines of field "Address" by word 2 of each
repeat for each character thisChar in field "Input"
RelatedKeyword: item, element, for, line, string
Command: sort, sort container
Glossary: sort, loop, chunk expression, iteration, container, chunk, keyword, control structure, array, command, sort key
Control Structure: repeat
Description

Use the each keyword to sort a container by a portion of each item or line, rather than by the whole item or line, or to iterate over each chunk in a string or each element in an array.

In a sort container command, the expression before "of each" must be a chunk expression. The chunk expression describes a portion of each item or line in the container to be sorted.

If a chunk is nonexistent for a particular line or item--for example, if "by char 5 of each" is specified and some lines only have four characters--the chunk is treated as though it were empty.

Tagstext processing