connectionless_socket_base.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 Chris Leishman
 
#pragma once
 
 
// Internal base class shared by `datagram_socket` and `raw_socket`. Adds the
// per-message send/receive and disconnect operations that connectionless
// sockets share. Stream sockets use the `ip_io_socket_base` API directly.
 
#include "sdkconfig.h"
 
#include <idfxx/net/detail/ip_io_socket_base.hpp>
#include <idfxx/net/endpoint>
#include <idfxx/net/error>
 
#include <cstddef>
#include <span>
 
namespace idfxx::net::detail {
 
class connectionless_socket_base : public ip_io_socket_base {
public:
    using datagram = ::idfxx::net::datagram;
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    [[nodiscard]] std::span<std::byte> recv(std::span<std::byte> buf) { return idfxx::unwrap(try_recv(buf)); }
#endif
 
    [[nodiscard]] result<std::span<std::byte>> try_recv(std::span<std::byte> buf);
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    void disconnect() { idfxx::unwrap(try_disconnect()); }
#endif
 
    result<void> try_disconnect();
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    size_t send_to(std::span<const std::byte> buf, const endpoint& to) { return idfxx::unwrap(try_send_to(buf, to)); }
#endif
 
    [[nodiscard]] result<size_t> try_send_to(std::span<const std::byte> buf, const endpoint& to);
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    [[nodiscard]] datagram recv_from(std::span<std::byte> buf) { return idfxx::unwrap(try_recv_from(buf)); }
#endif
 
    [[nodiscard]] result<datagram> try_recv_from(std::span<std::byte> buf);
 
protected:
    using ip_io_socket_base::ip_io_socket_base;
};
 
} // namespace idfxx::net::detail