xtd 0.2.0
udp_client.hpp
Go to the documentation of this file.
1
4#pragma once
5#include "socket.hpp"
6#include "../ip_end_point.hpp"
9#include "../../object.hpp"
10#include "../../string.hpp"
11
13namespace xtd {
15 namespace net {
17 namespace sockets {
45 class core_export_ udp_client : public xtd::object, public xtd::iequatable<udp_client> {
46 class async_result_socket : public xtd::object, public xtd::iasync_result {
47 public:
48 explicit async_result_socket(const xtd::any_object& async_state) : async_state_(async_state) {}
49 xtd::any_object async_state() const noexcept override {return async_state_;}
50 xtd::threading::wait_handle& async_wait_handle() noexcept override {return async_event_;}
51 bool completed_synchronously() const noexcept override {return false;}
52 bool is_completed() const noexcept override {return is_completed_;};
53
54 xtd::any_object async_state_;
55 bool is_completed_ = false;
58 std::exception_ptr exception_;
59 };
60
61 class async_result_receive : public async_result_socket {
62 public:
63 explicit async_result_receive(const xtd::any_object& async_state) : async_result_socket(async_state) {}
65 xtd::net::ip_end_point remote_end_point_;
66 };
67
68 class async_result_send : public async_result_socket {
69 public:
70 explicit async_result_send(const xtd::any_object& async_state) : async_result_socket(async_state) {}
71 size_t number_of_bytes_sent_ = 0;
72 };
73
74 struct data;
75
76 public:
78
99 explicit udp_client(const xtd::net::ip_end_point& local_end_point);
127
129 udp_client(udp_client&&) = default;
130 udp_client(const udp_client&) = default;
131 ~udp_client();
132 udp_client& operator =(const udp_client&) = default;
134
136
145 size_t available() const;
146
155 udp_client& client(const xtd::net::sockets::socket& value) noexcept;
156
163 bool dont_fragment() const;
172
179 bool enable_broadcast() const;
188
206
213 bool multicast_loopback() const;
222
229 xtd::byte ttl() const;
237 udp_client& ttl(xtd::byte value);
239
241
251 void allow_nat_traversal(bool allowed);
252
260
271 xtd::sptr<xtd::iasync_result> begin_send(const xtd::array<xtd::byte>& dgram, size_t bytes, const xtd::string& hostname, uint16 port, xtd::async_callback callback, const xtd::any_object& state);
272
282 xtd::sptr<xtd::iasync_result> begin_send(const xtd::array<xtd::byte>& dgram, size_t bytes, const xtd::net::ip_end_point& end_point, xtd::async_callback callback, const xtd::any_object& state);
291 xtd::sptr<xtd::iasync_result> begin_send(const xtd::array<xtd::byte>& dgram, size_t bytes, xtd::async_callback callback, const xtd::any_object& state);
292
297 void close();
298
333 void connect(const xtd::string& hostname, uint16 port);
334
341 void drop_multicast_group(const xtd::net::ip_address& multicast_address);
349 void drop_multicast_group(const xtd::net::ip_address& multicast_address, uint32 if_index);
350
362
373
377 bool equals(const object& obj) const noexcept override;
381 bool equals(const udp_client& other) const noexcept override;
382
395 void join_multicast_group(const xtd::net::ip_address& multicast_address);
408 void join_multicast_group(uint32 if_index, const xtd::net::ip_address& multicast_address);
421 void join_multicast_group(const xtd::net::ip_address& multicast_address, xtd::byte ttl);
431 void join_multicast_group(const xtd::net::ip_address& multicast_address, const xtd::net::ip_address& local_address);
432
443 xtd::array<xtd::byte> receive(xtd::net::ip_end_point& remote_end_point);
444
457 size_t send(const xtd::array<xtd::byte>& dgram, size_t bytes, const xtd::string& hostname, uint16 port);
469 size_t send(const xtd::array<xtd::byte>& dgram, size_t bytes, const xtd::net::ip_end_point& end_point);
479 size_t send(const xtd::array<xtd::byte>& dgram, size_t bytes);
481
482 protected:
484
489 bool active() const noexcept;
494 udp_client& active(bool value) noexcept;
496
497 private:
499
500 xtd::sptr<data> data_;
501 };
502 }
503 }
504}
Represent a polymorphic wrapper capable of holding any type.
Definition any_object.hpp:29
Provides methods for creating, manipulating, searching, and sorting arrays, thereby serving as the ba...
Definition array.hpp:61
Represents the status of an asynchronous operation.
Definition iasync_result.hpp:25
Defines a generalized method that a value type or class implements to create a type-specific method f...
Definition iequatable.hpp:22
Identifies a network address. This is an abstract class.
Definition end_point.hpp:27
Provides an Internet Protocol (IP) address.
Definition ip_address.hpp:42
Represents a network endpoint as an IP address and a port number.
Definition ip_end_point.hpp:28
Implements the Berkeley sockets interface.
Definition socket.hpp:77
void connect(const xtd::net::ip_end_point &end_point)
Establishes a default remote host using the specified network endpoint.
udp_client(uint16 port, xtd::net::sockets::address_family addressFamily)
Initializes a new instance of the xtd::net::sockets::udp_client class and binds it to the local port ...
bool exclusive_address_use() const
Gets a boolean value that specifies whether the xtd::net::sockets::udp_client allows only one client ...
bool equals(const object &obj) const noexcept override
Determines whether the specified object is equal to the current object.
bool enable_broadcast() const
Gets a boolean value that specifies whether the xtd::net::sockets::udp_client may send or receive bro...
xtd::sptr< xtd::iasync_result > begin_send(const xtd::array< xtd::byte > &dgram, size_t bytes, const xtd::string &hostname, uint16 port, xtd::async_callback callback, const xtd::any_object &state)
xtd::net::sockets::udp_client::sends a datagram to a destination asynchronously. The destination is s...
xtd::array< xtd::byte > receive(xtd::net::ip_end_point &remote_end_point)
Returns a UDP datagram that was sent by a remote host.
xtd::byte ttl() const
Gets a value that specifies the Time to Live (TTL) value of Internet Protocol (IP) packets sent by th...
size_t send(const xtd::array< xtd::byte > &dgram, size_t bytes, const xtd::string &hostname, uint16 port)
xtd::net::sockets::udp_client::sends a UDP datagram to a specified port on a specified remote host.
xtd::array< xtd::byte > end_receive(xtd::sptr< xtd::iasync_result > async_result, xtd::net::ip_end_point &remote_end_point)
Ends a pending asynchronous receive.
udp_client(uint16 port)
Initializes a new instance of the xtd::net::sockets::udp_client class and binds it to the local port ...
udp_client(const xtd::net::ip_end_point &local_end_point)
Initializes a new instance of the xtd::net::sockets::udp_client class and binds it to the specified l...
void close()
Closes the UDP connection.
size_t end_send(xtd::sptr< xtd::iasync_result > async_result)
Ends a pending asynchronous send.
bool active() const noexcept
Gets a value that indicates whether a connection has been made.
bool dont_fragment() const
Gets a boolean value that specifies whether the xtd::net::sockets::udp_client allows Internet Protoco...
void drop_multicast_group(const xtd::net::ip_address &multicast_address)
Leaves a multicast group.
udp_client(const xtd::string &hostname, uint16 port)
Initializes a new instance of the xtd::net::sockets::udp_client class and establishes a default remot...
xtd::net::sockets::socket client() const noexcept
Gets the underlying network xtd::net::sockets::socket.
udp_client()
Initializes a new instance of the xtd::net::sockets::udp_client class.
void join_multicast_group(const xtd::net::ip_address &multicast_address)
Adds a xtd::net::sockets::udp_client to a multicast group.
xtd::sptr< xtd::iasync_result > begin_receive(xtd::async_callback callback, const xtd::any_object &state)
xtd::net::sockets::udp_client::receives a datagram from a remote host asynchronously.
bool multicast_loopback() const
Gets a boolean value that specifies whether outgoing multicast packets are delivered to the sending a...
void allow_nat_traversal(bool allowed)
Enables or disables Network Address Translation (NAT) traversal on a xtd::net::sockets::udp_client in...
size_t available() const
Gets the amount of data received from the network that is available to read.
udp_client(xtd::net::sockets::address_family address_Family)
Initializes a new instance of the xtd::net::sockets::udp_client class.
Supports all classes in the xtd class hierarchy and provides low-level services to derived classes....
Definition object.hpp:44
Represents a thread synchronization event that, when signaled, must be reset manually....
Definition manual_reset_event.hpp:35
Encapsulates operating system specific objects that wait for exclusive access to shared resources.
Definition wait_handle.hpp:52
xtd::delegate< void(async_result ar)> async_callback
References a method to be called when a corresponding asynchronous operation completes.
Definition delegate.hpp:39
#define core_export_
Define shared library export.
Definition core_export.hpp:13
xtd::basic_string< char > string
Represents text as a sequence of UTF-8 code units.
Definition __string_definitions.hpp:43
xtd::shared_ptr_object< type_t > sptr
The xtd::sptr object is a shared pointer.
Definition sptr.hpp:25
uint16_t uint16
Represents a 16-bit unsigned integer.
Definition uint16.hpp:23
uint32_t uint32
Represents a 32-bit unsigned integer.
Definition uint32.hpp:23
xtd::sptr< xtd::iasync_result > async_result
Represents the status of an asynchronous operation.
Definition async_result.hpp:19
socket_error
Defines error codes for the xtd::net::sockets::socket class.
Definition socket_error.hpp:30
address_family
Specifies the addressing scheme that an instance of the xtd::net::sockets::socket class can use.
Definition address_family.hpp:30
@ success
Operation successful.
Definition socket_error.hpp:34
@ port
The xtd::uri::port data.
Definition uri_components.hpp:25
@ other
The operating system is other.
Definition platform_id.hpp:58
@ dgram
Supports datagrams, which are connectionless, unreliable messages of a fixed (typically small) maximu...
Definition socket_type.hpp:38
Contains xtd::iequatable interface.
Contains xtd::net::ip_end_point class.
Contains xtd::threading::manual_reset_event exception.
The xtd::net::sockets namespace provides a managed implementation of the Berkeley Sockets interface f...
Definition address_family.hpp:16
The xtd::net namespace provides a simple programming interface for many of the protocols used on netw...
Definition cookie_exception.hpp:10
The xtd namespace contains all fundamental classes to access Hardware, Os, System,...
Definition abstract_object.hpp:8
constexpr const_pointer data() const noexcept
Gets direct access to the underlying contiguous storage.
Definition read_only_span.hpp:201
Contains xtd::object class.
Contains xtd::net::sockets::socket class.
Contains xtd::string alias.