Application icon

Get Inclusion in Track List

This statement is used to determine if a file's disc-track settings fall within a specified track list.

The track list field may contain any of the escape sequences described in Escape Sequences but it is only escaped once, regardless as to how may files are active.

The specified track variable in each active file will be set to 1 if it falls in the track list. Otherwise it will be set to 0.

An empty track list field at runtime is treated as all tracks are valid. ie. the track variable will be set to 1 for all tracks.

If no parsing errors occur, the action test state will be set to true. If parsing errors occur, the specified track variable will be set to 0; the action test state will be false and named variable Action Error Text will contain a description of the error.

The Track list field can contain a list of files with track numbers and/or ranges of track numbers to be modified.

5,6,10-13

means tracks of 5, 6 and 10 through 13 are in the list.

You can also explicitly associate tracks with disc numbers.

1:1,3-5,3:4,5

means any files on disc 1 with a track number of 1,3,4,5 and on disc 3 with a track number of 4 or 5. Disc associations persist until the next #: sequence is encountered.

Note that all or no tracks must be specified with a disc number.

3,2:5

is invalid.