MAX

** The function MAX returns the largest Number from within a List of Numbers, or from some number of individual Number values.**

This function takes input in two forms: it will accept either a List of Numbers, or an arbitrary number of individual Number values. It will return a single Number: the largest of the Numbers given (either within the list or individually).

Declaration

MAX(list_of_numbers) -> max_of_numbers

MAX(number_1, number_2, ... number_n) -> max_of_numbers

Parameters

list_of_numbers (type: List of Numbers)

A list of Numbers. There is no limit to the number of items that can be in this list.

number_n (type: Number)

The nth individual Number given as input. n can be arbitrarily large; there is no upper limit to the number of Numbers MAX will accept.

Return Values

max_of_numbers (type: Number)

The largest of the given numbers.

Examples

The following example takes the individual Numbers 1, 2, and 3 as input and returns the largest of the three:

MAX(1, 2, 3) -> 3

The following example takes the List of Numbers [1, 2, 3] and returns the largest Number of the three in the List. Note that the output is identical to the example above.

MAX([1, 2, 3]) -> 3

While the MAX function accepts input in the form of either a List of Numbers or some individual Number values, it cannot parse a combination of the two. The following example demonstrates how the MAX function will behave if given both a List and an individual Number – namely, that it returns NULL:

MAX([1, 2], 3) -> NULL