Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

PrevUpHomeNext

windows::basic_random_access_handle

Provides random-access handle functionality.

template<
    typename Executor = any_io_executor>
class basic_random_access_handle :
  public windows::basic_overlapped_handle< any_io_executor >
Types

Name

Description

rebind_executor

Rebinds the handle type to another executor.

executor_type

The type of the executor associated with the object.

lowest_layer_type

An overlapped_handle is always the lowest layer.

native_handle_type

The native representation of a handle.

Member Functions

Name

Description

assign

Assign an existing native handle to the handle.

async_read_some_at

Start an asynchronous read at the specified offset.

async_write_some_at

Start an asynchronous write at the specified offset.

basic_random_access_handle [constructor]

Construct a random-access handle without opening it.

Construct a random-access handle on an existing native handle.

Move-construct a random-access handle from another.

Move-construct a random-access handle from a handle of another executor type.

cancel

Cancel all asynchronous operations associated with the handle.

close

Close the handle.

get_executor

Get the executor associated with the object.

is_open

Determine whether the handle is open.

lowest_layer

Get a reference to the lowest layer.

Get a const reference to the lowest layer.

native_handle

Get the native handle representation.

operator=

Move-assign a random-access handle from another.

Move-assign a random-access handle from a handle of another executor type.

read_some_at

Read some data from the handle at the specified offset.

release

Release ownership of the underlying native handle.

write_some_at

Write some data to the handle at the specified offset.

The windows::basic_random_access_handle class provides asynchronous and blocking random-access handle functionality.

Thread Safety

Distinct objects: Safe.

Shared objects: Unsafe.

Requirements

Header: boost/asio/windows/basic_random_access_handle.hpp

Convenience header: boost/asio.hpp


PrevUpHomeNext