This function is used to create either a list of all Tag Sets, a list of all the fields in a specific Tag Set or a full or partial list of the supported fields.
Regardless of the type of list being created, the default field list separator (\~) is used as the delimiter. When returning a list of fields the Variable fields are not returned. Note that returned Custom fields will contain (name of field) if appropriate. The presense of this qualifier has no effect if the field name is used in an indirect load or set. All returned lists are sorted.
A source tag set and the destination named varable may contain any of the escape sequences described in Escape Sequences.
The following options are available:
- Create a list of all tag sets
- A list of all defined Tag Sets will be returned.
- Create a list of all fields in a Tag Set
- A list of the fields enabled in a tag set is returned.
- Create a list of all fields
- A list of all supported fields is returned.
- Create a list of all single value fields
- A list of all fields which can have at most a single value is returned.
- Create a list of all multiple item fields
- A list of all fields which can have more than one item is returned.
- Create a list of all simple text fields
- A list of all fields which can have a single value and all multiple item fields, (except Artwork), which have a default item.
- Create a list of all simple text multiple item fields
- A list of all fields which can have multiple items and have a default item is returned. Note that Artwork which has a default item is not returned as the default item cannot be textually represented.
- Create a list of all non simple text fields
- A list of all fields which can have multiple items and do not have a default item is returned. Note that Artwork which has a default item is returned as the default item cannot be textually represented.
The multiple item fields which have a default item are: Comments, Commercial Information Webpage, Lyrics, Official Artist/Performer Webpage, Rating and Terms of Use.