tcp_client.h

Go to the documentation of this file.

// Copyright 2026 The Symbian SDK Authors.
// Licensed under the Apache License, Version 2.0.
 
#ifndef SYMBIAN_API_CONNECTIVITY_TCP_CLIENT_H_
#define SYMBIAN_API_CONNECTIVITY_TCP_CLIENT_H_
 
#include <array>
#include <cstddef>
#include <cstdint>
#include <span>
#include <string_view>
 
#include "absl/status/status.h"
#include "absl/status/statusor.h"
#include "absl/time/time.h"
 
namespace symbian::api::connectivity {
 
struct NativeTcpClient;
class TcpListener;
class ActiveTcpListener;
 
class TcpClient {
 public:
  static absl::StatusOr<TcpClient> ConnectIpv4(
      std::array<std::uint8_t, 4> address, std::uint16_t port,
      absl::Time deadline = absl::InfiniteFuture());
 
  static absl::StatusOr<TcpClient> ConnectHost(
      std::string_view hostname, std::uint16_t port,
      absl::Time deadline = absl::InfiniteFuture());
 
  TcpClient(TcpClient&& other) noexcept;
  TcpClient& operator=(TcpClient&& other) noexcept;
  TcpClient(const TcpClient&) = delete;
  TcpClient& operator=(const TcpClient&) = delete;
  ~TcpClient();
 
  void Close();
 
  absl::Status SetNoDelay(bool enabled = true);
 
  absl::Status Send(std::span<const std::uint8_t> bytes,
                    absl::Time deadline = absl::InfiniteFuture());
 
  absl::StatusOr<std::size_t> Receive(
      std::span<std::uint8_t> bytes,
      absl::Time deadline = absl::InfiniteFuture());
 
 private:
  friend class TcpListener;
  friend class ActiveTcpListener;
 
  explicit TcpClient(NativeTcpClient* native) : native_(native) {}
 
  NativeTcpClient* native_ = nullptr;
};
 
}  // namespace symbian::api::connectivity
 
#endif  // SYMBIAN_API_CONNECTIVITY_TCP_CLIENT_H_