xtd::net::sockets::send_packets_element Class Reference

Inheritance diagram for xtd::net::sockets::send_packets_element:

Definition

Represents an element in a xtd::net::sockets::send_packets_element array.

class core_export_ send_packets_element : public xtd::object

Inheritance

xtd::object → xtd::net::sockets::send_packets_element

Header

#include <xtd/net/sockets/send_packets_element>

Namespace

xtd::net::sockets

Library

xtd.core

Remarks

The xtd::net::sockets::send_packets_element class is used to enhance the xtd::net::sockets::socket class for use by server applications that use asynchronous network I/O to achieve the highest performance. The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::send_packets_async method.

Public Aliases
using	ifstream_ref
	Represent ta std::ifstream reference.

Public Constructors
	send_packets_element ()=default
	Initializes a new instance of the xtd::net::sockets::send_packets_element class.
	send_packets_element (const xtd::array< xtd::byte > &buffer)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified buffer.
	send_packets_element (const xtd::string &file_path, xtd::usize offset, xtd::usize count, bool end_of_packet)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the file with an option to combine this element with the next element in a single send request from the sockets layer to the transport.
	send_packets_element (const xtd::array< xtd::byte > &buffer, xtd::usize offset, xtd::usize count, bool end_of_packet)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the buffer with an option to combine this element with the next element in a single send request from the sockets layer to the transport.
	send_packets_element (const xtd::string &file_path, xtd::usize offset, xtd::usize count)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the file with an option to combine this element with the next element in a single send request from the sockets layer to the transport.
	send_packets_element (std::ifstream &file_stream, xtd::usize offset, xtd::usize count, bool end_of_packet)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the buffer with an option to combine this element with the next element in a single send request from the sockets layer to the transport.
	send_packets_element (const xtd::array< xtd::byte > &buffer, xtd::usize offset, xtd::usize count)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the buffer with an option to combine this element with the next element in a single send request from the sockets layer to the transport.
	send_packets_element (const xtd::string &file_path)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified file.
	send_packets_element (std::ifstream &file_stream)
	Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified FileStream object.

Public Properties
auto	buffer () const noexcept -> xtd::array< xtd::byte >
	Gets the buffer to be sent if the xtd::net::sockets::send_packets_element object was initialized with a buffer parameter.
auto	count () const noexcept -> xtd::usize
	Gets the count of bytes to be sent.
auto	end_of_packet () const noexcept -> bool
	Gets a bool value that indicates if this element should not be combined with the next element in a single send request from the sockets layer to the transport.
auto	file_path () const noexcept -> const xtd::string &
	Gets the filename of the file to send if the xtd::net::sockets::send_packets_element object was initialized with a file_path parameter.
auto	file_stream () const noexcept -> std::optional< ifstream_ref >
	Gets the object representation of the file to send if the xtd::net::sockets::send_packets_element object was initialized with a std::ifstream parameter.
auto	offset () const noexcept -> xtd::usize
	Gets the offset, in bytes, from the beginning of the data buffer or file to the location in the buffer or file to start sending the data.

Additional Inherited Members
	object ()=default
	Create a new instance of the ultimate base class object.
virtual auto	equals (const object &obj) const noexcept -> bool
	Determines whether the specified object is equal to the current object.
virtual auto	get_hash_code () const noexcept -> xtd::usize
	Serves as a hash function for a particular type.
virtual auto	get_type () const noexcept -> type_object
	Gets the type of the current instance.
template<typename object_t>
auto	memberwise_clone () const -> xtd::unique_ptr_object< object_t >
	Creates a shallow copy of the current object.
virtual auto	to_string () const -> xtd::string
	Returns a xtd::string that represents the current object.
template<typename object_a_t, typename object_b_t>
static auto	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are considered equal.
template<typename object_a_t, typename object_b_t>
static auto	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are the same instance.

Member Typedef Documentation

ifstream_ref

using xtd::net::sockets::send_packets_element::ifstream_ref

Represent ta std::ifstream reference.

Constructor & Destructor Documentation

send_packets_element() [1/9]

xtd::net::sockets::send_packets_element::send_packets_element ( )

default

Initializes a new instance of the xtd::net::sockets::send_packets_element class.

send_packets_element() [2/9]

