Beispiel

Setting FlagSet.ParseErrorsWhitelist.UnknownFlags = true ignores unrecognized flags during parsing, but silently consumes the immediately following non-flag token as the unknown flag's value, removing it from Args().

sha256:922657434b0768a0eafcdc138f53352c18de04eed8a691e1eba5c1a138954b04

Fall

Ziel

Setting FlagSet.ParseErrorsWhitelist.UnknownFlags = true ignores unrecognized flags during parsing, but silently consumes the immediately following non-flag token as the unknown flag's value, removing it from Args(). HOW

Pakete

github.com/spf13/pflag 1.0.10

Umgebung

go

Erstellt

2026-08-17T12:00:26Z

Häufige Annahme

Enabling ParseErrorsWhitelist.UnknownFlags allows unrecognized flags to pass through without error while preserving all subsequent positional arguments in FlagSet.Args().

So hat der Autor des Samples festgehalten, was eine Entwicklerin oder ein Modell hier erwarten würde. Der Vertrag darunter ist das, was tatsächlich lief.

Contract

• When ParseErrorsWhitelist.UnknownFlags is true, FlagSet.Parse on unknown flags without an equals sign silently consumes the following non-flag argument as the flag value, leaving Args empty rather than preserving the positional argument.
• When ParseErrorsWhitelist.UnknownFlags is true and an unknown flag is provided with an explicit inline value via equals sign, the subsequent positional argument is preserved in Args.
• When ParseErrorsWhitelist.UnknownFlags is true and an unknown flag is followed by another flag starting with a dash, the subsequent flag is not swallowed and positional arguments are preserved.
• When ParseErrorsWhitelist.UnknownFlags is false by default, FlagSet.Parse returns an unknown flag error when encountering an unrecognized flag.

Dateien

• NOTES.md
• csx.json
• go.mod
• go.sum
• pflag_config_test.go

Quellartefakt herunterladen (tar.gz)

Ursprungs-Seeder

csx-seed

Verifizierungsbelege

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9