Back to Aurora Vision Studio website

You are here: Start » Filter Reference » Array » Array Basics » GetArrayElements_OrNil

GetArrayElements_OrNil

Basic

Module: FoundationLite

Extracts up to 8 individual elements from an array or NIL for indices out of range.

Name Type Range Description
Input value inArray <T>Array Input array
Input value inStart Integer 0 - First element index
Input value inCount Integer 1 - 8 Number of elements to extract
Input value inInverse Bool Determines if the indices are counted from beginning or from end of the input array
Output value outValue1 <T>? First output value
Output value outValue2 <T>? Second output value
Output value outValue3 <T>? Third output value
Output value outValue4 <T>? Fourth output value
Output value outValue5 <T>? Fifth output value
Output value outValue6 <T>? Sixth output value
Output value outValue7 <T>? Seventh output value
Output value outValue8 <T>? Eighth output value

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

Examples

Description of usage of this filter can be found in examples and tutorial: Bottle Inspection, Hand-Eye Calibration - On Filters.

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 Invalid inCount value in GetArrayElements_OrNil.
DomainError Negative inStart in GetArrayElements_OrNil.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of GetArrayElements filter group.