Функция Seq.take<'T> (F#)

Статья
08/11/2011

Возвращает элементы последовательности вплоть до указанного номера.

Пространство имен/путь к модулю: Microsoft.FSharp.Collections.Seq

Сборка: FSharp.Core (в FSharp.Core.dll)

// Signature:
Seq.take : int -> seq<'T> -> seq<'T>

// Usage:
Seq.take count source

Параметры

count
Тип: int

Число элементов, которые нужно принять.
source
Тип: seq<'T>

Входная последовательность.

Исключения

Исключение	Атрибут Condition
ArgumentException	Создается в случае пустой входной последовательности.
ArgumentNullException	Создается при указании в качестве входной последовательности значения NULL.
InvalidOperationException	Вызывается, если счетчик превышает число элементов в последовательности.

Возвращаемое значение

Результирующая последовательность.

Заметки

Seq.truncate возвращает столько элементов, сколько содержит последовательность, вместо вызова исключения.

В скомпилированных сборках имя этой функции — Take. При обращении к функции из языка, отличного от F#, или посредством отражения следует использовать это имя.

Пример

В следующем примере демонстрируется использование функции Seq.take и ее поведение сравнивается с поведением функции Seq.truncate.

let mySeq = seq { for i in 1 .. 10 -> i*i }
let truncatedSeq = Seq.truncate 5 mySeq
let takenSeq = Seq.take 5 mySeq

let truncatedSeq2 = Seq.truncate 20 mySeq
let takenSeq2 = Seq.take 20 mySeq

let printSeq seq1 = Seq.iter (printf "%A ") seq1; printfn ""

// Up to this point, the sequences are not evaluated.
// The following code causes the sequences to be evaluated.
truncatedSeq |> printSeq
truncatedSeq2 |> printSeq
takenSeq |> printSeq
// The following line produces a run-time error (in printSeq):
takenSeq2 |> printSeq

Платформы

Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows XP с пакетом обновления 3 (SP3), Windows XP x64 с пакетом обновления 2 (SP2), Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2), Windows Server 2003 с пакетом обновления 2 (SP2)

Сведения о версии

Среда выполнения F#

Поддерживается в версиях 2.0, 4.0

Silverlight

Поддерживается в версии 3

См. также

Ссылки

Модуль Collections.Seq (F#)

Пространство имен Microsoft.FSharp.Collections (F#)

Поделиться через