listener.hpp

Go to the documentation of this file.

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 Chris Leishman
 
#pragma once
 
#include "sdkconfig.h"
 
#include <idfxx/net/endpoint>
#include <idfxx/net/error>
#include <idfxx/net/netconn/detail/base_channel.hpp>
#include <idfxx/net/netconn/stream_channel>
 
namespace idfxx::net::netconn {
 
class [[nodiscard]] listener : public detail::base_channel {
public:
    struct accepted_channel {
        stream_channel channel; 
        endpoint peer;          
    };
 
    static constexpr int default_backlog = 5;
 
    // ----- construction (unbound) -----
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    listener();
#endif
 
    [[nodiscard]] static result<listener> make();
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    explicit listener(address_family fam);
#endif
 
    [[nodiscard]] static result<listener> make(address_family fam);
 
    // ----- construction (bind + listen) -----
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    explicit listener(const endpoint& bind_addr, int backlog = default_backlog);
 
    explicit listener(port_number port, int backlog = default_backlog);
#endif
 
    [[nodiscard]] static result<listener> make(const endpoint& bind_addr, int backlog = default_backlog);
 
    [[nodiscard]] static result<listener> make(port_number port, int backlog = default_backlog);
 
    // ----- listen / accept -----
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    void listen(int backlog = default_backlog) { idfxx::unwrap(try_listen(backlog)); }
#endif
 
    [[nodiscard]] result<void> try_listen(int backlog = default_backlog);
 
#ifdef CONFIG_COMPILER_CXX_EXCEPTIONS
    [[nodiscard]] stream_channel accept() { return idfxx::unwrap(try_accept()); }
 
    [[nodiscard]] accepted_channel accept_with_peer() { return idfxx::unwrap(try_accept_with_peer()); }
#endif
 
    [[nodiscard]] result<stream_channel> try_accept();
 
    [[nodiscard]] result<accepted_channel> try_accept_with_peer();
 
private:
    listener(::netconn* conn, address_family fam) noexcept
        : base_channel(conn, fam) {}
};
 
} // namespace idfxx::net::netconn