asioext::duplicate()

Duplicate a native file handle. More...

Functions
unique_file_handle	asioext::duplicate (file_handle handle)
	Duplicate the given file_handle's native handle. More...
unique_file_handle	asioext::duplicate (file_handle handle, error_code &ec) noexcept
	Duplicate the given file_handle's native handle. More...

Detailed Description

Duplicate a native file handle.

Duplicate a file handle, resulting in a new native handle referring to the same file.

Function Documentation

duplicate() [1/2]

unique_file_handle asioext::duplicate

(

file_handle

handle

)

Duplicate the given file_handle's native handle.

This function duplicates the native handle and returns a unique_file_handle object wrapping it.

Parameters

handle

The file_handle containing the native handle to duplicate.

Returns

A new unique_file_handle referring to the same file as this unique_file_handle.

Exceptions

asio::system_error

Thrown on failure.

Note

This is provided as a function instead of a copy-contructor/assignment-operator since copying a native handle is a non-trivial operation which is rarely desired.

duplicate() [2/2]

unique_file_handle asioext::duplicate ( file_handle  handle, error_code &  ec  )

noexcept

Duplicate the given file_handle's native handle.

This function duplicates the native handle and returns a unique_file_handle object wrapping it.

Parameters

handle	The file_handle containing the native handle to duplicate.
ec	Set to indicate what error occurred. If no error occurred, the object is reset.

Returns

A new unique_file_handle referring to the same file as handle.

Note

This is provided as a function instead of a copy-contructor/assignment-operator since copying a native handle is a non-trivial operation which is rarely desired.