contentsconceptssyntaxlibrariessampleserrorsindex
Full text search
operator   item, @    
  Related Syntax   Related Concepts  

Syntax

  stream-type? shelf-name (@ | item) numeric-expression


Purpose

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"
 
----  

Top [CONTENTS] [CONCEPTS] [SYNTAX] [LIBRARIES] [SAMPLES] [ERRORS] [INDEX]

Generated: April 21, 1999 at 2:01:09 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © OmniMark Technologies Corporation, 1988-1999.