82 lines
3.0 KiB
C++
82 lines
3.0 KiB
C++
#pragma once
|
|
|
|
#include "EHS.h"
|
|
#include "Str.h"
|
|
#include "BaseUDP.h"
|
|
|
|
namespace ehs
|
|
{
|
|
/// A wrapper class for the user datagram protocol socket.
|
|
class UDP : public BaseUDP
|
|
{
|
|
private:
|
|
Socket hdl;
|
|
|
|
public:
|
|
/// Frees any native handles.
|
|
~UDP() override;
|
|
|
|
UDP();
|
|
|
|
/// Default members initialization.
|
|
UDP(const AddrType addrType);
|
|
|
|
UDP(UDP&& udp) noexcept;
|
|
|
|
/// Copies some members from the given UDP object.
|
|
/// @param [in] udp The UDP object to copy from.
|
|
UDP(const UDP& udp);
|
|
|
|
UDP& operator=(UDP&& udp) noexcept;
|
|
|
|
/// Copies some members from the given UDP object.
|
|
/// @param [in] udp The UDP object to copy from.
|
|
/// @returns The UDP object that has been assigned to.
|
|
UDP& operator=(const UDP& udp);
|
|
|
|
/// Frees native handles and uninitializes them.
|
|
void Release() override;
|
|
|
|
/// Binds the UDP socket to a local address and port.
|
|
/// @param [in] address The local IPv4 or IPv6 address to bind to. Resolves domain names. The given address can be empty, "127.0.0.1", or "localhost" to automatically find the appropriate device.
|
|
/// @param [in] port The port to bind to.
|
|
/// @note Requires the port given to be forwarded if this is called.
|
|
void Bind(const Str_8& address, const UInt_16 port) override;
|
|
|
|
/// Sends data using a C-style byte array.
|
|
/// @param [in] addr The remote Ipv4 or Ipv6 address to send to. Resolves domain names. The given address can be empty, "127.0.0.1", or "localhost" to automatically find the appropriate device.
|
|
/// @param [in] port The remote port to send to.
|
|
/// @param [in] data The C-style byte array to send.
|
|
/// @param [in] size The size of the C-style byte array.
|
|
/// @note The size of data to be sent cannot exceed "UDP::maxPayloadIpv4" or "UDP::maxPayloadIpv6".
|
|
UInt_64 Send(const Str_8& addr, const UInt_16 port, const Byte* const data, const UInt_64 size) override;
|
|
|
|
/// Receives data using the packet helper class.
|
|
/// @param [out] addr The Ipv4 or Ipv6 address of the sender.
|
|
/// @param [out] port The port of the sender.
|
|
/// @param [out] data The C-style byte array received.
|
|
/// @param [in] size The size of the pre-allocated C-style byte array.
|
|
/// @returns The size of the data received.
|
|
/// @warning The provided C-style byte array must be freed when finished using.
|
|
UInt_64 Receive(Str_8* const addr, UInt_16* const port, Byte* const data, const UInt_64 size) override;
|
|
|
|
/// Sets whether or not receiving data blocks the next task.
|
|
/// @param [in] blocking Whether or not to block.
|
|
void SetBlocking(const bool blocking) override;
|
|
|
|
/// Retrieves whether or not this socket will block when receiving data.
|
|
/// @returns The result.
|
|
bool IsBlocking() const override;
|
|
|
|
bool IsValid() const override;
|
|
|
|
private:
|
|
void Bind_v6(const Str_8& address, const UInt_16 port);
|
|
|
|
void Bind_v4(const Str_8& address, const UInt_16 port);
|
|
|
|
UInt_64 Send_v6(const Str_8& addr, const UInt_16 port, const Byte* const data, const UInt_64 size);
|
|
|
|
UInt_64 Send_v4(const Str_8& addr, const UInt_16 port, const Byte* const data, const UInt_64 size);
|
|
};
|
|
} |