Rust-Standardbibliothek (std 1.99.1) – Leitfaden

Rust-Standardbibliothek (std 1.99.1)

Übersicht

Dieser Skill enthält, was die offizielle std-Dokumentation sagt und was leicht falsch gemacht werden kann: Panics, überraschende Standardwerte, Plattformhinweise, veraltete APIs und die neueren stabilen APIs, die alte Redewendungen ersetzen. Grundlagen, die jeder Rust-Entwickler kennt, werden weggelassen. Jede Behauptung in references/ endet mit der URL der Dokumentation, aus der sie stammt, sodass du die Seite erneut öffnen kannst. https://doc.rust-lang.org/std/index.html

Abgedeckte Version

Rust std 1.99.1, stabiler Kanal. Die Angabe "Since" stammt von den jeweiligen Seiten. Eine hier als nightly markierte API ist auf stabil 1.99.1 nicht nutzbar – schlage sie daher nicht vor. Überprüfe vor der Verwendung einer API, die nach der minimalen Rust-Version des Projekts stabilisiert wurde, ob diese Version verwendet wird.

Navigation

1. Finde den Bereich des Codes, den du schreibst oder überprüfst, in der Tabelle unten.
2. Öffne nur diese Referenzdatei. Jede Datei ist in sich abgeschlossen und enthält oben ein Inhaltsverzeichnis.
3. Wende die dort genannte Standardregel an. Nutze die Ausnahme nur, wenn die angegebene Bedingung zutrifft.
4. Überprüfe bei einer Code-Review auch die Tabelle "Alte Muster" am Ende der Datei und schlage die Ersetzung vor.

Wertvollste Regeln

• Command::output() und status() geben Ok bei einem Exit-Code ungleich null zurück. Überprüfe immer status.success(). https://doc.rust-lang.org/std/process/struct.Command.html
• Path::join oder PathBuf::push mit einem absoluten Pfad ersetzt den gesamten Basispfad. https://doc.rust-lang.org/std/path/struct.PathBuf.html#method.push
• env::set_var ist unsafe und unsicher, sobald Threads laufen (außerhalb von Windows). Konfiguriere Kindprozesse mit Command::env. https://doc.rust-lang.org/std/env/fn.set_var.html
• Rufe flush() auf einem BufWriter vor dem Drop auf, da Drop Fehler beim Spülen ignoriert. https://doc.rust-lang.org/std/io/struct.BufWriter.html
• OpenOptions::write(true) ohne truncate(true) lässt den alten Rest bestehen. Verwende File::create_new für atomare Erstellung. https://doc.rust-lang.org/std/fs/struct.OpenOptions.html#method.write
• Bevorzuge try_exists() gegenüber exists(), das Fehler als false verbirgt. https://doc.rust-lang.org/std/path/struct.Path.html#method.try_exists
• Für unfehlbare einmalige Initialisierung verwende LazyLock (1.80). Eine panicende LazyLock-Initialisierung vergiftet sie für immer. Fehlbare Initialisierung nutzt OnceLock (1.70): zuerst laden, den Fehler außerhalb behandeln, dann get_or_init oder set, niemals LazyLock<Result<..>>. https://doc.rust-lang.org/std/sync/struct.LazyLock.html#poisoning https://doc.rust-lang.org/std/sync/struct.OnceLock.html#method.get_or_init
• thread::scope (1.63) leiht lokale Variablen in Threads ohne Arc oder 'static. https://doc.rust-lang.org/std/thread/fn.scope.html
• Eine recv()-Schleife endet nur, wenn jeder Sender gedroppt wurde. Droppe den ursprünglichen tx. https://doc.rust-lang.org/std/sync/mpsc/index.html
• Verwende Arc::into_inner, nicht Arc::try_unwrap(..).ok(), wenn der Fehler-Arc verworfen wird. https://doc.rust-lang.org/std/sync/struct.Arc.html
• unwrap_or(f()), ok_or(..) und map_or(..) werten ihr Argument eifrig aus. Verwende die _else-Formen für Funktionsaufrufe. https://doc.rust-lang.org/std/option/enum.Option.html#method.unwrap_or
• Formuliere expect-Nachrichten so, dass sie beschreiben, was "gelten soll". https://doc.rust-lang.org/std/error/index.html#common-message-styles
• flatten() über Result-Elemente unterdrückt Fehler stillschweigend. Sammle stattdessen in Result<Vec<_>, _>. https://doc.rust-lang.org/std/result/index.html#iterating-over-result
• Verwende extract_if (Vec 1.87, HashMap/HashSet 1.88, BTreeMap 1.91), um passende Elemente zu entfernen und zu behalten. Wird der Iterator gedroppt oder vorzeitig abgebrochen, bleiben die nicht besuchten Elemente in der Sammlung und werden nie extrahiert. https://doc.rust-lang.org/std/vec/struct.Vec.html#method.extract_if
• Sortiere Fließkommazahlen mit sort_unstable_by(|a, b| a.total_cmp(b)) oder sort_by, wenn Stabilität wichtig ist. total_cmp ordnet -NaN, -inf, negative Zahlen, -0.0, +0.0, positive Zahlen, +inf, +NaN, sodass NaN je nach Vorzeichen an ein Ende sortiert wird und -0.0 vor +0.0 steht. https://doc.rust-lang.org/std/primitive.f64.html#method.total_cmp
• String-Slicing verwendet Byte-Indizes und panict, wenn die Grenze nicht auf einer Zeichengrenze liegt. Verwende get(..) oder floor_char_boundary (1.91). https://doc.rust-lang.org/std/string/struct.String.html
• CString::new(..).unwrap().as_ptr() in einem Ausdruck erzeugt einen baumelnden Zeiger. Binde das CString zuerst an eine Variable. https://doc.rust-lang.org/std/ffi/struct.CString.html
• Miss Zeit mit Instant. SystemTime::elapsed gibt Result zurück, weil die Uhr zurückgehen kann. https://doc.rust-lang.org/std/time/struct.SystemTime.html
• Implementiere From, niemals Into. Verwende TryFrom anstelle eines verlustbehafteten as. https://doc.rust-lang.org/std/convert/trait.From.html
• Wähle Überlaufverhalten explizit: checked_*, strict_* (1.91), saturating_*, wrapping_*. https://doc.rust-lang.org/std/primitive.i32.html#method.strict_add
• Vermeide transmute. Verwende from_le_bytes, as_bytes, addr(), Casts. https://doc.rust-lang.org/std/mem/fn.transmute.html#alternatives

