Multi Item Field List Enumerator

This statement is used to create a list of Artwork, Comments, General Encapsulated Object, Lyrics, Unique File Identifier, User Defined Text Information, User Defined URL or Unhandled items. The list can be used as an enumerator to the Repeat With statement such that every item in the specified field can be processed.

You can save the enumerator list to a track or named variable or an array in a container.

For historic reasons, when saving to a named variable, a newline character ( \n) is used as the delimiter.

In Artwork enumerators each list item is an index suitable to be used in an Indexed Artwork statement. For the other field types each list item is a either description field or an index suitable to be used for matching in a User Defined Fields statement.

General Encapsulated Objects are returned as a list of four fields delimited by the Default List Delimiter (\~). The four fields are the description, mime type and filename components followed by the length in bytes of the data.

When an action is running grouped , this statement will always provide an enumeration for every existing item

When an action is running stepwise, the statement operates as follows:

• For Artwork items, only those items starting from the first which are identical across all files will be included in the list. The first item which is not identical across all files effectively terminates the list.
• For non Artwork items, when Enumerate indexes is not set, every item which exists in any selected file will be included in the list.
• For non Artwork items, when Enumerate indexes is set, the maximum number of items which exist in any file will be enumerated.

Note that when enumerating types other than Artwork and you are running stepwise, an index list is more than likely meaningless.

The only advantage to saving to a container is that it can correctly represent a list of one item where the name of the item is empty. In a text string there is no way to differentiate between no items and a single item with an empty name.