Back to Adaptive Vision Library website

You are here: Start » Function Reference » Array Statistics » GetNthElement

GetNthElement


This is Filter Equivalent. This function may be present in generated code, but should not be used in hand-written code.

Returns the array element corresponding to the n-th biggest/smallest value from the inValues array.

Syntax

void avl::GetNthElement
(
	const atl::Array<Type>& inArray,
	const atl::Array<float>& inValues,
	const int inN,
	avl::SortingOrder::Type inSortingOrder,
	Type& outElement,
	float& outValue,
	int& outIndex
)

Parameters

Name Type Range Default Description
inArray const Array<Type>& Elements from which element corresponding to n-th value will be chosen
inValues const Array<float>& Values defining the order
inN const int 0 -
inSortingOrder SortingOrder::Type
outElement Type& Element from the array
outValue float& Nth biggest/smallest value
outIndex int& Index of the found value

Hints

  • You must guarantee that the input arrays have at least N+1 elements.

Errors

Error type Description
DomainError Inconsistent array sizes in GetNthElement.
DomainError Empty input array in GetNthElement.
DomainError inN is negative or exceeds the input arrays size in GetNthElement.

See Also