max() : Find Maximum Value
On this page
Summary
Find the maximum (largest) value in a collection of numeric values.
Signature
max(collection)
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
collection |
Array of Numbers | Yes | The collection of numeric values |
Returns
Type: Number
The largest value in the collection. Returns null for empty collections.
Examples
Simple Maximum
Data:
doc.Params["model"] = new {
scores = new[] { 85, 92, 78, 95, 88 }
};
Output:
<p>Highest score: 95</p>
Price Range
Data:
doc.Params["model"] = new {
products = new[] {
new { name = "Widget A", price = 15.50 },
new { name = "Widget B", price = 22.00 },
new { name = "Widget C", price = 8.75 },
new { name = "Widget D", price = 31.25 }
}
};
Output:
<p>Price range: $8.75 - $31.25</p>
Daily Sales Peak
Data:
doc.Params["model"] = new {
dailySales = new[] {
new { day = "Mon", amount = 1250.00 },
new { day = "Tue", amount = 1580.50 },
new { day = "Wed", amount = 1420.00 },
new { day = "Thu", amount = 1890.25 },
new { day = "Fri", amount = 2150.00 }
}
};
Output:
<h3>Sales Analysis</h3>
<p>Peak daily sales: $2150</p>
<p>Average daily sales: $1658.15</p>
<p>Total weekly sales: $8290.75</p>
Class Performance
Data:
doc.Params["model"] = new {
classes = new[] {
new { name = "Math 101", scores = new[] { 85, 90, 92, 88, 95 } },
new { name = "English 101", scores = new[] { 78, 82, 88, 75, 91 } },
new { name = "Science 101", scores = new[] { 95, 93, 97, 92, 89 } }
}
};
Output:
<p>Math 101: Top score 95, Class average 90.0</p>
<p>English 101: Top score 91, Class average 82.8</p>
<p>Science 101: Top score 97, Class average 93.2</p>
Notes
- Returns null for empty or null collections
- All items must be numeric
- Supports both integers and decimals
- For finding maximum of a property across objects, use with
collect():max(collect(items, 'price')) - For finding maximum property value, use
maxOf()as shorthand - Useful for:
- Price ranges
- Performance metrics
- Peak values
- High scores
- Capacity limits