List<T> の指定したインデックスから指定した要素数までの範囲内で、指定した述語によって定義される条件に一致する要素を検索し、最もインデックス番号の小さい要素の 0 から始まるインデックスを返します。
アセンブリ: mscorlib (mscorlib.dll 内)
Public Function FindIndex ( _ startIndex As Integer, _ count As Integer, _ match As Predicate(Of T) _ ) As Integer
public int FindIndex( int startIndex, int count, Predicate<T> match )
public: int FindIndex( int startIndex, int count, Predicate<T>^ match )
member FindIndex : startIndex:int * count:int * match:Predicate<'T> -> int
パラメーター
- startIndex
- 型: System.Int32
検索の開始位置を示す 0 から始まるインデックス。
- count
- 型: System.Int32
検索対象の範囲内にある要素の数。
- match
- 型: System.Predicate<T>
検索する要素の条件を定義する Predicate<T> デリゲート。
| 例外 | 条件 |
|---|---|
| ArgumentNullException |
match は null なので、 |
| ArgumentOutOfRangeException |
startIndex が、List<T> の有効なインデックスの範囲外です。 または count が 0 未満です。 または startIndex および count が List<T> 内の有効な部分を指定していません。 |
count が 0 より大きい場合、検索は List<T> 内で startIndex から開始して順方向に進み、startIndex + count - 1 の位置で終了します。
Predicate<T> は、渡されたオブジェクトがデリゲートで定義された条件と一致した場合にtrue を返すメソッドのデリゲートです。 現在の List<T> の要素は、それぞれ Predicate<T> デリゲートに渡されます。
このメソッドは順次検索を実行します。したがって、このメソッドは、O(n) 操作です。ここで、n は count です。
List<T> クラスのメソッドを検索する方法を次の例に示します。 List<T> クラスの例には、サンプル XML ファイル : 書籍 (LINQ to XML) のデータを使用した、Book クラスの book オブジェクトが含まれています。 この例の FillList メソッドは、LINQ to XML を使用して、XML の値を book オブジェクトのプロパティ値に解析します。
リソースにデータをアップロードするためのメソッドを次の表に示します。
|
方法 |
例 |
|---|---|
|
IDToFind 述語デリゲートを使用して、ID で書籍を検索します。 C# の例では、匿名デリゲートを使用しています。 |
|
|
|
FindComputer 述語デリゲートを使用して、Genre プロパティが "Computer" であるすべての書籍を検索します。 |
|
|
2001 PubBefore2001 述語デリゲートを使用して、発行日が 2001 年より前の、コレクション内の最後の書籍を検索します。 C# の例では、匿名デリゲートを使用しています。 |
|
|
FindComputer 述語デリゲートを使用して、最初のコンピューター書籍のインデックスを検索します。 |
|
FindComputer 述語デリゲートを使用して、最後のコンピューター書籍のインデックスを検索します。 |
|
|
FindIndex(Int32, Int32, Predicate<T>)
|
FindComputer 述語デリゲートを使用して、コレクションの後半で最初のコンピューター書籍のインデックスを検索します。 |
|
FindComputer 述語デリゲートを使用して、コレクションの後半で最後のコンピューター書籍のインデックスを検索します。 |
Imports System.Collections.Generic Imports System.Linq Imports System.Xml.Linq Module Module1 Private IDToFind As String = "bk109" Public Books As New List(Of Book) Sub Main() FillList() ' Find a book by its ID. Dim result As Book = Books.Find(AddressOf FindID) If result IsNot Nothing Then DisplayResult(result, "Find by ID: " & IDToFind) Else Console.WriteLine(vbCrLf & "Not found: " & IDToFind) End If Console.WriteLine() ' Find last book in collection that has a publish date before 2001. result = Books.FindLast(AddressOf PubBefore2001) If result IsNot Nothing Then DisplayResult(result, "Last book in collection published before 2001:") Else Console.WriteLine(vbCrLf & "Not found: " & IDToFind) End If Console.WriteLine() ' Find all computer books. Dim results As List(Of Book) = Books.FindAll(AddressOf FindComputer) If results.Count <> 0 Then DisplayResults(results, "All computer books:") Else Console.WriteLine(vbCrLf & "No books found.") End If Console.WriteLine() ' Find all books under $10.00. results = Books.FindAll(AddressOf FindUnderTen) If results.Count <> 0 Then DisplayResults(results, "Books under $10:") Else Console.WriteLine(vbCrLf & "No books found.") End If Console.WriteLine() ' Find index values. Console.WriteLine() Dim ndx As Integer = Books.FindIndex(AddressOf FindComputer) Console.WriteLine("Index of first computer book: " & ndx) ndx = Books.FindLastIndex(AddressOf FindComputer) Console.WriteLine("Index of last computer book: " & ndx) Dim mid As Integer = Books.Count / 2 ndx = Books.FindIndex(mid, mid, AddressOf FindComputer) Console.WriteLine("Index of first computer book in the second half of the collection: " & ndx) ndx = Books.FindLastIndex(Books.Count - 1, mid, AddressOf FindComputer) Console.WriteLine("Index of last computer book in the second half of the collection: " & ndx) End Sub Private Sub FillList() ' Create XML elements from a source file. Dim xTree As XElement = XElement.Load("c:\temp\books.xml") ' Create an enumerable collection of the elements. Dim elements As IEnumerable(Of XElement) = xTree.Elements ' Evaluate each element and set values in the book object. For Each el As XElement In elements Dim Book As New Book() Book.ID = el.Attribute("id").Value Dim props As IEnumerable(Of XElement) = el.Elements For Each p As XElement In props If p.Name.ToString.ToLower = "author" Then Book.Author = p.Value End If If p.Name.ToString.ToLower = "title" Then Book.Title = p.Value End If If p.Name.ToString.ToLower = "genre" Then Book.Genre = p.Value End If If p.Name.ToString.ToLower = "price" Then Book.Price = Convert.ToDouble(p.Value) End If If p.Name.ToString.ToLower = "publish_date" Then Book.Publish_date = Convert.ToDateTime(p.Value) End If If p.Name.ToString.ToLower = "description" Then Book.Description = p.Value End If Next Books.Add(Book) Next DisplayResults(Books, "All books:") Console.WriteLine() End Sub ' Predicate delegates for ' Find and FindAll methods. Private Function FindID(ByVal bk As Book) As Boolean If bk.ID = IDToFind Then Return True Else Return False End If End Function Private Function FindComputer(ByVal bk As Book) As Boolean If bk.Genre = "Computer" Then Return True Else Return False End If End Function Private Function FindUnderTen(ByVal bk As Book) As Boolean Dim tendollars As Double = 10.0 If bk.Price < tendollars Then Return True Else Return False End If End Function Private Function PubBefore2001(ByVal bk As Book) As Boolean Dim year2001 As DateTime = New DateTime(2001, 1, 1) Return bk.Publish_date < year2001 End Function Private Sub DisplayResult(ByVal result As Book, ByVal title As String) Console.WriteLine() Console.WriteLine(title) Console.WriteLine(vbLf & result.ID & vbTab & result.Author & _ vbTab & result.Title & vbTab & result.Genre & _ vbTab & result.Publish_date & vbTab & result.Price) Console.WriteLine() End Sub Private Sub DisplayResults(ByVal results As List(Of Book), ByVal title As String) Console.WriteLine() Console.WriteLine(title) For Each b As Book In results Console.Write(vbLf & b.ID & vbTab & b.Author & _ vbTab & b.Title & vbTab & b.Genre & _ vbTab & b.Publish_date & vbTab & b.Price) Next Console.WriteLine() End Sub Public Class Book Public ID As String Public Author As String Public Title As String Public Genre As String Public Price As Double Public Publish_date As DateTime Public Description As String End Class End Module
using System; using System.Collections.Generic; using System.Linq; using System.Xml.Linq; namespace Find { class Program { private static string IDtoFind = "bk109"; private static List<Book> Books = new List<Book>(); public static void Main(string[] args) { FillList(); // Find a book by its ID. Book result = Books.Find( delegate(Book bk) { return bk.ID == IDtoFind; } ); if (result != null) { DisplayResult(result, "Find by ID: " + IDtoFind); } else { Console.WriteLine("\nNot found: {0}", IDtoFind); } // Find last book in collection published before 2001. result = Books.FindLast( delegate(Book bk) { DateTime year2001 = new DateTime(2001,01,01); return bk.Publish_date < year2001; }); if (result != null) { DisplayResult(result, "Last book in collection published before 2001:"); } else { Console.WriteLine("\nNot found: {0}", IDtoFind); } // Find all computer books. List<Book> results = Books.FindAll(FindComputer); if (results.Count != 0) { DisplayResults(results, "All computer:"); } else { Console.WriteLine("\nNo books found."); } // Find all books under $10.00. results = Books.FindAll( delegate(Book bk) { return bk.Price < 10.00; } ); if (results.Count != 0) { DisplayResults(results, "Books under $10:"); } else { Console.WriteLine("\nNo books found."); } // Find index values. Console.WriteLine(); int ndx = Books.FindIndex(FindComputer); Console.WriteLine("Index of first computer book: {0}", ndx); ndx = Books.FindLastIndex(FindComputer); Console.WriteLine("Index of last computer book: {0}", ndx); int mid = Books.Count / 2; ndx = Books.FindIndex(mid, mid, FindComputer); Console.WriteLine("Index of first computer book in the second half of the collection: {0}", ndx); ndx = Books.FindLastIndex(Books.Count - 1, mid, FindComputer); Console.WriteLine("Index of last computer book in the second half of the collection: {0}", ndx); } // Populates the list with sample data. private static void FillList() { // Create XML elements from a source file. XElement xTree = XElement.Load(@"c:\temp\books.xml"); // Create an enumerable collection of the elements. IEnumerable<XElement> elements = xTree.Elements(); // Evaluate each element and set set values in the book object. foreach (XElement el in elements) { Book book = new Book(); book.ID = el.Attribute("id").Value; IEnumerable<XElement> props = el.Elements(); foreach (XElement p in props) { if (p.Name.ToString().ToLower() == "author") { book.Author = p.Value; } else if (p.Name.ToString().ToLower() == "title") { book.Title = p.Value; } else if (p.Name.ToString().ToLower() == "genre") { book.Genre = p.Value; } else if (p.Name.ToString().ToLower() == "price") { book.Price = Convert.ToDouble(p.Value); } else if (p.Name.ToString().ToLower() == "publish_date") { book.Publish_date = Convert.ToDateTime(p.Value); } else if (p.Name.ToString().ToLower() == "description") { book.Description = p.Value; } } Books.Add(book); } DisplayResults(Books, "All books:"); } // Explicit predicate delegate. private static bool FindComputer(Book bk) { if (bk.Genre == "Computer") { return true; } { return false; } } private static void DisplayResult(Book result, string title) { Console.WriteLine(); Console.WriteLine(title); Console.WriteLine("\n{0}\t{1}\t{2}\t{3}\t{4}\t{5}", result.ID, result.Author, result.Title, result.Genre, result.Price, result.Publish_date.ToShortDateString()); Console.WriteLine(); } private static void DisplayResults(List<Book> results, string title) { Console.WriteLine(); Console.WriteLine(title); foreach (Book b in results) { Console.Write("\n{0}\t{1}\t{2}\t{3}\t{4}\t{5}", b.ID, b.Author, b.Title, b.Genre, b.Price, b.Publish_date.ToShortDateString()); } Console.WriteLine(); } } public class Book { public string ID { get; set; } public string Author { get; set; } public string Title { get; set; } public string Genre { get; set; } public double Price { get; set; } public DateTime Publish_date { get; set; } public string Description { get; set; } } }
.NET Framework
サポート対象: 4、3.5、3.0、2.0.NET Framework Client Profile
サポート対象: 4、3.5 SP1Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2
.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。