xtd::net::sockets::send_packets_element::send_packets_element ( const xtd::array< xtd::byte > & buffer )

explicit

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified buffer.

Parameters

buffer

A byte array of data to send using the xtd::net::sockets::socket::send_packets_async method.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

send_packets_element() [3/9]

xtd::net::sockets::send_packets_element::send_packets_element	(	const xtd::string &	file_path,
		xtd::usize	offset,
		xtd::usize	count,
		bool	end_of_packet )

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the file with an option to combine this element with the next element in a single send request from the sockets layer to the transport.

Parameters

file_path	The filename of the file to be transmitted using the xtd::net::sockets::socket::send_packets_async method.
offset	The offset, in bytes, from the beginning of the file to the location in the file to start sending the file specified in the file_path parameter.
count	The number of bytes to send starting from the offset parameter. If count is zero, the entire file is sent.
end_of_packet	Specifies that this element should not be combined with the next element in a single send request from the sockets layer to the transport. This flag is used for granular control of the content of each message on a datagram or message-oriented socket.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

Universal Naming Convention (UNC) paths are supported by the file_path parameter. If the file is in the current working directory, no path information needs to be specified.

send_packets_element() [4/9]

xtd::net::sockets::send_packets_element::send_packets_element	(	const xtd::array< xtd::byte > &	buffer,
		xtd::usize	offset,
		xtd::usize	count,
		bool	end_of_packet )

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the buffer with an option to combine this element with the next element in a single send request from the sockets layer to the transport.

Parameters

buffer	A byte array of data to send using the xtd::net::sockets::socket::send_packets_async method.
offset	The offset, in bytes, from the beginning of the buffer to the location in the buffer to start sending the data specified in the buffer parameter.
count	The number bytes to send starting from the offset parameter. If count is zero, no bytes are sent.
end_of_packet	Specifies that this element should not be combined with the next element in a single send request from the sockets layer to the transport. This flag is used for granular control of the content of each message on a datagram or message-oriented socket.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

send_packets_element() [5/9]

xtd::net::sockets::send_packets_element::send_packets_element	(	const xtd::string &	file_path,
		xtd::usize	offset,
		xtd::usize	count )

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the file with an option to combine this element with the next element in a single send request from the sockets layer to the transport.

Parameters

file_path	The filename of the file to be transmitted using the xtd::net::sockets::socket::send_packets_async method.
offset	The offset, in bytes, from the beginning of the file to the location in the file to start sending the file specified in the file_path parameter.
count	The number of bytes to send starting from the offset parameter. If count is zero, the entire file is sent.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

Universal Naming Convention (UNC) paths are supported by the file_path parameter. If the file is in the current working directory, no path information needs to be specified.

send_packets_element() [6/9]

xtd::net::sockets::send_packets_element::send_packets_element	(	std::ifstream &	file_stream,
		xtd::usize	offset,
		xtd::usize	count,
		bool	end_of_packet )

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the buffer with an option to combine this element with the next element in a single send request from the sockets layer to the transport.

Parameters

file_stream	The file to be transmitted using the xtd::net::sockets::socket::send_packets_async method.
offset	The offset, in bytes, from the beginning of the file to the location in the file to start sending the bytes in the file.
count	The number of bytes to send starting from the offset parameter. If count is zero, the entire file is sent.
end_of_packet	Specifies that this element should not be combined with the next element in a single send request from the sockets layer to the transport. This flag is used for granular control of the content of each message on a datagram or message-oriented socket.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

send_packets_element() [7/9]

xtd::net::sockets::send_packets_element::send_packets_element	(	const xtd::array< xtd::byte > &	buffer,
		xtd::usize	offset,
		xtd::usize	count )

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified range of the buffer with an option to combine this element with the next element in a single send request from the sockets layer to the transport.

Parameters

buffer	A byte array of data to send using the xtd::net::sockets::socket::send_packets_async method.
offset	The offset, in bytes, from the beginning of the buffer to the location in the buffer to start sending the data specified in the buffer parameter.
count	The number bytes to send starting from the offset parameter. If count is zero, no bytes are sent.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

send_packets_element() [8/9]

xtd::net::sockets::send_packets_element::send_packets_element ( const xtd::string & file_path )

explicit

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified file.

Parameters

file_path

The filename of the file to be transmitted using the xtd::net::sockets::socket::send_packets_async method.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

