Test and Comparison Functions
The functions in this section return a Boolean value of either 1 (true) or 0 (false). They are generally used to drive an action specified in one of the Conditional Functions.
- Compares two numbers.
|Description|| Compare(value1, operator, value2)
The Compare() function compares two numeric values value1 and value2 using the specified operator.
Available operator values:
Outputs 1 if the comparison is true, and 0 otherwise.
|Examples|| compare([bitrate], <, 320)
if(compare(math(now() - [date modified, 0]), >, 21), Expired, formatdate([date modified, 0], elapsed))
- Compares two values in one of seventeen specified modes.
|Description|| IsEqual(value1, value2, mode)
The IsEqual() function compares value1 with value2 using any mode from the list of modes below. Outputs 1 when the comparison succeeds according to the mode, and 0 otherwise. Although the mode is specified as the last argument, the comparison should be mentally read as: value1 mode value2.
Available mode values:
|Examples|| isequal([artist], [album], 1)
if(isequal([artist], [album], 1), Eponymous, [album])
if(isequal([artist], [album], 1), Eponymous/,, [album]/))
if(isequal([filename (path)], classical, 8), Classical, Not Classical)
- Tests a value for emptiness.
|Description|| IsEmpty(value, mode)
The IsEmpty() function tests the given value for emptiness. The value passed is typically an Media Center field, so that some action may be taken when the field is or is not empty. Returns 1 when the value is empty, otherwise 0.
Available mode values:
Note that Media Center does not discriminate between a 0 value and an empty value for fields of type Integer and Decimal - both 0 and empty are considered equivalent for these field types. This is useful for fields such as the integer field Disc #, where an empty or 0 value implies that Disc # contains no useful data, and should be generally ignored or absent in display output.
Pay particular attention to the third example offered below, as it covers a caveat that comes with this particular function.
|Examples|| isempty([comment], 0)
isempty([track #], 1)
ifelse(!isempty([disc #]), [disc #])
- Tests a value for inclusion within a given range.
|Description|| IsRange(value, range)
The IsRange() function tests if a value falls within a given range of values. If the value falls within the given range, 1 is returned, otherwise 0 is returned.
A range is specified in the form of low-high, where low and high are either letters or numbers. The lowest value comes first, the highest second. Both low and high must be the same kind (letters or numbers). The low and high values are inclusive.
Some Example Ranges:
|Examples|| isrange([artist], a-c)
if(isrange([bitrate], 96-191), Poor Quality, High Quality)
- Tests to see if a file exists on the system.
The IsMissing() function tests for the existence of a file in the file system. If the file is missing, the function returns 1, otherwise 0 is returned if the file exists. This function is useful for checking for missing files in a Library. IsMissing() treats special entries such as ripped Blu-ray or DVDs as single files, even though they physically exist in the file system as several files and directories.
Note: Any view or list that uses IsMissing() will be slow, is Media Center must interrogate each referenced file in the file system. The larger the number of files being queried, the longer it will take to produce results. Use IsMissing() with care.
ismissing(C:\Music\My Lost File.mp3)
if(ismissing(), File is missing, File exists)
- Tests to see if a file is stored on removable media.
The IsRemovable() function tests if a file resides on removable media and if so, returns 1, and if not, returns 0. The Media Center field [Removable] also provides the same value for a given file.
- Tests to see if a file is in the Playing Now playlist.
The IsInPlayingNow() function tests if a file is in any zone's Playing Now list. Used as an expression category, pane or file list column allows distinguishing files that are in the Playing Now list.
if(isinplayingnow(), Queued, Not queued)
- Tests to see if a file is in currently being played.
The IsPlaying() function tests if a file is playing in any zone. Used as an expression category, pane or file list column allows distinguishing files that are playing now.
|Examples|| ifelse(isplaying(), <font color="ff0000">♪<//font>, isinplayingnow(), ♪)
- Finds all fields that contain a value
|Description|| SearchTags(value, mode)
Available mode values:
The SearchTags() function tests for a value in any field and returns the list of fields it is in, or a binary for further processing. Note that this function tests the raw value in the field, and not the formatted value, so matches against numerical values such as date fields may give unexpected results.
Also, this function searches every field for all files in the current View or Playlist, so it will not be fast in some uses.
|Examples|| SearchTags(Beatles, 0)