Hooked on LINQ

Hooked on LINQ - Developers' Wiki
for .NET Language Integrated Query

Quick Search

Advanced Search »

Last Operator

Modified: 2007/01/17 05:28 by t_magennis - Categorized as: LINQ to Objects
{TOC}
Namespace:System.Linq
Assembly:System.Core.dll
Extends:IEnumerable<T>

Back to Standard Query Operator Index


Edit

Introduction

The Last operator returns the last element of a sequence.

Edit

Method Signatures

// 1 - Return the last element in a sequence.
public static TSource Last<TSource>(
    this IEnumerable<TSource> source)
 
// 2 - Return the last element in a sequence that matches this predicate.
public static TSource Last<TSource>(
    this IEnumerable<TSource> source, 
    Func<TSource, bool> predicate)



Edit

Exceptions

Throws an ArgumentNullException if source or predicate is null.
Throws an InvalidOperationException if source is empty, or there is no matching element found for the predicate.


Edit

Pseudo-code

Overload 1
If source is null, throw an ArgumentNullException.
If the source sequence implements IList<T>, then
If the source sequence is empty throw InvalidOperationException.
Return source[count - 1]. (performance optomization)
Else Iterate the source sequence.
If there is no elements at all, throw InvalidOperationException.
If this is the last element, return it as the result.

Overload 2
If source is null, throw an ArgumentNullException.
If predicate is null, throw an ArgumentNullException.
Iterate the source sequence.
If predicate(current element) returns true, remember current element.
If no matching element was found.
Throw an InvalidOperationException.
Else
Return the last element that passed the predicate function.

Edit

Loop Count

Overload 1
< 1 If the collection is of type IList, then the first element is accessed by index position which is different depending on the collection implementation; Otherwise, Loop count = 1 as the entire sequence is iterated to find the last element.


Overload 2
1. The entire source sequence is iterated, and the last matching element is returned.


Edit

Code Samples

TODO: Needs code sample.

If you would like to comment on this page, click on the Discuss button located on the top-right of each page. Feel free to edit any mistakes or ommissions you find. If you have an objection or find in-appropriate content then contact the administrator. This website is not affiliated with Microsoft®, all content and opinions are those of the specific author and some advice, solutions and article may contain un-intentional errors - please use care. Powered by ScrewTurn Wiki version 2.0.33. Some of the icons created by FamFamFam.