Array.Find<T> Method

Searches for an element that matches the conditions defined by the specified predicate, and returns the first occurrence within the entire Array.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public static T Find<T>(
	T[] array,
	Predicate<T> match
)

Type Parameters

T

The type of the elements of the array.

Parameters

array
Type: T []
The one-dimensional, zero-based Array to search.
match
Type: System.Predicate<T>
The Predicate<T> that defines the conditions of the element to search for.

Return Value

Type: T
The first element that matches the conditions defined by the specified predicate, if found; otherwise, the default value for type T.

ExceptionCondition
ArgumentNullException

array is null.

-or-

match is null.

The Predicate<T> is a delegate to a method that returns true if the object passed to it matches the conditions defined in the delegate. The elements of array are individually passed to the Predicate<T>, moving forward in the Array, starting with the first element and ending with the last element. Processing is stopped when a match is found.

This method is an O(n) operation, where n is the Length of array.

Windows Phone OS

Supported in: 8.1, 8.0

Show:
© 2015 Microsoft