Freigeben über


Collections.List-Modul (F#)

Grundlegende Vorgänge für Listen.

Namespace/Modulpfad: Microsoft.FSharp.Collections

Assembly: FSharp.Core (in FSharp.Core.dll)

module List

Hinweise

Eine Übersicht über Listen in F# finden Sie unter Listen (F#).

Werte

Wert

Beschreibungen

append : 'T list -> 'T list -> 'T list

Gibt eine neue Liste zurück, die die Elemente der ersten Liste enthält, auf die die Elemente der zweiten Liste folgen.

average : 'T list -> ^T

Gibt den Durchschnitt der Elemente in der Liste zurück.

averageBy : ('T -> ^U) -> 'T list -> ^U

Gibt den Durchschnitt der Elemente zurück, die durch Anwenden der Funktion auf die einzelnen Elemente der Liste generiert wurden.

choose : ('T -> 'U option) -> 'T list -> 'U list

Wendet die angegebene Funktion auf jedes Element der Liste an. Gibt die Liste zurück, die aus den Ergebnissen für die einzelnen Elemente besteht, bei denen die Funktion Some zurückgibt.

collect : ('T -> 'U list) -> 'T list -> 'U list

Wendet die angegebene Funktion auf jedes Element der Liste an. Verkettet alle Ergebnisse und gibt die kombinierte Liste zurück.

concat : seq<'T list> -> 'T list

Gibt eine neue Liste zurück, die die Elemente der einzelnen Listen in ihrer Reihenfolge enthält.

empty : 'T list

Gibt eine leere Liste des angegebenen Typs zurück.

exists : ('T -> bool) -> 'T list -> bool

Prüft, ob ein Element der Liste das angegebene Prädikat erfüllt.

exists2 : ('T1 -> 'T2 -> bool) -> 'T1 list -> 'T2 list -> bool

Überprüft, ob ein Paar übereinstimmender Elemente der Listen das angegebene Prädikat erfüllt.

filter : ('T -> bool) -> 'T list -> 'T list

Gibt eine neue Auflistung zurück, die nur die Elemente der Auflistung enthält, für die das angegebene Prädikat true zurückgibt.

find : ('T -> bool) -> 'T list -> 'T

Gibt das erste Element zurück, für das die angegebene Funktion true zurückgibt.

findIndex : ('T -> bool) -> 'T list -> int

Gibt den Index des ersten Elements in der Liste zurück, das das angegebene Prädikat erfüllt.

fold : ('State -> 'T -> 'State) -> 'State -> 'T list -> 'State

Wendet eine Funktion auf jedes Element der Auflistung an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Diese Funktion verwendet das zweite Argument und wendet die angegebene Funktion darauf und auf das erste Element in der Liste an. Anschließend wird dieses Ergebnis zusammen mit dem zweiten Element usw. an die Funktion übergeben. Abschließend wird das Endergebnis zurückgegeben. Ist die Eingabefunktion f und sind die Elemente i0...iN berechnet diese Funktion f (... (f s i0) i1 ...) iN.

fold2 : ('State -> 'T1 -> 'T2 -> 'State) -> 'State -> 'T1 list -> 'T2 list -> 'State

Wendet eine Funktion auf zusammengehörende Elemente in zwei Auflistungen an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Die Auflistungen müssen dieselbe Größe haben. Ist die Eingabefunktion f und sind die Elemente i0...iN und j0...jN, berechnet diese Funktion f (... (f s i0 j0)...) iN jN.

foldBack : ('T -> 'State -> 'State) -> 'T list -> 'State -> 'State

Wendet eine Funktion auf jedes Element der Auflistung an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Ist die Eingabefunktion f und sind die Elemente i0...iN, wird f i0 (...(f iN s)) berechnet.

foldBack2 : ('T1 -> 'T2 -> 'State -> 'State) -> 'T1 list -> 'T2 list -> 'State -> 'State

Wendet eine Funktion auf zusammengehörende Elemente in zwei Auflistungen an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Die Auflistungen müssen dieselbe Größe haben. Ist die Eingabefunktion f und sind die Elemente i0...iN und j0...jN, berechnet diese Funktion f i0 j0 (...(f iN jN s)).

forall : ('T -> bool) -> 'T list -> bool

Prüft, ob alle Elemente der Auflistung das angegebene Prädikat erfüllen.

forall2 : ('T1 -> 'T2 -> bool) -> 'T1 list -> 'T2 list -> bool

Prüft, ob alle zugehörigen Elemente der Auflistung das angegebene Prädikat paarweise erfüllen.

Kopf : 'T list -> 'T

Gibt das erste Element der Liste zurück.

init : int -> (int -> 'T) -> 'T list

Erstellt eine Liste, indem der angegebene Generator für jeden Index aufgerufen wird.

isEmpty : 'T list -> bool

Gibt true zurück, wenn die Liste keine Elemente enthält, andernfalls false.

iter : ('T -> unit) -> 'T list -> unit

Wendet die angegebene Funktion auf jedes Element der Auflistung an.

iter2 : ('T1 -> 'T2 -> unit) -> 'T1 list -> 'T2 list -> unit

Wendet die angegebene Funktion gleichzeitig auf zwei Auflistungen an. Die Auflistungen müssen dieselbe Größe haben.

iteri : (int -> 'T -> unit) -> 'T list -> unit

Wendet die angegebene Funktion auf jedes Element der Auflistung an. Die an die Funktion übergebene Ganzzahl gibt den Index des Elements an.

iteri2 : (int -> 'T1 -> 'T2 -> unit) -> 'T1 list -> 'T2 list -> unit

Wendet die angegebene Funktion gleichzeitig auf zwei Auflistungen an. Die Auflistungen müssen dieselbe Größe haben. Die an die Funktion übergebene Ganzzahl gibt den Index des Elements an.

length : 'T list -> int

Gibt die Länge der Liste zurück.

map : ('T -> 'U) -> 'T list -> 'U list

Wendet die angegebene Funktion auf jedes Element in der Auflistung an und erstellt aus den Ergebnissen eine neue Auflistung.

map2 : ('T1 -> 'T2 -> 'U) -> 'T1 list -> 'T2 list -> 'U list

Wendet die angegebene Funktion paarweise auf die zusammengehörenden Elemente in beiden Auflistungen an und erstellt aus den Ergebnissen eine neue Auflistung.

map3 : ('T1 -> 'T2 -> 'T3 -> 'U) -> 'T1 list -> 'T2 list -> 'T3 list -> 'U list

Wendet die angegebene Funktion gleichzeitig auf die entsprechenden Elemente der drei Auflistungen an und erstellt aus den Ergebnissen eine neue Auflistung.

mapi : (int -> 'T -> 'U) -> 'T list -> 'U list

Wendet die angegebene Funktion auf jedes Element in der Auflistung an und erstellt aus den Ergebnissen eine neue Auflistung. Der ganzzahlige Index, der an die Funktion übergeben wird, gibt den Index (beginnend bei 0) des zu transformierenden Elements an.

mapi2 : (int -> 'T1 -> 'T2 -> 'U) -> 'T1 list -> 'T2 list -> 'U list

Entspricht List.mapi, es werden jedoch entsprechende Elemente aus zwei Listen mit gleicher Länge zugeordnet.

max : 'T list -> 'T

Gibt das Element der Liste zurück, das bei einem Vergleich mit Operators.max am größten ist.

maxBy : ('T -> 'U) -> 'T list -> 'T

Gibt das Element der Liste zurück, das bei einem Vergleich des Funktionsergebnisses mit Operators.max am größten ist.

min : 'T list -> 'T

Gibt das Element der Liste zurück, das bei einem Vergleich mit Operators.min am kleinsten ist.

minBy : ('T -> 'U) -> 'T list -> 'T

Gibt das Element der Liste zurück, das bei einem Vergleich des Funktionsergebnisses mit Operators.min am kleinsten ist.

nth : 'T list -> int -> 'T

Führt die Indizierung in der Liste aus. Das erste Element hat den Index 0.

ofArray : 'T [] -> 'T list

Erstellt eine Liste aus dem angegebenen Array.

ofSeq : seq<'T> -> 'T list

Erstellt eine neue Liste aus dem angegebenen aufzählbaren Objekt.

Partition : ('T -> bool) -> 'T list * 'T list

Teilt die Auflistung in zwei Auflistungen, die die Elemente enthalten, für die das angegebene Prädikat true bzw. false zurückgibt.

permute : (int -> int) -> 'T list -> 'T list

Gibt eine Liste mit allen Elementen zurück, die entsprechend der angegebenen Permutation permutiert wurden.

pick : ('T -> 'U option) -> 'T list -> 'U

Wendet die angegebene Funktion auf aufeinander folgende Elemente an und gibt das erste Ergebnis zurück, bei dem die Funktion für einen Wert Some zurückgibt.

reduce : ('T -> 'T -> 'T) -> 'T list -> 'T

Wendet eine Funktion auf jedes Element der Auflistung an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Diese Funktion wendet die angegebene Funktion auf die ersten zwei Elemente der Liste an. Anschließend wird dieses Ergebnis zusammen mit dem dritten Element usw. an die Funktion übergeben. Abschließend wird das Endergebnis zurückgegeben. Ist die Eingabefunktion f und sind die Elemente i0...iN berechnet diese Funktion f (... (f i0 i1) i2 ...) iN.

reduceBack : ('T -> 'T -> 'T) -> 'T list -> 'T

Wendet eine Funktion auf jedes Element der Auflistung an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Ist die Eingabefunktion f und sind die Elemente i0...iN berechnet diese Funktion f i0 (...(f iN-1 iN)).

replicate : (int -> 'T -> 'T list)

Erstellt eine Liste, indem der angegebene Generator für jeden Index aufgerufen wird.

rev : 'T list -> 'T list

Gibt eine neue Liste mit den Elementen in umgekehrter Reihenfolge zurück.

scan : ('State -> 'T -> 'State) -> 'State -> 'T list -> 'State list

Wendet eine Funktion auf jedes Element der Auflistung an, wobei ein Akkumulatorargument in der Berechnung mitgeführt wird. Diese Funktion verwendet das zweite Argument und wendet die angegebene Funktion darauf und auf das erste Element in der Liste an. Anschließend wird dieses Ergebnis zusammen mit dem zweiten Element usw. an die Funktion übergeben. Abschließend wird die Liste mit Zwischenergebnissen und dem Endergebnis zurückgegeben.

scanBack : ('T -> 'State -> 'State) -> 'T list -> 'State -> 'State list

Wie foldBack, gibt jedoch das Zwischen- und Endergebnis zurück.

sort : 'T list -> 'T list

Sortiert die angegebene Liste mit Operators.compare.

sortBy : ('T -> 'Key) -> 'T list -> 'T list

Sortiert die angegebene Liste mit Schlüsseln, die von der angegebenen Projektion bereitgestellt werden. Schlüssel werden mithilfe von Operators.compare verglichen.

sortWith : ('T -> 'T -> int) -> 'T list -> 'T list

Sortiert die angegebene Liste mit der angegebenen Vergleichsfunktion.

sum : ^T list -> ^T

Gibt die Summe der Elemente in der Liste zurück.

sumBy : ('T -> ^U) -> 'T list -> ^U

Gibt die Summe der Ergebnisse zurück, die durch Anwenden der Funktion auf die einzelnen Elemente der Liste generiert wird.

tail : 'T list -> 'T list

Gibt die Eingabeliste ohne das erste Element zurück.

toArray : 'T list -> 'T []

Erstellt ein Array aus der angegebenen Liste.

toSeq : 'T list -> seq<'T>

Zeigt die angegebene Liste als Sequenz an.

tryFind : ('T -> bool) -> 'T list -> 'T option

Gibt das erste Element zurück, für das die angegebene Funktion true zurückgibt. Wenn kein solches Element vorhanden ist, wird None zurückgegeben.

tryFindIndex : ('T -> bool) -> 'T list -> int option

Gibt den Index des ersten Elements in der Liste zurück, das das angegebene Prädikat erfüllt. Wenn kein solches Element vorhanden ist, wird None zurückgegeben.

tryPick : ('T -> 'U option) -> 'T list -> 'U option

Wendet die angegebene Funktion auf aufeinander folgende Elemente an und gibt das erste Ergebnis zurück, bei dem die Funktion für einen Wert Some zurückgibt. Wenn kein solches Element vorhanden ist, wird None zurückgegeben.

unzip : ('T1 * 'T2) list -> 'T1 list * 'T2 list

Teilt eine Liste von Paaren in zwei Listen.

unzip3 : ('T1 * 'T2 * 'T3) list -> 'T1 list * 'T2 list * 'T3 list

Teilt eine Liste von Tripeln in drei Listen.

zip : 'T1 list -> 'T2 list -> ('T1 * 'T2) list

Kombiniert zwei Listen in einer Liste von Paaren. Die beiden Listen müssen dieselbe Länge aufweisen.

zip3 : 'T1 list -> 'T2 list -> 'T3 list -> ('T1 * 'T2 * 'T3) list

Kombiniert die drei Listen in eine Liste von Tripeln. Die Listen müssen gleichlang sein.

Plattformen

Windows 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2

Versionsinformationen

F#-Runtime

Unterstützt in: 2.0, 4.0

Silverlight

Unterstützt in: 3

Siehe auch

Weitere Ressourcen

Microsoft.FSharp.Collections-Namespace (F#)

Listen (F#)