|
|||||
operator | item, @ | ||||
Related Syntax | Related Concepts |
Syntax
stream-type? shelf-name (@ | item) numeric-expression
Selects an item from a shelf based on its position. Shelf items are numbered consecutively starting at 1. Note that item numbers are not permanently attached to particular items. If an item is inserted into the middle of a shelf, all the items beyond the inserted item go up a position. To ensure you have an unchanging way of referencing an item on a shelf, use key
.
@
can be used as a synonym for item
. The operator can follow a shelf name in most contexts.
The selector must not be greater than the number of items on the shelf. The number of items on a shelf can be determined by using the numeric value number of
.
item
cannot be used in format items in a string. To insert an item from a shelf into a string, either assign the item to a variable and use the variable in the format string, or use the concatenation operator ||
.
Usage example:
process local stream foo size 4 set foo item 2 to "Mary had a little lamb.%n" output foo item 2
Related Syntax key number of |
Related Concepts Attributes: list-valued Operators: the precedence of "base" and "binary" |
---- |