List.FindIndex() Method in C# with Examples

23 Mar, 2022
List<T>.FindIndex Method is used to search for an element that matches the conditions defined by a specified predicate and returns the index of the first occurrence within the List<T>. If an item which matches the conditions is not found then this method will return -1. There are 3 methods in the overload list of this method as follows:
FindIndex(Predicate<T>)MethodFindIndex(Int32,Predicate<T>)MethodFindIndex(Int32, Int32, Predicate<T>) Method
FindIndex(Predicate<T>)Method
FindIndex(Int32,Predicate<T>)Method
FindIndex(Int32, Int32, Predicate<T>) Method
This method is used to search for an element that matches the conditions defined by the specified predicate, and returns the zero-based index of the first occurrence within the entire List<T>.
Syntax: public int FindIndex (Predicate<T> match); Parameter: match: It is the Predicate<T> delegate that defines the conditions of the element to search for.
Return Value: It returns the index of the first occurrence of an element that matches the conditions defined by match, if found. If not found it returns -1. Exception: This method will give ArgumentNullException if match is null. Example: 
csharp
// C# program to demonstrate the use of// List<T>.FindIndex (Predicate <T>) methodusing System;using System.Collections.Generic; class GFG1 : IComparable {     public String gg    {        get;        set;    }     public int CompareTo(Object o)    {        GFG1 e = o as GFG1;        if (e == null)            throw new ArgumentException("Not valid object");         return gg.CompareTo(e.gg);    }} class GFG2 {     String s;     public GFG2(String ss)    {        s = ss;    }     public bool StartsWith(GFG1 e)    {        return e.gg.StartsWith(s, StringComparison.InvariantCultureIgnoreCase);    }} // Driver Classclass GFG3 {     // Main Method    public static void Main()    {        var e = new List<GFG1>();         // List elements        e.AddRange(new GFG1[] {            new GFG1{                gg = "c",            },             new GFG1{                gg = "c++",            },            new GFG1{                gg = "java",            },            new GFG1{                gg = "C#",            },            new GFG1{                gg = "Python",            },            new GFG1{                gg = "Perl",            },        });         e.Sort();        // sorts the list         var es = new GFG2("C");        Console.WriteLine("'C' starts at index "                  + e.FindIndex(es.StartsWith));         es = new GFG2("P");        Console.WriteLine("'P' starts at index " +                      e.FindIndex(es.StartsWith));    }}
'C' starts at index 0
'P' starts at index 4
This method searches for an element which matches the conditions defined by the specified predicate and returns the index of the first occurrence within the range of elements in the List which extends from the specified index to the last element.
Syntax: public int FindIndex (int startIndex, Predicate<T> match); Parameter: startIndex: It is the zero-based starting index of the search. match: It is the Predicate<T> delegate that defines the conditions of the element to search for.
Return Value: This method will return the index of the first occurrence of an element that matches the conditions defined by “match”, if found. If not found it returns -1. Exceptions:
ArgumentNullException: If the match is null.
ArgumentOutOfRangeException: If the startIndex is outside the range of valid indexes for the List<T>.
Example: 
csharp
// C# program to demonstrate the use of// List<T>.FindIndex (Int32, Predicate <T>) methodusing System;using System.Collections.Generic; class GFG1 : IComparable {     public String gg    {        get;        set;    }     public int CompareTo(Object o)    {        GFG1 e = o as GFG1;         return gg.CompareTo(e.gg);    }} class GFG2 {     String s;     public GFG2(String ss)    {        s = ss;    }     public bool StartsWith(GFG1 e)    {        return e.gg.StartsWith(s, StringComparison.InvariantCultureIgnoreCase);    }} // Driver Classclass GFG3 {     // Main Method    public static void Main()    {        var e = new List<GFG1>();         // List elements        e.AddRange(new GFG1[] {            new GFG1{                gg = "c",            },            new GFG1{                gg = "Python",            },            new GFG1{                gg = "Java",            },            new GFG1{                gg = "C#",            },            new GFG1{                gg = "Java",            },            new GFG1{                gg = "Perl",            },        });         // sorts the list        e.Sort();                var es = new GFG2("C");          // Search for c start from index 1        Console.WriteLine("Search for 'C' starts at index "                          + e.FindIndex(1, es.StartsWith));                es = new GFG2("J");         // search for j starts from index 2        Console.WriteLine("Search for 'J' starts at index "                          + e.FindIndex(2, es.StartsWith));             }}
Search for 'C' starts at index 1
Search for 'J' starts at index 2
This method searches for an element which matches the conditions defined by the specified predicate and returns the zero-based index of the first occurrence within the range of elements in the List that starts at the specified index and contains the specified number of elements.
Syntax: public int FindIndex (int startIndex, int count, Predicate<T> match); Parameters: startIndex: It is the zero-based starting index of the search. count: It is the number of elements in the section to search. match: It is the Predicate<T> delegate that defines the conditions of the element to search for.
Return Value: This method will return the index of the first occurrence of an element that matches the conditions defined by “match”, if found. If not found it returns -1. Exceptions:
ArgumentNullException: If the match is null.
ArgumentOutOfRangeException: If the startIndex is outside the range of valid indexes for the List<T> or count is less than 0 or startIndex and count do not specify a valid section in the List<T>.
Example: 
csharp
// C# program to demonstrate the use of// List<T>.FindIndex (Int32, Int32,// Predicate <T>) methodusing System;using System.Collections.Generic; class GFG1 : IComparable {     public String gg    {        get;        set;    }     public int CompareTo(Object o)    {        GFG1 e = o as GFG1;         return gg.CompareTo(e.gg);    }} class GFG2 {     String s;     public GFG2(String ss)    {        s = ss;    }     public bool StartsWith(GFG1 e)    {        return e.gg.StartsWith(s, StringComparison.InvariantCultureIgnoreCase);    }} // Driver Classclass GFG3 {     // Main Method    public static void Main()    {        var e = new List<GFG1>();         // List elements        e.AddRange(new GFG1[] {             new GFG1{                gg = "c",            },            new GFG1{                gg = "Python",            },            new GFG1{                gg = "C++",            },            new GFG1{                gg = "Java",            },            new GFG1{                gg = "C#",            },            new GFG1{                gg = "Perl",            },        });         // sorts the list        e.Sort();                 var es = new GFG2("C");         // search for c start from index 1        // count is 2 here        Console.WriteLine("Search for 'C' starts at index "                       + e.FindIndex(0, 2, es.StartsWith));                 es = new GFG2("J");         // search for j starts from index 2        // count is 4 here        Console.WriteLine("Search for 'J' starts at index "                       + e.FindIndex(2, 4, es.StartsWith));            }}
Search for 'C' starts at index 0
Search for 'J' starts at index 3
Reference:
https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic.list-1.findindex?view=netframework-4.7.2
simmytarika5
CSharp-Generic-List
CSharp-Generic-Namespace
CSharp-method
C#
Technical Scripter
Writing code in comment?
Please use ide.geeksforgeeks.org,
generate link and share the link here.
C# | Multiple inheritance using interfaces
Differences Between .NET Core and .NET Framework
Extension Method in C#
C# | List Class
HashSet in C# with Examples
C# | .NET Framework (Basic Architecture and Component Stack)
Switch Statement in C#
Partial Classes in C#
Lambda Expressions in C#
Hello World in C#