Referenzen

Datei	Deckt ab
references/collections.md	Vec, Slices, Arrays, VecDeque, BinaryHeap, HashMap/HashSet, Entry-API, BTreeMap, Hash
references/option-result-error.md	unwrap/expect, eifrige vs. faule Kombinatoren, neuere Option/Result-Methoden, Error-Implementierungen, ExitCode, Panics
references/iterators.md	Ketten, Nicht-Terminierung und Überlauf, Peekable, from_fn, successors, Iterator implementieren
references/ownership-smart-pointers.md	Box, Rc, Weak, Cell, RefCell, OnceCell, LazyCell, Cow, mem::take, Pin
references/concurrency.md	Arc, Mutex, RwLock, Poisoning, OnceLock, LazyLock, Condvar, mpsc, Threads, Scope, Atomics
references/strings-formatting.md	String/str-Indizierung, Groß-/Kleinschreibung, Format-Syntax, Display/Debug-Implementierungen, OsString, CString
references/io-fs-path.md	BufReader/BufWriter, OpenOptions, TOCTOU, Read/Write/BufRead, io::Error, Path/PathBuf
references/process-env-net-time.md	Command, Child, Pipes, Windows-Besonderheiten, exit, env, TcpListener/TcpStream, Instant, SystemTime, Duration
references/traits-conversions.md	From/Into/TryFrom, AsRef/Borrow, Clone/Copy/Default, PartialEq/Ord, Drop, Deref, Fn, Any, PhantomData
references/unsafe-ptr-num.md	Pointer-Gültigkeit, Provenance, NonNull, from_raw_parts, MaybeUninit, transmute, Überlauf, Fließkommazahlen, Hinweise

Alle gelesenen Seiten sind in SOURCES.md aufgelistet.