each

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 loop should be executed for each chunk of the specified string or each element of the specified array.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

each

# Examples

sort lines of field "Address" by word 2 of each

repeat for each character thisChar in field "Input"

# 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 iteration 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 sort.

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.

# Tags

text processing,

# See

- **keyword:** 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