/src/serenity/AK/Error.h

Source
/*
 * Copyright (c) 2021, Andreas Kling <kling@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <AK/StringView.h>
#include <AK/Try.h>

#if defined(AK_OS_SERENITY) && defined(KERNEL)
#    include <errno_codes.h>
#else
#    include <errno.h>
#    include <string.h>
#endif

namespace AK {

class [[nodiscard]] Error {
public:
    ALWAYS_INLINE constexpr Error(Error&&) = default;
    ALWAYS_INLINE constexpr Error& operator=(Error&&) = default;

    constexpr static Error from_errno(int code)
    {
        VERIFY(code != 0);
        return Error(code);
    }

    // NOTE: For calling this method from within kernel code, we will simply print
    // the error message and return the errno code.
    // For calling this method from userspace programs, we will simply return from
    // the Error::from_string_view method!
    static Error from_string_view_or_print_error_and_return_errno(StringView string_literal, int code);

#ifndef KERNEL
    constexpr static Error from_syscall(StringView syscall_name, int rc)
    {
        return Error(syscall_name, rc);
    }
    constexpr static Error from_string_view(StringView string_literal) { return Error(string_literal); }

    // `Error::from_string_view(ByteString::formatted(...))` is a somewhat common mistake, which leads to a UAF situation.
    // If your string outlives this error and _isn't_ a temporary being passed to this function, explicitly call .view() on it to resolve to the StringView overload.
    template<OneOf<ByteString, DeprecatedFlyString, String, FlyString> T>
    constexpr static Error from_string_view(T) = delete;

#endif

    constexpr static Error copy(Error const& error)
    {
        return Error(error);
    }

#ifndef KERNEL
    // NOTE: Prefer `from_string_literal` when directly typing out an error message:
    //
    //     return Error::from_string_literal("Class: Some failure");
    //
    // If you need to return a static string based on a dynamic condition (like
    // picking an error from an array), then prefer `from_string_view` instead.
    template<size_t N>
    constexpr static Error from_string_literal(char const (&string_literal)[N])
    {
        return from_string_view(StringView { string_literal, N - 1 });
    }

    // Note: Don't call this from C++; it's here for Jakt interop (as the name suggests).
    template<SameAs<StringView> T>
    ALWAYS_INLINE constexpr static Error __jakt_from_string_literal(T string)
    {
        return from_string_view(string);
    }
#endif

    constexpr bool operator==(Error const& other) const
    {
#ifdef KERNEL
        return m_code == other.m_code;
#else
        return m_code == other.m_code && m_string_literal == other.m_string_literal && m_syscall == other.m_syscall;
#endif
    }

    constexpr int code() const { return m_code; }
    constexpr bool is_errno() const
    {
        return m_code != 0;
    }
#ifndef KERNEL
    constexpr bool is_syscall() const
    {
        return m_syscall;
    }
    constexpr StringView string_literal() const
    {
        return m_string_literal;
    }
#endif

protected:
    constexpr Error(int code)
        : m_code(code)
    {
    }

private:
#ifndef KERNEL
    constexpr Error(StringView string_literal)
        : m_string_literal(string_literal)
    {
    }

    constexpr Error(StringView syscall_name, int rc)
        : m_string_literal(syscall_name)
        , m_code(-rc)
        , m_syscall(true)
    {
    }
#endif

    constexpr Error(Error const&) = default;
    constexpr Error& operator=(Error const&) = default;

#ifndef KERNEL
    StringView m_string_literal;
#endif

    int m_code { 0 };

#ifndef KERNEL
    bool m_syscall { false };
#endif
};

template<typename T, typename E>
class [[nodiscard]] ErrorOr {
    template<typename U, typename F>
    friend class ErrorOr;

public:
    using ResultType = T;
    using ErrorType = E;

    ALWAYS_INLINE constexpr ErrorOr()
    requires(IsSame<T, Empty>)
        : m_value {}
        , m_is_error(false)
    {
    }

    ALWAYS_INLINE constexpr ErrorOr(ErrorOr&& other)
    requires(!Detail::IsTriviallyMoveConstructible<T> || !Detail::IsTriviallyMoveConstructible<E>)
        : m_is_error(other.m_is_error)
    {
        if (other.is_error())
            construct_at<E>(&m_error, other.release_error());
        else
            construct_at<T>(&m_value, other.release_value());
    }
    ALWAYS_INLINE constexpr ErrorOr(ErrorOr&& other) = default;

    ALWAYS_INLINE constexpr ErrorOr& operator=(ErrorOr&& other)
    requires(!Detail::IsTriviallyMoveConstructible<T> || !Detail::IsTriviallyMoveConstructible<E>)
    {
        if (this == &other)
            return *this;

        if (m_is_error)
            m_error.~ErrorType();
        else
            m_value.~T();

        if (other.is_error())
            construct_at<E>(&m_error, other.release_error());
        else
            construct_at<T>(&m_value, other.release_value());

        m_is_error = other.m_is_error;
        return *this;
    }
    ALWAYS_INLINE constexpr ErrorOr& operator=(ErrorOr&& other) = default;

    ErrorOr(ErrorOr const&) = delete;
    ErrorOr& operator=(ErrorOr const&) = delete;

    template<typename U>
    ALWAYS_INLINE constexpr ErrorOr(ErrorOr<U, ErrorType>&& value)
    requires(IsConvertible<U, T>)
        : m_is_error(value.is_error())
    {
        if (value.is_error())
            construct_at<E>(&m_error, value.release_error());
        else
            construct_at<T>(&m_value, value.release_value());
    }

    template<typename U>
    ALWAYS_INLINE constexpr ErrorOr(U&& value)
    requires(requires { T(declval<U>()); } && !IsSame<U, ErrorType>)
        : m_value(forward<U>(value))
        , m_is_error(false)
    {
    }
    template<typename U>
    ALWAYS_INLINE constexpr ErrorOr(U&& error)
    requires(requires { ErrorType(declval<RemoveCVReference<U>>()); } && !IsSame<U, T>)
        : m_error(forward<U>(error))
        , m_is_error(true)
    {
    }

#ifdef AK_OS_SERENITY
    ALWAYS_INLINE constexpr ErrorOr(ErrnoCode code)
        : m_error(Error::from_errno(code))
        , m_is_error(true)
    {
    }
#endif

    ALWAYS_INLINE constexpr T& value()
    {
        VERIFY(!is_error());
        return m_value;
    }
    ALWAYS_INLINE constexpr T const& value() const
    {
        VERIFY(!is_error());
        return m_value;
    }

    ALWAYS_INLINE constexpr ErrorType& error()
    {
        VERIFY(is_error());
        return m_error;
    }
    ALWAYS_INLINE constexpr ErrorType const& error() const
    {
        VERIFY(is_error());
        return m_error;
    }

    ALWAYS_INLINE constexpr bool is_error() const { return m_is_error; }

    ALWAYS_INLINE constexpr T&& release_value() { return move(value()); }
    ALWAYS_INLINE constexpr ErrorType&& release_error() { return move(error()); }

    ALWAYS_INLINE constexpr T release_value_but_fixme_should_propagate_errors()
    {
        VERIFY(!is_error());
        return release_value();
    }

    ~ErrorOr()
    requires(!Detail::IsDestructible<T> || !Detail::IsDestructible<ErrorType>)
    = delete;

    ALWAYS_INLINE constexpr ~ErrorOr()
    requires(IsTriviallyDestructible<T> && IsTriviallyDestructible<ErrorType>)
    = default;
    ALWAYS_INLINE constexpr ~ErrorOr()
    {
        if (m_is_error)
            m_error.~ErrorType();
        else
            m_value.~T();
    }

private:
    union {
        T m_value;
        ErrorType m_error;
    };
    bool m_is_error;
};

template<typename ErrorType>
class [[nodiscard]] ErrorOr<void, ErrorType> : public ErrorOr<Empty, ErrorType> {
public:
    using ResultType = void;
    using ErrorOr<Empty, ErrorType>::ErrorOr;
};

}

#if USING_AK_GLOBALLY
using AK::Error;
using AK::ErrorOr;
#endif

Coverage Report

Created: 2026-05-16 07:03