ILMathfind Method (BaseArrayfcomplex, Int64, Boolean, OutArrayInt64, OutArrayfcomplex)

public static RetArray<long> find(
	BaseArray<fcomplex> A,
	long n = 0,
	bool backwards = false,
	OutArray<long> C = null,
	OutArray<fcomplex> V = null
)

Public Shared Function find ( 
	A As BaseArray(Of fcomplex),
	Optional n As Long = 0,
	Optional backwards As Boolean = false,
	Optional C As OutArray(Of Long) = Nothing,
	Optional V As OutArray(Of fcomplex) = Nothing
) As RetArray(Of Long)

Dim A As BaseArray(Of fcomplex)
Dim n As Long
Dim backwards As Boolean
Dim C As OutArray(Of Long)
Dim V As OutArray(Of fcomplex)
Dim returnValue As RetArray(Of Long)

returnValue = ILMath.find(A, n, backwards, 
	C, V)

Parameters

A

Type: ILNumericsBaseArrayfcomplex
Source array.

n (Optional)

Type: SystemInt64
[Optional] Maximum number of non-zero elements to find. Default: (0) find all non-zero elements.

backwards (Optional)

Type: SystemBoolean
[Optional] Search direction backwards. Default: (false) start at the first element and search to the last element of A.

C (Optional)

Type: ILNumericsOutArrayInt64
[Optional] If non-null on entry: the function returns the row indices and gives column indices in C. Default: (null) the function returns the sequential indices of elements found only.

V (Optional)

Type: ILNumericsOutArrayfcomplex
[Optional] Return the found non-zero element values in V. Default: (null) don't return the values.

Return Value

If C or V are not null on entry they are filled with the requested respective info as column vectors. If C is not null it contains the column indices of non-zero values. If A has more than two dimensions subsequent dimensions are merged into the second dimension and the indices given in C are considered sequential indices of A (column major order).

Note, that the array returned by find(BaseArrayfcomplex, Int64, Boolean, OutArrayInt64, OutArrayfcomplex) corresponds to the indices of the rows of non-zero values if C is not null and to sequential indices of those non-zero values if C is null.

Negative values of n are considered as abs(n).

If backwards is true find(BaseArrayfcomplex, Int64, Boolean, OutArrayInt64, OutArrayfcomplex) starts searching for non-zero values from the last element and proceeds in column major order to the first element or until n non-zero elements were found, whatever comes first.

Find() returns and considers indices as 64 bit Int64. Overloads exist for backwards compatibility which expect indices as Int32 values. Such functions are decorated with the suffix '32' in their names.

[ILNumerics Computing Engine]

Reference