C++ Academy · Aula

Noções básicas de std::expected

Retorne valores ou erros

Noções básicas de std::expected é uma aula grátis de C++ Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de C++ Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de C++ Academy inclui 4 aulas no total.

Valores ou erros

std::expected<T, E> (C++23) contém um valor de sucesso do tipo T ou um erro do tipo E. Ao contrário de um opcional, ele informa por que ocorreu a falha. Inclua <expected>.

Retornando sucesso

Em caso de sucesso, retorne o valor diretamente; ele será armazenado como o tipo "esperado" 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";
}

Retornando um erro

Envolva o erro em std::unexpected(...) para sinalizar a falha e ainda retornar o mesmo 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";
}

Verificando o sucesso

Verifique o resultado em um contexto booleano ou com has_value(). Verdadeiro significa que ele contém o valor; falso significa que contém o erro.

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

Lendo o valor

Use *r ou r.value() para ler o valor de sucesso. value() lança std::bad_expected_access se, de fato, ele contiver um erro.

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

Lendo o erro

Quando o resultado estiver no estado de erro, r.error() fornecerá o objeto de erro.

#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";
}

value_or como valor alternativo

Assim como um opcional, value_or(fallback) retorna o valor de sucesso ou um padrão sem inspecionar o erro.

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

Opcional vs Esperado

std::optional indica "valor ou nada"; std::expected indica "valor ou um erro descrito". Escolha o resultado esperado quando os chamadores precisarem saber o motivo da falha.

Tipos de Erro Ricos

O tipo de erro E pode ser uma enumeração, uma estrutura ou uma mensagem de texto, conforme o que melhor descrever as falhas no seu domínio.

#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";
}

Não são Necessárias Exceções

std::expected permite propagar falhas como valores de retorno comuns, o que é útil quando as exceções estão desabilitadas ou são dispendiosas.

Observação sobre Disponibilidade

std::expected é um recurso do C++23; confirme se o seu compilador e o sinalizador do padrão, por exemplo -std=c++23, oferecem suporte a ele antes de usá-lo.

Verificação Rápida

Verifique sua compreensão de resultados esperados.

Recapitulação

Você aprendeu sobre std::expected:

Armazena um valor (T) ou um erro (E).
Retorna o sucesso diretamente e os erros por meio de std::unexpected.
Permite ler o resultado com */value() e error().
Carrega o motivo da falha, ao contrário de um valor opcional.

Perguntas Frequentes

A aula “Noções básicas de std::expected” é grátis?

Sim — o texto completo de “Noções básicas de std::expected” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de C++ Academy, atualize para CoddyKit PRO. O curso de C++ Academy inclui 4 aulas no total.

O que vou aprender em “Noções básicas de std::expected”?

Retorne valores ou erros Você pratica C++ Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar C++ Academy?

Nenhuma experiência prévia é necessária. C++ Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.

Quanto tempo leva a aula “Noções básicas de std::expected”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de C++ Academy?

Sim. Cada aula de C++ Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para C++ Academy