Opções interativas do F#
Este artigo descreve as opções de linha de comando suportadas pelo F# Interactive, fsi.exe. O F# Interactive aceita muitas das mesmas opções de linha de comando que o compilador F#, mas também aceita algumas opções adicionais.
Usar F# interativo para scripts
F# interativo, dotnet fsi, pode ser iniciado interativamente, ou pode ser iniciado a partir da linha de comando para executar um script. A sintaxe da linha de comando é
dotnet fsi [options] [ script-file [arguments] ]
A extensão do arquivo para arquivos de script F# é .fsx.
Tabela de opções interativas do F#
A tabela a seguir resume as opções suportadas pelo F# Interactive. Você pode definir essas opções na linha de comando ou por meio do IDE do Visual Studio. Para definir essas opções no IDE do Visual Studio, abra o menu Ferramentas , selecione Opções, expanda o nó Ferramentas F# e selecione F# Interativo.
Onde as listas aparecem nos argumentos de opção interativo do F#, os elementos da lista são separados por ponto-e-vírgula (;).
| Opção | Description |
|---|---|
| -- | Usado para instruir o F# Interactive a tratar os argumentos restantes como argumentos de linha de comando para o programa ou script F#, que você pode acessar em código usando a lista fsi. CommandLineArgs. |
| --verificado[+|-] | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --página de código:<int> | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --consolecolors[+|-] | Emite mensagens de aviso e erro em cores. |
| **--compilertool:<extensionsfolder> | Faça referência a um assembly ou diretório que contenha uma ferramenta de tempo de design (Formulário curto: -t). |
| --otimização cruzada[|+-] | Habilite ou desabilite otimizações entre módulos. |
| --depurar[+|-] --debug:[completo|pdbonly|portátil|incorporado] -g[+|-] -g: [completo|pdbonly|portátil|incorporado] |
O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --define:<string> | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --determinística[+|-] | Produz um assembly determinístico (incluindo GUID da versão do módulo e carimbo de data/hora). |
| --exec | Instrui o F# interativo a sair depois de carregar os arquivos ou executar o arquivo de script fornecido na linha de comando. |
| --caminhos completos | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --GUI[+|-] | Habilita ou desabilita o loop de eventos do Windows Forms. O padrão está habilitado. |
| --Ajuda -? |
Usado para exibir a sintaxe da linha de comando e uma breve descrição de cada opção. |
| --lib:<lista de pastas> -I:<lista de pastas> |
O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --load:<nome do arquivo> | Compila o código-fonte fornecido na inicialização e carrega as construções F# compiladas na sessão. |
| --mlcompatibilidade | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --noframework | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador |
| --nologo | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --nowarn:<lista de avisos> | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --otimizar[+|-] | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --preferreduilang:<lang> | Especifica o nome da cultura do idioma de saída preferido (por exemplo, es-ES, ja-JP). |
| --silencioso | Suprima a saída do F# Interativo para o fluxo stdout . |
| --cotações-depuração | Especifica que informações de depuração extras devem ser emitidas para expressões derivadas de literais de cotação F# e definições refletidas. As informações de depuração são adicionadas aos atributos personalizados de um nó da árvore de expressão F#. Consulte Cotações de código e Expr.CustomAttributes. |
| --linha de leitura[|+-] | Habilite ou desabilite o preenchimento de guias no modo interativo. |
| --reference:<nome do arquivo> -r:<nome do ficheiro> |
O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --chamadas de cauda[|+-] | Habilite ou desabilite o uso da instrução tail IL, que faz com que o quadro de pilha seja reutilizado para funções recursivas de cauda. Por predefinição, esta opção encontra-se ativada. |
| --targetprofile:<string> | Especifica o perfil da estrutura de destino deste assembly. Os valores válidos são mscorlib, netcore, ou netstandard. A predefinição é mscorlib. |
| --use:<nome do arquivo> | Diz ao intérprete para usar o arquivo fornecido na inicialização como entrada inicial. |
| --UTF8output | O mesmo que a opção de compilador fsc.exe. Para obter mais informações, consulte Opções do compilador. |
| --avisar:<nível de aviso> | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --Warnaserror[+|-] | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
| --warnaserror[+|-]:<lista int> | O mesmo que a opção de compilador fsc.exe . Para obter mais informações, consulte Opções do compilador. |
F# Impressão estruturada interativa
O F# Interactive (dotnet fsi) usa uma versão estendida da formatação de texto sem formatação estruturada para relatar valores.
Todos os recursos de formatação de
%Atexto simples são suportados, e alguns são adicionalmente personalizáveis.A impressão é colorida se as cores forem suportadas pelo console de saída.
Um limite é colocado no comprimento das cadeias de caracteres mostradas, a menos que você avalie explicitamente essa cadeia de caracteres.
Um conjunto de configurações definidas pelo usuário está disponível através do
fsiobjeto.
As configurações disponíveis para personalizar a impressão de texto sem formatação para valores relatados são:
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
Personalize com AddPrinter e AddPrintTransformer
Impressão em F# As saídas interativas podem ser personalizadas usando fsi.AddPrinter e fsi.AddPrintTransformer.
A primeira função fornece texto para substituir a impressão de um objeto. A segunda função retorna um objeto substituto para exibir em vez disso. Por exemplo, considere o seguinte código F#:
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" }
Se você executar o exemplo em F# interativo, ele será gerado com base no conjunto de opções de formatação. Neste caso, afeta a formatação de data e hora:
type DateAndLabel =
{ Date: DateTime
Label: string }
val newYearsDay1999 : DateAndLabel = { Date = 1999-01-01T00:00:00
Label = "New Year" }
fsi.AddPrintTransformer pode ser usado para dar um objeto substituto para impressão:
type MyList(values: int list) =
member _.Values = values
fsi.AddPrintTransformer(fun (x:MyList) -> box x.Values)
let x = MyList([1..10])
É gerada a saída:
val x : MyList = [1; 2; 3; 4; 5; 6; 7; 8; 9; 10]
Se a função do transformador passou para fsi.AddPrintTransformer retornos null, então o transformador de impressão é ignorado.
Isso pode ser usado para filtrar qualquer valor de entrada começando com o tipo obj. Por exemplo:
fsi.AddPrintTransformer(fun (x:obj) ->
match x with
| :? string as s when s = "beep" -> box ["quack"; "quack"; "quack"]
| _ -> null)
let y = "beep"
É gerada a saída:
val y : string = ["quack"; "quack"; "quack"]
Tópicos relacionados
| Title | Description |
|---|---|
| Opções do compilador | Descreve as opções de linha de comando disponíveis para o compilador F#, fsc.exe. |
