Difference between revisions of "Grouping Functions"

From JRiverWiki
Jump to: navigation, search
(Created page with "{{function type page}} The expression language is largely used to evaluate one file at a time. The grammar implies that something like {{monospace|Field(Artist)}} should...")
 
(NAME(…))
Line 5: Line 5:
 
Grouping Functions may only be used in relevant areas (most notably Categories and the [[Tag Action Window]]) where Media Center displays groups of files, and not to individual file listings (such as an expression column in a File Details View).
 
Grouping Functions may only be used in relevant areas (most notably Categories and the [[Tag Action Window]]) where Media Center displays groups of files, and not to individual file listings (such as an expression column in a File Details View).
  
=== <span id="NAME">NAME(&hellip;)</span> ===
+
=== <span id="GroupCount">GroupCount(&hellip;)</span> ===
: SUMMARY
+
: Counts the members of a specified group (in a category or field).
  
 
{{function description box
 
{{function description box
| name=NAME
+
| name=GroupCount
| arguments=ARGUMENTS
+
| arguments=field
 
| description=
 
| description=
DESCRIPTION
+
GroupCount() can be used to count the members of a group of files.
 +
 
 +
{{argument optional|field|current grouping}}
 
| examples=
 
| examples=
'''{{monospace|EXAMPLE1}}'''
+
'''Example Threads:'''
: EXAMPLETEXT
+
: [http://yabb.jriver.com/interact/index.php?topic=81766.msg564453#msg564453 Matt introduces Grouping Functions]
'''{{monospace|EXAMPLE2}}'''
+
: [http://yabb.jriver.com/interact/index.php?topic=94848.msg663421#msg663421 Use field names, not field values (square bracket notation)]
: EXAMPLETEXT
 
'''{{monospace|EXAMPLE3}}'''
 
: EXAMPLETEXT
 
'''{{monospace|EXAMPLE4}}'''
 
: EXAMPLETEXT
 
 
}}
 
}}
  
<pre>
+
=== <span id="GroupCount">GroupCount(&hellip;)</span> ===
To insert a table of arguments in the DESCRIPTION, use:
+
: Counts the members of a specified group (in a category or field).
{{subst:argument table preset}}
+
 
</pre>
+
{{function description box
 +
| name=GroupSummary
 +
| arguments=field
 +
| description=
 +
Smartly summarizes the members of a specified group (mode, mean, min, max, etc as is most logical for that grouping).
 +
 
 +
{{argument optional|field|current grouping}}
 +
| examples=
 +
'''Example Threads:'''
 +
: [http://yabb.jriver.com/interact/index.php?topic=81766.msg564453#msg564453 Matt introduces Grouping Functions]
 +
: [http://yabb.jriver.com/interact/index.php?topic=94848.msg663421#msg663421 Use field names, not field values (square bracket notation)]
 +
}}

Revision as of 00:37, 26 January 2016

The expression language is largely used to evaluate one file at a time. The grammar implies that something like Field(Artist) should get the Artist value for the current file being evaluated. Grouping Functions are a special class of functions that operate on a group of files, instead of on individual files. A simple example would be a function to count the number of artists in the current group.

Grouping Functions may only be used in relevant areas (most notably Categories and the Tag Action Window) where Media Center displays groups of files, and not to individual file listings (such as an expression column in a File Details View).

GroupCount(…)

Counts the members of a specified group (in a category or field).
Description GroupCount(field)

GroupCount() can be used to count the members of a group of files.

  • Argument field is optional (defaults to current grouping).
Examples Example Threads:
Matt introduces Grouping Functions
Use field names, not field values (square bracket notation)

GroupCount(…)

Counts the members of a specified group (in a category or field).
Description GroupSummary(field)

Smartly summarizes the members of a specified group (mode, mean, min, max, etc as is most logical for that grouping).

  • Argument field is optional (defaults to current grouping).
Examples Example Threads:
Matt introduces Grouping Functions
Use field names, not field values (square bracket notation)