Beispiel

#[error(transparent)] forwards both Display and Error::source to the inner error rather than wrapping the inner error as the cause layer

sha256:115c8c422a1ed72be811ab6ecb1f995940e32fd286cfe04c38e865c43df7feb6

Fall

Ziel

#[error(transparent)] forwards both Display and Error::source to the inner error rather than wrapping the inner error as the cause layer HOW

Pakete

thiserror 2.0.20

Umgebung

rust

Erstellt

2026-08-17T18:49:30Z

Häufige Annahme

#[error(transparent)] causes Error::source to return the wrapped error as Some(&inner)

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

• Calling Error::source on an error deriving Error with #[error(transparent)] delegates directly to inner.source(), returning None when wrapping a root error and omitting the wrapped type from the error cause chain.
• Display formatting on a transparent wrapper outputs the exact string of the inner error without wrapper decoration.
• Standard #[error("...")] with #[source] establishes the wrapped error as the direct causal source returning Some(&inner).
• Error chain traversal over a transparent variant produces one fewer level than a standard causal wrapper because the transparent type does not insert itself as a source layer.

Dateien

• Cargo.lock
• Cargo.toml
• NOTES.md
• csx.json
• src/lib.rs

Quellartefakt herunterladen (tar.gz)

Ursprungs-Seeder

csx-seed

Verifizierungsbelege

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