RangeMax - script and chart function

RangeMax() returns the highest numeric value found within the expression or field.

Syntax:

RangeMax(first_expr[, Expression])

Return data type: numeric

Arguments:

Argument	Description
first_expr	The expression or field containing the data to be measured.
Expression	Optional expressions or fields containing the range of data to be measured.Multiple additional expressions can be used.

Limitations:

If no numeric value is found, NULL is returned.

Examples and results:

Examples

Results

RangeMax (1,2,4)

Returns 4

RangeMax (1,'xyz')

Returns 1

RangeMax (null( ), 'abc')

Returns NULL

Add the example script to your document and run it. Then add, at least, the fields listed in the results column to a sheet in your document to see the result.

RangeTab3:

LOAD recno() as RangeID, RangeMax(Field1,Field2,Field3) as MyRangeMax INLINE [

Field1, Field2, Field3

10,5,6

2,3,7

8,2,8

18,11,9

5,5,9

9,4,2

];

The resulting table shows the returned values of MyRangeMax for each of the records in the table.

RangeID	MyRangeMax
1	10
2	7
3	8
4	18
5	9
6	9

Example with expression:

RangeMax (Above(MyField,0,3))

Returns the maximum value in the range of three values of MyField calculated on the current row and two rows above the current row. By specifying the third argument as 3, the Above() function returns three values, where there are sufficient rows above, which are taken as input to the RangeMax() function.

Data used in examples:

Disable sorting of MyField to ensure that example works as expected.

MyField	RangeMax (Above(Sum(MyField),1,3))
10	10
2	10
8	10
18	18
5	18
9	18

Data used in examples:

RangeTab:

LOAD * INLINE [

MyField

] ;

RangeMax - script and chart function

See also: