Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::nullopt — ausencia explícita de un valor

Usa `std::nullopt` para devolver o dejar vacío un `std::optional` sin confundir un resultado ausente con un valor válido como cero.

Versión: ISO C++23; implementation support may vary

Sintaxis

#include <optional>

std::optional<int> no_result() {
    return std::nullopt;
}

void clear(std::optional<int>& result) {
    result = std::nullopt;
}

bool is_empty(const std::optional<int>& result) {
    return result == std::nullopt;
}

std::nullopt es una constante inline constexpr de tipo std::nullopt_t del encabezado <optional>, disponible desde C++17. El constructor que recibe este marcador crea un std::optional<T> vacío sin construir un objeto de tipo T. Usa return std::nullopt; cuando una función devuelve std::optional<T> y no tiene ningún resultado. La constante no indica el motivo de la ausencia.

o == std::nullopt y !o.has_value() comprueban la ausencia de valor. if (o) comprueba la presencia, no el contenido: almacenar 0, false o nullptr sigue contando como tener un valor. Usa *o y o-> solo si hay un valor. En C++23, estos operadores tienen un comportamiento indefinido sobre un objeto vacío, mientras que o.value() lanza std::bad_optional_access. Tanto o = std::nullopt como o.reset() destruyen el valor almacenado, si lo hay; no uses después punteros ni referencias a ese valor.

En la lección 51, std::numeric_limits<int> de <limits> proporciona los límites de int: max() da el mayor valor representable y min() el menor. Para tipos de coma flotante con valores subnormales, min() da el menor valor positivo normalizado; lowest() da el menor valor finito. El ejemplo comprueba el límite que corresponde al signo de b antes de evaluar a + b. El cortocircuito de && mantiene las propias restas dentro del rango. Una suma de tipo int fuera de rango tendría un comportamiento indefinido.

En la lección 48, std::filesystem::perms de <filesystem> es una enumeración de tipo enum class que sirve como máscara de bits de permisos de archivo. Un valor presente std::filesystem::perms::none indica que no hay bits de permisos activos; un std::optional<std::filesystem::perms> vacío indica que no hay resultado. Es solo contexto: el ejemplo no usa este tipo ni comprueba ni hace cumplir permisos.

Ejemplos

#include <iostream>
#include <limits>
#include <optional>

std::optional<int> checked_add(int a, int b) {
    using Limits = std::numeric_limits<int>;
    if ((b > 0 && a > Limits::max() - b) ||
        (b < 0 && a < Limits::min() - b)) {
        return std::nullopt;
    }
    return a + b;
}

int main() {
    const auto print = [](std::optional<int> result) {
        if (result) {
            std::cout << *result << '\n';
        } else {
            std::cout << "no result\n";
        }
    };

    print(checked_add(7, -7));
    print(checked_add(std::numeric_limits<int>::max(), 1));
    print(checked_add(std::numeric_limits<int>::min(), -1));
}

Resultado

0
no result
no result

La primera llamada imprime `0`; las dos siguientes imprimen `no result` cada una porque la suma queda fuera del rango de `int`.

Lecciones relacionadas

  • C++ · Lección 48 · Avanzado · Versión: 3
  • C++ · Lección 51 · Avanzado · Versión: 3

Fuentes