Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Array » Array Statistics » GetNthElement_OrNil

GetNthElement_OrNil


Module: FoundationLite

Returns the array element corresponding to the n-th biggest/smallest value from the inValues array; returns NIL if the arrays are empty.

Name Type Range Description
inArray <T>Array Elements from which element corresponding to n-th value will be chosen
inValues RealArray Values defining the order
inN Integer 0 -
inSortingOrder SortingOrder
outElement <T>? Element from the array
outValue Real? Nth biggest/smallest value
outIndex Integer? Index of the found value

The type of this filter is defined using the type variable T which represents any valid type. Read more.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type Description
DomainError Inconsistent array sizes in GetNthElement_OrNil.
DomainError inN is negative in GetNthElement_OrNil.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of GetNthElement filter group.