Universal Naming Convention (UNC) paths are supported by the file_path parameter. If the file is in the current working directory, no path information needs to be specified.

send_packets_element() [9/9]

xtd::net::sockets::send_packets_element::send_packets_element ( std::ifstream & file_stream )

explicit

Initializes a new instance of the xtd::net::sockets::send_packets_element class using the specified FileStream object.

Parameters

file_stream

The file to be transmitted using the xtd::net::sockets::socket::send_packets_async method.

Remarks

The xtd::net::sockets::send_packets_element class is used with the xtd::net::sockets::socket::socket_async_event_args::send_packets_elements property to get or set a data buffer or file to be sent using the xtd::net::sockets::socket::socket::send_packets_async method.

Member Function Documentation

buffer()

auto xtd::net::sockets::send_packets_element::buffer ( ) const -> xtd::array< xtd::byte >

nodiscardnoexcept

Gets the buffer to be sent if the xtd::net::sockets::send_packets_element object was initialized with a buffer parameter.

Returns

The byte buffer to send if the xtd::net::sockets::send_packets_element object was initialized with a buffer parameter.

Remarks

The default value for the xtd::net::sockets::send_packets_element::buffer property is empty if the xtd::net::sockets::send_packets_element object was not initialized with a buffer parameter.

count()

auto xtd::net::sockets::send_packets_element::count ( ) const -> xtd::usize

nodiscardnoexcept

Gets the count of bytes to be sent.

Returns

The count of bytes to send if the xtd::net::sockets::send_packets_element class was initialized with a count parameter.

Remarks

The default value for the xtd::net::sockets::send_packets_element::count property is zero if the xtd::net::sockets::send_packets_element class was not initialized with a count parameter.

If Count is zero for a file, the entire file is sent. If xtd::net::sockets::send_packets_element::count is zero for a buffer, no bytes are sent.

end_of_packet()

auto xtd::net::sockets::send_packets_element::end_of_packet ( ) const -> bool

nodiscardnoexcept

Gets a bool value that indicates if this element should not be combined with the next element in a single send request from the sockets layer to the transport.

Returns

A bool value that indicates if this element should not be combined with the next element in a single send request.

Remarks

The default value for the xtd::net::sockets::send_packets_element::end_of_packet property is false if the xtd::net::sockets::send_packets_element class was not initialized with an end_of_packet parameter set to true.

file_path()

auto xtd::net::sockets::send_packets_element::file_path ( ) const -> const xtd::string &

nodiscardnoexcept

Gets the filename of the file to send if the xtd::net::sockets::send_packets_element object was initialized with a file_path parameter.

Returns

The filename of the file to send if the xtd::net::sockets::send_packets_element object was initialized with a file_path parameter.

Remarks

Universal Naming Convention (UNC) paths are supported by the xtd::net::sockets::send_packets_element::file_path property. If the file is in the current working directory, no path information needs to be specified.

The default value for the xtd::net::sockets::send_packets_element::file_path property is empty if the xtd::net::sockets::send_packets_element object was not initialized with a file_path parameter.

file_stream()

auto xtd::net::sockets::send_packets_element::file_stream ( ) const -> std::optional< ifstream_ref >

nodiscardnoexcept

Gets the object representation of the file to send if the xtd::net::sockets::send_packets_element object was initialized with a std::ifstream parameter.

Remarks

An object representation of the file to send if the xtd::net::sockets::send_packets_element object was initialized with a std::ifstream parameter.

The default value for the xtd::net::sockets::send_packets_element::file_stream property is empty if the xtd::net::sockets::send_packets_element object was not initialized with a file_stream parameter.

offset()

auto xtd::net::sockets::send_packets_element::offset ( ) const -> xtd::usize

nodiscardnoexcept

Gets the offset, in bytes, from the beginning of the data buffer or file to the location in the buffer or file to start sending the data.

Returns

The offset, in bytes, from the beginning of the data buffer or file to the location in the buffer or file to start sending the data.

Remarks

The default value for the xtd::net::sockets::send_packets_element::offset property is zero if the xtd::net::sockets::send_packets_element class was not initialized with an offset parameter.

---

The documentation for this class was generated from the following file:

• xtd.core/include/xtd/net/sockets/send_packets_element.hpp