Skip to content

Command-line arguments

Level: 101 · for newcomers

One line: std::env::args() ↗ is an iterator over the words the shell already split for you — and its first item is the path your program was invoked as, not your first argument.

Stub — an outline, not a lesson. There is no runnable example behind this page yet, so nothing on it has been through the check that backs every other claim in this library. The bullets below are the questions the finished page has to answer.

What it has to cover

  • Argument zero: what it contains, why it is there, and .skip(1) as the idiom
  • args() panics on an argument that is not valid Unicode; args_os() ↗ does not — and an OsString is not a String, which is the whole reason paths are their own type
  • What the shell did before your program woke up: globbing, quote removal, variable expansion. prog *.txt never sees a *
  • Reaching for args[1] indexes a Vec and panics when it is missing; .nth(1) gives you an Option, which is where ok_or turns absence into a real error
  • Collecting once into a Vec<String> versus consuming the iterator in place

The trap it exists for

The off-by-one is the famous one and it is caught in a minute. The one that survives to production is args[1] on a program run with no arguments: the message a user gets is index out of bounds, from a program whose entire job was to notice a missing filename. Absence is not a bug here — it is the most ordinary input there is.

If you are coming from another language

  • Python — sys.argv, including the same "element 0 is the program" convention, so the mental model transfers whole. What changes: argv[1] on a missing argument raises an IndexError you can catch, while Rust's equivalent panic is not something you are meant to catch — the compiler is pushing you toward .nth(1) and an Option instead.
  • ABAP — the closest counterpart is a selection screen with PARAMETERS, where "required" is a property you declare and the runtime enforces before your code runs. Here nothing enforces it for you; the type does the enforcing, once you ask for an Option rather than an index.

See also

  • Flags by hand — what to do with the strings once you have them
  • Option vs Result — the ok_or hop from "not supplied" to "here is why I stopped"

Po polsku

std::env::args() to iterator po słowach, które powłoka (shell) już za ciebie podzieliła — a jego pierwszym elementem jest ścieżka, pod którą uruchomiono program, nie pierwszy argument. Konwencja jest dokładnie ta sama co w sys.argv[0] w Pythonie, więc model przenosi się w całości, a idiomem jest .skip(1). Warto przy tym wiedzieć, ile powłoka zrobiła, zanim program się w ogóle obudził: rozwinęła wzorce, zdjęła cudzysłowy, podstawiła zmienne — po prog *.txt program nie zobaczy żadnej gwiazdki, tylko gotową listę nazw. To jest różnica, o której polskie poradniki zwykle milczą, bo opisują albo Linuksa, albo cmd.exe, rzadko jedno i drugie naraz: ani cmd.exe, ani PowerShell nie rozwijają wzorców za program, więc ten sam kod dostanie tam dosłowne *.txt i musi poradzić sobie sam.

Program wykłada się na argumentach na dwa sposoby i oba mają nazwę. Pierwszy to argument, który nie jest poprawnym UTF-8: wtedy args() panikuje, a args_os() nie, bo oddaje OsString — ciąg bajtów w rozumieniu systemu, a nie łańcuch znaków. Dla polskiego czytelnika to nie jest przypadek teoretyczny, bo nazwa pliku zapisana kiedyś w CP1250 albo ISO-8859-2 (Ćwiczenia.txt) jest właśnie takim argumentem — i to jest powód, dla którego ścieżki mają w Ruście własny typ zamiast być zwykłym String. Drugi sposób jest pospolitszy i bardziej wstydliwy: args[1] indeksuje wektor i panikuje komunikatem index out of bounds, gdy argumentu nie podano — w programie, którego całym zadaniem było zauważyć brakującą nazwę pliku. Brak argumentu to nie awaria, tylko najzwyklejsze wejście, więc pytaj przez .nth(1), odbierz Option i zamień go na porządny błąd przez ok_or; w Pythonie argv[1] rzuca IndexError, który wolno złapać, ale paniki w Ruście łapać się nie ma w zwyczaju — typ ma tu wymusić pytanie, zanim padnie odpowiedź.

Szukaj po polsku: argumenty wiersza poleceń · argument zerowy · nazwa pliku a kodowanie · rust std::env::args_os · rust OsString vs String