1//
2// random_access_handle.cpp
3// ~~~~~~~~~~~~~~~~~~~~~~~~
4//
5// Copyright (c) 2003-2024 Christopher M. Kohlhoff (chris at kohlhoff dot com)
6//
7// Distributed under the Boost Software License, Version 1.0. (See accompanying
8// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
9//
10
11// Disable autolinking for unit tests.
12#if !defined(BOOST_ALL_NO_LIB)
13#define BOOST_ALL_NO_LIB 1
14#endif // !defined(BOOST_ALL_NO_LIB)
15
16// Test that header file is self-contained.
17#include <boost/asio/windows/random_access_handle.hpp>
18
19#include <boost/asio/io_context.hpp>
20#include "../archetypes/async_result.hpp"
21#include "../unit_test.hpp"
22
23//------------------------------------------------------------------------------
24
25// windows_random_access_handle_compile test
26// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
27// The following test checks that all public member functions on the class
28// windows::random_access_handle compile and link correctly. Runtime failures
29// are ignored.
30
31namespace windows_random_access_handle_compile {
32
33void write_some_handler(const boost::system::error_code&, std::size_t)
34{
35}
36
37void read_some_handler(const boost::system::error_code&, std::size_t)
38{
39}
40
41void test()
42{
43#if defined(BOOST_ASIO_HAS_WINDOWS_RANDOM_ACCESS_HANDLE)
44 using namespace boost::asio;
45 namespace win = boost::asio::windows;
46
47 try
48 {
49 io_context ioc;
50 const io_context::executor_type ioc_ex = ioc.get_executor();
51 char mutable_char_buffer[128] = "";
52 const char const_char_buffer[128] = "";
53 boost::asio::uint64_t offset = 0;
54 archetypes::lazy_handler lazy;
55 boost::system::error_code ec;
56
57 // basic_random_access_handle constructors.
58
59 win::random_access_handle handle1(ioc);
60 HANDLE native_handle1 = INVALID_HANDLE_VALUE;
61#if defined(BOOST_ASIO_MSVC) && (_MSC_VER < 1910)
62 // Skip this on older MSVC due to mysterious ambiguous overload errors.
63#else
64 win::random_access_handle handle2(ioc, native_handle1);
65#endif
66
67 win::random_access_handle handle3(ioc_ex);
68 HANDLE native_handle2 = INVALID_HANDLE_VALUE;
69 win::random_access_handle handle4(ioc_ex, native_handle2);
70
71 win::random_access_handle handle5(std::move(handle4));
72
73 win::basic_random_access_handle<io_context::executor_type> handle6(ioc);
74 win::random_access_handle handle7(std::move(handle6));
75
76 // basic_random_access_handle operators.
77
78 handle1 = win::random_access_handle(ioc);
79 handle1 = std::move(handle4);
80 handle1 = std::move(handle6);
81
82 // basic_io_object functions.
83
84 windows::random_access_handle::executor_type ex = handle1.get_executor();
85 (void)ex;
86
87 // basic_overlapped_handle functions.
88
89 win::random_access_handle::lowest_layer_type& lowest_layer
90 = handle1.lowest_layer();
91 (void)lowest_layer;
92
93 const win::random_access_handle& handle8 = handle1;
94 const win::random_access_handle::lowest_layer_type& lowest_layer2
95 = handle8.lowest_layer();
96 (void)lowest_layer2;
97
98 HANDLE native_handle3 = INVALID_HANDLE_VALUE;
99 handle1.assign(native_handle3);
100
101 bool is_open = handle1.is_open();
102 (void)is_open;
103
104 handle1.close();
105 handle1.close(ec);
106
107 win::random_access_handle::native_handle_type native_handle4
108 = handle1.release();
109 (void)native_handle4;
110 win::random_access_handle::native_handle_type native_handle5
111 = handle1.release(ec);
112 (void)native_handle5;
113
114 win::random_access_handle::native_handle_type native_handle6
115 = handle1.native_handle();
116 (void)native_handle6;
117
118 handle1.cancel();
119 handle1.cancel(ec);
120
121 // basic_random_access_handle functions.
122
123 handle1.write_some_at(offset, buffer(mutable_char_buffer));
124 handle1.write_some_at(offset, buffer(const_char_buffer));
125 handle1.write_some_at(offset, buffer(mutable_char_buffer), ec);
126 handle1.write_some_at(offset, buffer(const_char_buffer), ec);
127
128 handle1.async_write_some_at(offset,
129 buffer(mutable_char_buffer), &write_some_handler);
130 handle1.async_write_some_at(offset,
131 buffer(const_char_buffer), &write_some_handler);
132 int i1 = handle1.async_write_some_at(offset,
133 buffer(mutable_char_buffer), lazy);
134 (void)i1;
135 int i2 = handle1.async_write_some_at(offset,
136 buffer(const_char_buffer), lazy);
137 (void)i2;
138
139 handle1.read_some_at(offset, buffer(mutable_char_buffer));
140 handle1.read_some_at(offset, buffer(mutable_char_buffer), ec);
141
142 handle1.async_read_some_at(offset,
143 buffer(mutable_char_buffer), &read_some_handler);
144 int i3 = handle1.async_read_some_at(offset,
145 buffer(mutable_char_buffer), lazy);
146 (void)i3;
147 }
148 catch (std::exception&)
149 {
150 }
151#endif // defined(BOOST_ASIO_HAS_WINDOWS_RANDOM_ACCESS_HANDLE)
152}
153
154} // namespace windows_random_access_handle_compile
155
156//------------------------------------------------------------------------------
157
158BOOST_ASIO_TEST_SUITE
159(
160 "windows/random_access_handle",
161 BOOST_ASIO_COMPILE_TEST_CASE(windows_random_access_handle_compile::test)
162)
163

source code of boost/libs/asio/test/windows/random_access_handle.cpp