F# Interactive-Optionen

In diesem Artikel werden die von F# Interactive (fsi.exe) unterstützten Befehlszeilenoptionen beschrieben. F# Interactive akzeptiert viele Befehlszeilenoptionen des F#-Compilers, jedoch auch einige zusätzliche Optionen.

Verwenden von F# Interactive für die Skripterstellung

F# Interactive dotnet fsi kann interaktiv oder von der Befehlszeile aus gestartet werden, um ein Skript auszuführen. Die Befehlszeilensyntax lautet wie folgt:

dotnet fsi [options] [ script-file [arguments] ]

Die Dateierweiterung für F#-Skriptdateien lautet .fsx.

Tabelle der F# Interactive-Optionen

In der folgenden Tabelle werden die von F# Interactive unterstützten Optionen zusammengefasst. Sie können diese Optionen an der Befehlszeile oder in der Visual Studio-IDE festlegen. Um diese Optionen in der Visual Studio-IDE festzulegen, öffnen Sie das Menü Extras, wählen Sie Optionen, erweitern Sie anschließend den Knoten F#-Tools, und wählen Sie dann F# Interactive.

Wenn F# Interactive-Optionsargumente Listen enthalten, werden Listenelemente durch Semikolons (;) getrennt.

Strukturierte Ausgabe in F# Interactive

F# Interactive (dotnet fsi) verwendet eine erweiterte Version der strukturierten Nur-Text-Formatierung, um Werte zu melden.

1. Alle Features der %A Nur-Text-Formatierung werden unterstützt und einige sind zusätzlich anpassbar.

2. Der Druck wird koloriert, wenn Farben von der Ausgabekonsole unterstützt werden.

3. Für die Länge der angezeigten Zeichenfolgen wird ein Grenzwert festgelegt, es sei denn, Sie werten diese Zeichenfolge explizit aus.

4. Über das fsi-Objekt stehen eine Reihe von vom Benutzer definierbaren Einstellungen zur Verfügung.

Die verfügbaren Einstellungen zum Anpassen des Nur-Textdrucks für gemeldete Werte sind:

open System.Globalization

fsi.FormatProvider <- CultureInfo("de-DE")  // control the default culture for primitives

fsi.PrintWidth <- 120        // Control the width used for structured printing

fsi.PrintDepth <- 10         // Control the maximum depth of nested printing

fsi.PrintLength <- 10        // Control the length of lists and arrays

fsi.PrintSize <- 100         // Control the maximum overall object count

fsi.ShowProperties <- false  // Control whether properties of .NET objects are shown by default

fsi.ShowIEnumerable <- false // Control whether sequence values are expanded by default

fsi.ShowDeclarationValues <- false // Control whether values are shown for declaration outputs

Anpassen mit AddPrinter und AddPrintTransformer

Das Drucken in F# Interactive-Ausgaben kann mithilfe von fsi.AddPrinter und fsi.AddPrintTransformerangepasst werden. Die erste Funktion gibt Text an, um das Drucken eines Objekts zu ersetzen. Die zweite Funktion gibt ein Ersatzobjekt zurück, das stattdessen angezeigt werden soll. Sehen Sie sich als Beispiel den folgenden F#-Code an:

open System

fsi.AddPrinter<DateTime>(fun dt -> dt.ToString("s"))

type DateAndLabel =
    { Date: DateTime
      Label: string  }

let newYearsDay1999 =
    { Date = DateTime(1999, 1, 1)
      Label = "New Year" }

Wenn Sie das Beispiel in F# Interactive ausführen, wird es basierend auf dem Formatierungsoptionssatz ausgegeben. In diesem Fall wirkt sich dies auf die Formatierung von Datum und Uhrzeit aus:

type DateAndLabel =
  { Date: DateTime
    Label: string }
val newYearsDay1999 : DateAndLabel = { Date = 1999-01-01T00:00:00
                                       Label = "New Year" }

fsi.AddPrintTransformer kann verwendet werden, um ein Ersatzobjekt zum Drucken zu vergeben:

type MyList(values: int list) =
    member _.Values = values

fsi.AddPrintTransformer(fun (x:MyList) -> box x.Values)

let x = MyList([1..10])

Folgendes wird ausgegeben:

val x : MyList = [1; 2; 3; 4; 5; 6; 7; 8; 9; 10]

Wenn die an fsi.AddPrintTransformer übergebene Transformatorfunktion null zurückgibt, wird der Drucktransformator ignoriert. Dies kann verwendet werden, um einen beliebigen Eingabewert zu filtern, indem sie mit dem Typ obj beginnen. Zum Beispiel:

fsi.AddPrintTransformer(fun (x:obj) ->
    match x with
    | :? string as s when s = "beep" -> box ["quack"; "quack"; "quack"]
    | _ -> null)

let y = "beep"

Folgendes wird ausgegeben:

val y : string = ["quack"; "quack"; "quack"]

Verwandte Themen