thiserror
Egendefinerte feiltyper
thiserror er en gratis leksjon i Lær Rust-programmering på CoddyKit. Dette er leksjon 2 av 4. Du kan lese valgfritt 3 leksjoner fra denne læringsstien gratis i sin helhet – deretter låser CoddyKit PRO opp alle leksjoner, samt praktisk øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Lær Rust-programmering, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Lær Rust-programmering inneholder totalt 4 leksjoner.
Hvorfor egendefinerte feil?
Biblioteker bør eksponere meningsfulle feiltyper slik at kallere kan reagere på bestemte feil. Hvis du skriver dette for hånd, blir det mye standardkode. thiserror-craten genererer den for deg.
Legge til thiserror
Legg den til som en avhengighet. Det er en derive-makro-crate uten kjøretidskostnad.
[dependencies]
thiserror = "1.0"Definere en feil-enum
Deriver Error på en enum der hver variant representerer en bestemt feil. Attributtet #[error("...")] angir Display-meldingen.
use thiserror::Error;
#[derive(Error, Debug)]
pub enum DataError {
#[error("item not found")]
NotFound,
#[error("invalid input: {0}")]
Invalid(String),
}Interpolere felt
Meldingsstrengen kan referere til navngitte eller posisjonelle felt, slik at feilteksten inneholder kontekst.
use thiserror::Error;
#[derive(Error, Debug)]
pub enum ConfigError {
#[error("missing key: {key}")]
Missing { key: String },
#[error("value {0} out of range")]
OutOfRange(i32),
}Automatisk Display og Error
Derive-implementasjonen implementerer automatisk både Display (fra meldingene dine) og std::error::Error. Du trenger ingen manuelle impl-blokker.
Pakke inn en kildefeil
#[from] genererer en From-impl, slik at operatoren ? kan konvertere en underliggende feil til typen din. #[source] markerer årsaken.
use thiserror::Error;
#[derive(Error, Debug)]
pub enum AppError {
#[error("io failure")]
Io(#[from] std::io::Error),
#[error("parse failure")]
Parse(#[from] std::num::ParseIntError),
}Bruke den med ?
Takket være #[from] konverterer operatoren ? standardfeil automatisk til AppError.
fn read_number(path: &str) -> Result<i32, AppError> {
let text = std::fs::read_to_string(path)?; // io::Error -> AppError
let n: i32 = text.trim().parse()?; // ParseIntError -> AppError
Ok(n)
}Kildekjeden
Når du pakker inn en feil, eksponerer thiserror årsaken gjennom Error::source. Det gjør det mulig å få fullstendige feilkjeder for logging og feilsøking.
Transparent Errors
#[error(transparent)] videresender både Display og kilden til den innpakkede feilen. Dette er nyttig for en pass-through-variant.
use thiserror::Error;
#[derive(Error, Debug)]
pub enum WrapError {
#[error(transparent)]
Other(#[from] std::io::Error),
}Når bør du bruke thiserror?
Bruk thiserror når:
- De skriver et library
- Kallere må kunne matche bestemte feilvarianter
- De ønsker et stabilt, typet feil-API
For applikasjoner der De bare vil sende feil videre, er anyhow ofte enklere.
Matche varianter
Fordi feilen er en ekte enum, kan kallere bruke match på den og reagere forskjellig på hver type feil.
fn handle(err: AppError) {
match err {
AppError::Io(_) => println!("retry the file operation"),
AppError::Parse(_) => println!("ask the user to fix input"),
}
}Hurtigsjekk
Hva genererer attributtet #[from] i en thiserror-enum?
Oppsummering
De har lært om thiserror-craten:
#[derive(Error)]genererer Display- og Error-impl-er#[error("...")]definerer meldinger med feltinterpolering#[from]muliggjør?-konvertering fra kildefeiltransparentvideresender til en innpakket feil- Ideell for typede feil-API-er i biblioteker
Lær deg Rust med en AI-veileder – gratis
Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.
- Kurs
- 39
- Leksjoner
- 144
Ofte stilte spørsmål
Er leksjonen «thiserror» gratis?
Ja – du kan lese valgfritt 3 av leksjonene i læringsstien Lær Rust-programmering, inkludert «thiserror», gratis i sin helhet her på nettet. Deretter låser CoddyKit PRO opp alle leksjoner, samt interaktiv øving med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Kurset i Lær Rust-programmering inneholder totalt 4 leksjoner.
Hva lærer jeg i «thiserror»?
Egendefinerte feiltyper Du øver på Lær Rust-programmering med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.
Trenger jeg erfaring for å begynne med Lær Rust-programmering?
Ingen tidligere erfaring er nødvendig. Lær Rust-programmering på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 2 av 4.
Hvor lang tid tar leksjonen «thiserror»?
De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.
Kan jeg skrive og kjøre kode i denne Lær Rust-programmering-leksjonen?
Ja. Alle Lær Rust-programmering-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.