Výčty
Výčty, označované také jako výčty, jsou integrální typy, ve kterých jsou popisky přiřazeny podmnožině hodnot. Místo literálů je můžete použít, aby byl kód čitelnější a udržovatelný.
Syntaxe
type enum-name =
| value1 = integer-literal1
| value2 = integer-literal2
...
Poznámky
Výčet vypadá podobně jako diskriminovaná sjednocení s jednoduchými hodnotami s tím rozdílem, že je možné zadat hodnoty. Hodnoty jsou obvykle celá čísla začínající číslem 0 nebo 1 nebo celá čísla, která představují bitové pozice. Pokud je výčet určen k reprezentaci bitových pozic, měli byste také použít atribut Flags .
Základní typ výčtu je určen z literálu, který se používá, takže například můžete pro typ bez znaménka (uint32) použít literály s příponou, například 1u, 2ua tak dále.
Pokud odkazujete na pojmenované hodnoty, musíte použít název samotného typu výčtu jako kvalifikátor, to znamená , enum-name.value1ne jen value1. Toto chování se liší od diskriminovaných sjednocení. Důvodem je, že výčty mají vždy RequireQualifiedAccess atribut.
Následující kód ukazuje deklaraci a použití výčtu.
// Declaration of an enumeration.
type Color =
| Red = 0
| Green = 1
| Blue = 2
// Use of an enumeration.
let col1: Color = Color.Red
Výčty můžete snadno převést na základní typ pomocí příslušného operátoru, jak je znázorněno v následujícím kódu.
// Conversion to an integral type.
let n = int col1
Výčtové typy mohou mít jeden z následujících podkladových typů: sbyte, byte, int16, uint16, int32, uint32, int64, uint64, a char. Výčtové typy jsou reprezentovány v rozhraní .NET Framework jako typy, které jsou zděděné z System.EnumSystem.ValueType. Jedná se tedy o typy hodnot, které se nacházejí v zásobníku nebo vložené do objektu obsahujícího objektu, a každá hodnota základního typu je platná hodnota výčtu. To je důležité při porovnávání vzorů s hodnotami výčtu, protože musíte zadat vzor, který zachytí nepojmenované hodnoty.
Funkci enum v knihovně jazyka F# lze použít k vygenerování hodnoty výčtu, a to i k jiné hodnotě než jedné z předdefinovaných pojmenovaných hodnot. Funkci použijete enum následujícím způsobem.
let col2 = enum<Color> (3)
Výchozí enum funkce funguje s typem int32. Proto jej nelze použít s typy výčtu, které mají jiné základní typy. Místo toho použijte následující:
type uColor =
| Red = 0u
| Green = 1u
| Blue = 2u
let col3 = Microsoft.FSharp.Core.LanguagePrimitives.EnumOfValue<uint32, uColor>(2u)
Kromě toho jsou případy výčtů vždy generovány jako public. To znamená, že jsou v souladu s jazykem C# a zbytkem platformy .NET.
