C++ Academy · Lezione

Nozioni di base su std::expected

Restituire valori o errori

Nozioni di base su std::expected è una lezione C++ Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento C++ Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso C++ Academy include 4 lezioni in totale.

Valori o errori

std::expected<T, E> (C++23) contiene un valore riuscito di tipo T oppure un errore di tipo E. A differenza di optional, indica perché si è verificato l'errore. Includa <expected>.

Restituire il successo

In caso di successo si restituisce direttamente il valore, che viene memorizzato come tipo "expected" T.

#include <expected>
#include <iostream>
std::expected<int, std::string> parse(bool ok) {
    if (ok) return 100;
    return std::unexpected("bad input");
}
int main() {
    auto r = parse(true);
    if (r) std::cout << *r << "\n";
}

Restituire un errore

Racchiuda l'errore in std::unexpected(...) per segnalare il fallimento continuando a restituire lo stesso tipo.

#include <expected>
#include <iostream>
#include <string>
std::expected<int, std::string> div(int a, int b) {
    if (b == 0) return std::unexpected("divide by zero");
    return a / b;
}
int main() {
    auto r = div(8, 0);
    if (!r) std::cout << r.error() << "\n";
}

Verificare il successo

Verifichi il risultato in un contesto booleano oppure con has_value(). True indica che contiene il valore, false che contiene l'errore.

#include <expected>
#include <iostream>
int main() {
    std::expected<int, int> r = 5;
    std::cout << r.has_value() << "\n"; // 1
}

Leggere il valore

Utilizzi *r oppure r.value() per leggere il valore restituito in caso di successo. value() genera std::bad_expected_access se contiene effettivamente un errore.

#include <expected>
#include <iostream>
int main() {
    std::expected<int, std::string> r = 7;
    if (r) std::cout << r.value() << "\n";
}

Leggere l'errore

Quando il risultato si trova nello stato di errore, r.error() fornisce l'oggetto errore.

#include <expected>
#include <iostream>
#include <string>
std::expected<int, std::string> f() { return std::unexpected("nope"); }
int main() {
    auto r = f();
    if (!r) std::cout << "error: " << r.error() << "\n";
}

Fallback di value_or

Come per optional, value_or(fallback) restituisce il valore del successo oppure un valore predefinito senza esaminare l'errore.

#include <expected>
#include <iostream>
std::expected<int, std::string> f() { return std::unexpected("x"); }
int main() {
    std::cout << f().value_or(0) << "\n"; // 0
}

Optional e Expected

std::optional indica «un valore o niente», mentre std::expected indica «un valore o un errore descritto». Scelga expected quando i chiamanti devono conoscere il motivo dell'errore.

Tipi di errore descrittivi

Il tipo di errore E può essere un enum, una struct o una stringa di messaggio: scelga ciò che descrive meglio gli errori del proprio dominio.

#include <expected>
#include <iostream>
enum class Err { NotFound, Denied };
std::expected<int, Err> get(bool ok) {
    if (ok) return 1;
    return std::unexpected(Err::Denied);
}
int main() {
    auto r = get(false);
    if (!r) std::cout << (int)r.error() << "\n";
}

Non servono eccezioni

std::expected consente di propagare gli errori come normali valori restituiti, una soluzione utile quando le eccezioni sono disabilitate o hanno un costo elevato.

Nota sulla disponibilità

std::expected è una funzionalità di C++23; prima di utilizzarla, verifichi che il compilatore e il flag dello standard, ad esempio -std=c++23, la supportino.

Verifica rapida

Verifichi la propria comprensione di std::expected.

Riepilogo

Ha imparato a usare std::expected:

Contiene un valore (T) oppure un errore (E).
Restituisce direttamente il successo e gli errori tramite std::unexpected.
Consente di leggere il valore con */value() e l'errore con error().
Trasporta il motivo dell'errore, a differenza di optional.

Domande Frequenti

La lezione «Nozioni di base su std::expected» è gratuita?

Sì — il testo completo di «Nozioni di base su std::expected» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso C++ Academy, passa a CoddyKit PRO. Il corso C++ Academy include 4 lezioni in totale.

Cosa imparerò in «Nozioni di base su std::expected»?

Restituire valori o errori Eserciti C++ Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare C++ Academy?

Non è richiesta alcuna esperienza precedente. C++ Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.

Quanto tempo richiede la lezione «Nozioni di base su std::expected»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione C++ Academy?

Sì. Ogni lezione C++ Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a C++ Academy