mirror of
https://github.com/30hours/blah2.git
synced 2024-11-18 12:33:58 +00:00
Initial commit
This commit is contained in:
parent
4f67475e2e
commit
d432945c0b
769 changed files with 248543 additions and 0 deletions
6
.gitignore
vendored
Normal file
6
.gitignore
vendored
Normal file
|
@ -0,0 +1,6 @@
|
||||||
|
build/*
|
||||||
|
bin/*
|
||||||
|
!build/README.md
|
||||||
|
!bin/README.md
|
||||||
|
*.a
|
||||||
|
*.so
|
64
CMakeLists.txt
Normal file
64
CMakeLists.txt
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
project(blah2)
|
||||||
|
cmake_minimum_required(VERSION 3.8)
|
||||||
|
|
||||||
|
SET(CMAKE_CXX_STANDARD 17)
|
||||||
|
SET(CMAKE_CXX_STANDARD_REQUIRED ON)
|
||||||
|
SET(CMAKE_CXX_EXTENSIONS OFF)
|
||||||
|
SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -pthread")
|
||||||
|
|
||||||
|
SET (PROJECT_ROOT "${PROJECT_SOURCE_DIR}")
|
||||||
|
SET (CMAKE_RUNTIME_OUTPUT_DIRECTORY "${PROJECT_ROOT}/bin")
|
||||||
|
SET (PROJECT_SOURCE_DIR "${PROJECT_SOURCE_DIR}/src")
|
||||||
|
SET (PROJECT_BINARY_DIR "${PROJECT_ROOT}/bin")
|
||||||
|
SET (PROJECT_LIB_DIR "${PROJECT_ROOT}/lib")
|
||||||
|
MESSAGE ("Source path: ${PROJECT_SOURCE_DIR}")
|
||||||
|
MESSAGE ("Binary path: ${PROJECT_BINARY_DIR}")
|
||||||
|
MESSAGE ("Lib path: ${PROJECT_LIB_DIR}")
|
||||||
|
|
||||||
|
add_executable(blah2
|
||||||
|
${PROJECT_SOURCE_DIR}/blah2.cpp
|
||||||
|
${PROJECT_SOURCE_DIR}/capture/Capture.cpp
|
||||||
|
${PROJECT_SOURCE_DIR}/capture/rspduo/RspDuo.cpp
|
||||||
|
${PROJECT_SOURCE_DIR}/process/ambiguity/Ambiguity.cpp
|
||||||
|
${PROJECT_SOURCE_DIR}/process/clutter/WienerHopf.cpp
|
||||||
|
${PROJECT_SOURCE_DIR}/data/IqData.cpp
|
||||||
|
${PROJECT_SOURCE_DIR}/data/Map.cpp
|
||||||
|
)
|
||||||
|
|
||||||
|
add_library(ryml ${PROJECT_LIB_DIR}/rapidyaml-0.5.0/ryml-0.5.0.hpp)
|
||||||
|
add_library(rapidjson ${PROJECT_LIB_DIR}/rapidjson-1.1.0/)
|
||||||
|
add_library(sdrplay /usr/local/include/sdrplay_api.h)
|
||||||
|
add_library(asio ${PROJECT_LIB_DIR}/asio-1.26.0/asio.hpp)
|
||||||
|
add_library(httplib ${PROJECT_LIB_DIR}/cpp-httplib-0.12.2/httplib.h)
|
||||||
|
|
||||||
|
include_directories("${PROJECT_LIB_DIR}/rapidjson-1.1.0/")
|
||||||
|
set_target_properties(rapidjson PROPERTIES LINKER_LANGUAGE CXX)
|
||||||
|
target_link_libraries(blah2 rapidjson)
|
||||||
|
|
||||||
|
include_directories("${PROJECT_LIB_DIR}/asio-1.26.0/")
|
||||||
|
set_target_properties(asio PROPERTIES LINKER_LANGUAGE CXX)
|
||||||
|
target_link_libraries(blah2 asio)
|
||||||
|
|
||||||
|
include_directories("${PROJECT_LIB_DIR}/cpp-httplib-0.12.2/")
|
||||||
|
set_target_properties(httplib PROPERTIES LINKER_LANGUAGE CXX)
|
||||||
|
target_link_libraries(blah2 httplib)
|
||||||
|
|
||||||
|
include_directories("${PROJECT_LIB_DIR}/rapidyaml-0.5.0/")
|
||||||
|
set_target_properties(ryml PROPERTIES LINKER_LANGUAGE CXX)
|
||||||
|
target_link_libraries(blah2 ryml)
|
||||||
|
|
||||||
|
set_target_properties(sdrplay PROPERTIES LINKER_LANGUAGE C)
|
||||||
|
target_link_libraries(sdrplay /usr/local/lib/libsdrplay_api.so.3.07)
|
||||||
|
target_link_libraries(blah2 sdrplay)
|
||||||
|
|
||||||
|
target_link_libraries(blah2 fftw3)
|
||||||
|
target_link_libraries(blah2 fftw3_threads)
|
||||||
|
target_link_libraries(blah2 lapack)
|
||||||
|
target_link_libraries(blah2 blas)
|
||||||
|
target_link_libraries(blah2 armadillo)
|
||||||
|
|
||||||
|
include_directories("${PROJECT_SOURCE_DIR}/capture/")
|
||||||
|
include_directories("${PROJECT_SOURCE_DIR}/capture/rspduo/")
|
||||||
|
include_directories("${PROJECT_SOURCE_DIR}/process/ambiguity/")
|
||||||
|
include_directories("${PROJECT_SOURCE_DIR}/process/clutter/")
|
||||||
|
include_directories("${PROJECT_SOURCE_DIR}/data/")
|
16
Dockerfile
Normal file
16
Dockerfile
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
FROM ubuntu:18.04 as blah2_env
|
||||||
|
MAINTAINER 30hours <nathan@30hours.dev>
|
||||||
|
|
||||||
|
WORKDIR blah2
|
||||||
|
ADD lib lib
|
||||||
|
RUN apt-get update
|
||||||
|
RUN apt-get install -y g++ make cmake libfftw3-dev liblapack-dev libopenblas-dev xz-utils libudev-dev libusb-1.0.0-dev sudo systemd
|
||||||
|
RUN cd lib && tar xf armadillo-12.0.1.tar.xz && cd armadillo-12.0.1 && cmake . && make install
|
||||||
|
RUN cd lib/sdrplay-3.0.7 && mkdir -p /etc/udev/rules.d && yes | ./install_lib.sh
|
||||||
|
|
||||||
|
FROM blah2_env as blah2
|
||||||
|
MAINTAINER 30hours <nathan@30hours.dev>
|
||||||
|
|
||||||
|
ADD . .
|
||||||
|
RUN rm -rf build && mkdir -p build && cd build && cmake .. && make
|
||||||
|
RUN chmod +x bin/blah2
|
64
README.md
Normal file
64
README.md
Normal file
|
@ -0,0 +1,64 @@
|
||||||
|
# blah2
|
||||||
|
|
||||||
|
A real-time radar which can support various SDR platforms.
|
||||||
|
|
||||||
|
![blah2 example display](./example.png "blah2")
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Currently only support for the [SDRplay RSPDuo](https://www.sdrplay.com/rspduo/).
|
||||||
|
- 2 channel processing for a reference and surveillance signal.
|
||||||
|
- Designed as a passive radar, but can also work as an active radar.
|
||||||
|
- Outputs delay-Doppler maps to a web front-end.
|
||||||
|
- Record raw IQ data by pressing spacebar on the web front-end.
|
||||||
|
- Saves delay-Doppler maps in a *json* array.
|
||||||
|
|
||||||
|
## Services
|
||||||
|
|
||||||
|
The build environment consists of a docker-compose.yml file running the following services;
|
||||||
|
|
||||||
|
- The radar processor responsible for IQ capture and processing.
|
||||||
|
- The API middleware responsible for reading TCP ports for delay-Doppler map data, and exposing this on a REST API.
|
||||||
|
- The web front-end displaying processed radar data.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
- Install docker and docker-compose on the host machine.
|
||||||
|
- Clone this repository to some directory.
|
||||||
|
- Install dependencies from Dockerfile.
|
||||||
|
- Edit the config.yml for desired processing parameters.
|
||||||
|
- Run the docker-compose command.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone http://github.com/30hours/blah2
|
||||||
|
cd blah2
|
||||||
|
vim config/config.yml
|
||||||
|
sudo mkdir /opt/blah2
|
||||||
|
sudo chmod a+rw /opt/blah2
|
||||||
|
|
||||||
|
sudo docker-compose up -d blah2_frontend blah2_api
|
||||||
|
mkdir build && cd build
|
||||||
|
cmake .. && make && cd ..
|
||||||
|
./bin/blah2 -c config/config.yml
|
||||||
|
```
|
||||||
|
|
||||||
|
The radar processing output is available on [http://localhost:49152](http://localhost:49152).
|
||||||
|
|
||||||
|
## Future Work
|
||||||
|
|
||||||
|
- The blah2 service can be built in Docker, except for the SDRplay API due to its dependence on *systemd*. This service needs to be built manually with *cmake* at present.
|
||||||
|
- A CFAR detector has not yet been implemented.
|
||||||
|
- Support for the HackRF and RTL-SDR using front-end mixer to sample 2 RF channels in 1 stream.
|
||||||
|
- Occasional segmentation fault from a mutex issue.
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
|
||||||
|
- If the SDRplay RSPduo does not capture data, restart the API service using `sudo systemctl restart sdrplay.api`.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Pull requests are welcome - especially for adding support for a new SDR.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
[MIT](https://choosealicense.com/licenses/mit/)
|
19
api/Dockerfile
Normal file
19
api/Dockerfile
Normal file
|
@ -0,0 +1,19 @@
|
||||||
|
FROM node:16
|
||||||
|
|
||||||
|
# Create app directory
|
||||||
|
WORKDIR /usr/src/app
|
||||||
|
|
||||||
|
# Install app dependencies
|
||||||
|
# A wildcard is used to ensure both package.json AND package-lock.json are copied
|
||||||
|
# where available (npm@5+)
|
||||||
|
COPY package*.json ./
|
||||||
|
|
||||||
|
RUN npm install
|
||||||
|
# If you are building your code for production
|
||||||
|
# RUN npm ci --only=production
|
||||||
|
|
||||||
|
# Bundle app source
|
||||||
|
COPY . .
|
||||||
|
|
||||||
|
EXPOSE 8080
|
||||||
|
CMD [ "node", "server.js" ]
|
13
api/package.json
Normal file
13
api/package.json
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
{
|
||||||
|
"name": "blah2-api",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "blah2-api",
|
||||||
|
"author": "github.com/30hours",
|
||||||
|
"main": "server.js",
|
||||||
|
"scripts": {
|
||||||
|
"start": "node server.js"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"express": "^4.16.1"
|
||||||
|
}
|
||||||
|
}
|
54
api/server.js
Normal file
54
api/server.js
Normal file
|
@ -0,0 +1,54 @@
|
||||||
|
const express = require('express');
|
||||||
|
const dgram = require('dgram');
|
||||||
|
|
||||||
|
// constants
|
||||||
|
const PORT = 3000;
|
||||||
|
const HOST = '0.0.0.0';
|
||||||
|
var map = '';
|
||||||
|
var data = '';
|
||||||
|
var capture = false;
|
||||||
|
|
||||||
|
// api server
|
||||||
|
const app = express();
|
||||||
|
// header on all requests
|
||||||
|
app.use(function(req, res, next) {
|
||||||
|
res.header("Access-Control-Allow-Origin", "*");
|
||||||
|
next();
|
||||||
|
});
|
||||||
|
app.get('/', (req, res) => {
|
||||||
|
res.send('Hello World');
|
||||||
|
});
|
||||||
|
app.get('/map', (req, res) => {
|
||||||
|
res.send(map);
|
||||||
|
});
|
||||||
|
// read state of capture
|
||||||
|
app.get('/capture', (req, res) => {
|
||||||
|
res.send(capture);
|
||||||
|
});
|
||||||
|
// toggle state of capture
|
||||||
|
app.get('/capture/toggle', (req, res) => {
|
||||||
|
capture = !capture;
|
||||||
|
res.send('{}');
|
||||||
|
});
|
||||||
|
app.listen(PORT, HOST, () => {
|
||||||
|
console.log(`Running on http://${HOST}:${PORT}`);
|
||||||
|
});
|
||||||
|
|
||||||
|
// tcp listener
|
||||||
|
const net = require("net");
|
||||||
|
const server = net.createServer((socket)=>{
|
||||||
|
socket.write("Hello From Server!")
|
||||||
|
socket.on("data",(msg)=>{
|
||||||
|
data = data + msg.toString();
|
||||||
|
if (data.slice(-1) === "}")
|
||||||
|
{
|
||||||
|
console.log('EOF');
|
||||||
|
map = data;
|
||||||
|
data = '';
|
||||||
|
}
|
||||||
|
});
|
||||||
|
socket.on("close",()=>{
|
||||||
|
console.log("Connection closed.");
|
||||||
|
})
|
||||||
|
});
|
||||||
|
server.listen(3001);
|
17
api/server.js.old
Normal file
17
api/server.js.old
Normal file
|
@ -0,0 +1,17 @@
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
const express = require('express');
|
||||||
|
|
||||||
|
// Constants
|
||||||
|
const PORT = 8080;
|
||||||
|
const HOST = '0.0.0.0';
|
||||||
|
|
||||||
|
// App
|
||||||
|
const app = express();
|
||||||
|
app.get('/', (req, res) => {
|
||||||
|
res.send('Hello World');
|
||||||
|
});
|
||||||
|
|
||||||
|
app.listen(PORT, HOST, () => {
|
||||||
|
console.log(`Running on http://${HOST}:${PORT}`);
|
||||||
|
});
|
2
changelog.md
Normal file
2
changelog.md
Normal file
|
@ -0,0 +1,2 @@
|
||||||
|
## [0.1] - 04/May/2023
|
||||||
|
- Initial release
|
39
config/config.yml
Normal file
39
config/config.yml
Normal file
|
@ -0,0 +1,39 @@
|
||||||
|
capture:
|
||||||
|
fs: 2000000
|
||||||
|
fc: 204640000
|
||||||
|
type: "RspDuo"
|
||||||
|
replay:
|
||||||
|
state: true
|
||||||
|
loop: true
|
||||||
|
file: '/opt/blah2/replay/file.rspduo'
|
||||||
|
|
||||||
|
process:
|
||||||
|
data:
|
||||||
|
cpi: 0.5
|
||||||
|
buffer: 1
|
||||||
|
overlap: 0
|
||||||
|
ambiguity:
|
||||||
|
delayMin: -10
|
||||||
|
delayMax: 300
|
||||||
|
dopplerMin: -300
|
||||||
|
dopplerMax: 300
|
||||||
|
clutter:
|
||||||
|
delayMin: -10
|
||||||
|
delayMax: 300
|
||||||
|
detect:
|
||||||
|
pfa: 0.000001
|
||||||
|
nGuard: 10
|
||||||
|
nTrain: 20
|
||||||
|
|
||||||
|
network:
|
||||||
|
ip: 0.0.0.0
|
||||||
|
ports:
|
||||||
|
api: 3000
|
||||||
|
map: 3001
|
||||||
|
detect: 3002
|
||||||
|
|
||||||
|
save:
|
||||||
|
iq: true
|
||||||
|
map: true
|
||||||
|
detect: false
|
||||||
|
path: "/opt/blah2/"
|
42
docker-compose.yml
Normal file
42
docker-compose.yml
Normal file
|
@ -0,0 +1,42 @@
|
||||||
|
version: '3'
|
||||||
|
|
||||||
|
networks:
|
||||||
|
nginx-web:
|
||||||
|
external: true
|
||||||
|
|
||||||
|
services:
|
||||||
|
|
||||||
|
blah2:
|
||||||
|
restart: always
|
||||||
|
build:
|
||||||
|
context: .
|
||||||
|
dockerfile: Dockerfile
|
||||||
|
volumes:
|
||||||
|
- /dev/bus/usb:/dev/bus/usb
|
||||||
|
- /run/systemd/system:/run/systemd/system
|
||||||
|
- /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket
|
||||||
|
- ~/blah2/replay:/blah2/replay
|
||||||
|
- ./config:/blah2/config
|
||||||
|
network_mode: host
|
||||||
|
privileged: true
|
||||||
|
command: /blah2/bin/blah2 -c config/config.yml
|
||||||
|
container_name: blah2
|
||||||
|
|
||||||
|
blah2_frontend:
|
||||||
|
restart: always
|
||||||
|
image: httpd:2.4
|
||||||
|
ports:
|
||||||
|
- 49152:80
|
||||||
|
volumes:
|
||||||
|
- ./html:/usr/local/apache2/htdocs
|
||||||
|
networks:
|
||||||
|
- nginx-web
|
||||||
|
container_name: blah2-web
|
||||||
|
|
||||||
|
blah2_api:
|
||||||
|
restart: always
|
||||||
|
build: ./api
|
||||||
|
ports:
|
||||||
|
- 3000:8080
|
||||||
|
network_mode: host
|
||||||
|
container_name: blah2-api
|
BIN
example.png
Normal file
BIN
example.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 269 KiB |
22
html/control.js
Normal file
22
html/control.js
Normal file
|
@ -0,0 +1,22 @@
|
||||||
|
var host = window.location.hostname;
|
||||||
|
|
||||||
|
$(document).on('keypress', function (e) {
|
||||||
|
if (e.which == 32) {
|
||||||
|
url = "/capture/toggle";
|
||||||
|
|
||||||
|
$.getJSON('http://' + host + ':3000/capture/toggle', function () { })
|
||||||
|
|
||||||
|
.done(function (data) {
|
||||||
|
console.log('API worked');
|
||||||
|
})
|
||||||
|
|
||||||
|
.fail(function () {
|
||||||
|
console.log('API Fail');
|
||||||
|
})
|
||||||
|
|
||||||
|
.always(function () {
|
||||||
|
|
||||||
|
});
|
||||||
|
|
||||||
|
}
|
||||||
|
});
|
96
html/index.html
Normal file
96
html/index.html
Normal file
|
@ -0,0 +1,96 @@
|
||||||
|
<!DOCTYPE html>
|
||||||
|
|
||||||
|
<html>
|
||||||
|
|
||||||
|
<head>
|
||||||
|
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||||
|
<meta charset="UTF-8">
|
||||||
|
|
||||||
|
<title>blah2</title>
|
||||||
|
|
||||||
|
<!-- load lib js -->
|
||||||
|
<script src="lib/bootstrap-5.2.3.min.js"></script>
|
||||||
|
<script src="lib/plotly-2.20.0.min.js"></script>
|
||||||
|
<script src="lib/jquery-3.6.4.min.js"></script>
|
||||||
|
|
||||||
|
<!-- load lib css -->
|
||||||
|
<link rel="stylesheet" href="lib/bootstrap-5.2.3.min.css">
|
||||||
|
|
||||||
|
<style>
|
||||||
|
h1 {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-weight: bold;
|
||||||
|
font-size: 3.5rem !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
.menu {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-size: 1.5rem;
|
||||||
|
font-weight: bold;
|
||||||
|
}
|
||||||
|
|
||||||
|
.title {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-size: 1.5rem;
|
||||||
|
font-weight: bold;
|
||||||
|
text-decoration: underline;
|
||||||
|
}
|
||||||
|
|
||||||
|
.label {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-size: 1rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (min-width: 768px) {
|
||||||
|
h1 {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-weight: bold;
|
||||||
|
font-size: 5rem !important;
|
||||||
|
}
|
||||||
|
|
||||||
|
.menu {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-size: 2rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.title {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-size: 2.5rem;
|
||||||
|
font-weight: bold;
|
||||||
|
text-decoration: underline;
|
||||||
|
}
|
||||||
|
|
||||||
|
.label {
|
||||||
|
font-family: 'Helvetica', sans-serif !important;
|
||||||
|
font-size: 2rem;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
.navbar-nav {
|
||||||
|
flex-wrap: wrap;
|
||||||
|
}
|
||||||
|
|
||||||
|
div.plotly-notifier {
|
||||||
|
visibility: hidden;
|
||||||
|
}
|
||||||
|
</style>
|
||||||
|
|
||||||
|
</head>
|
||||||
|
|
||||||
|
<body style="background-color:#f78c58;">
|
||||||
|
|
||||||
|
<div style="height: 100vh; width: 90vw" class="container-fluid">
|
||||||
|
|
||||||
|
<div style="height: 100vh; width: 90vw" class="row d-flex">
|
||||||
|
|
||||||
|
<div class="justify-content-center" id="ddmap"></div>
|
||||||
|
|
||||||
|
</div>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
|
||||||
|
<script src="plot.js"></script>
|
||||||
|
<script src="control.js"></script>
|
||||||
|
|
||||||
|
</html>
|
6
html/lib/bootstrap-5.2.3.min.css
vendored
Normal file
6
html/lib/bootstrap-5.2.3.min.css
vendored
Normal file
File diff suppressed because one or more lines are too long
6
html/lib/bootstrap-5.2.3.min.js
vendored
Normal file
6
html/lib/bootstrap-5.2.3.min.js
vendored
Normal file
File diff suppressed because one or more lines are too long
2
html/lib/jquery-3.6.4.min.js
vendored
Normal file
2
html/lib/jquery-3.6.4.min.js
vendored
Normal file
File diff suppressed because one or more lines are too long
8
html/lib/plotly-2.20.0.min.js
vendored
Normal file
8
html/lib/plotly-2.20.0.min.js
vendored
Normal file
File diff suppressed because one or more lines are too long
121
html/plot.js
Normal file
121
html/plot.js
Normal file
|
@ -0,0 +1,121 @@
|
||||||
|
var timestamp = -1;
|
||||||
|
var nRows = 3;
|
||||||
|
var nCols = 3;
|
||||||
|
var host = window.location.hostname;
|
||||||
|
|
||||||
|
var data = [
|
||||||
|
{
|
||||||
|
z: [[0, 0, 0], [0, 0, 0], [0, 0, 0]],
|
||||||
|
colorscale: 'Jet',
|
||||||
|
type: 'heatmap'
|
||||||
|
}
|
||||||
|
];
|
||||||
|
|
||||||
|
var layout = {
|
||||||
|
autosize: false,
|
||||||
|
margin: {
|
||||||
|
l: 50,
|
||||||
|
r: 50,
|
||||||
|
b: 50,
|
||||||
|
t: 50,
|
||||||
|
pad: 0
|
||||||
|
},
|
||||||
|
width: document.getElementById('ddmap').offsetWidth,
|
||||||
|
height: document.getElementById('ddmap').offsetHeight,
|
||||||
|
plot_bgcolor: "rgba(0,0,0,0)",
|
||||||
|
paper_bgcolor: "rgba(0,0,0,0)",
|
||||||
|
annotations: [],
|
||||||
|
coloraxis: {
|
||||||
|
cmin: 0,
|
||||||
|
cmax: 1
|
||||||
|
},
|
||||||
|
displayModeBar: false,
|
||||||
|
xaxis: {
|
||||||
|
ticks: '',
|
||||||
|
side: 'bottom'
|
||||||
|
},
|
||||||
|
yaxis: {
|
||||||
|
ticks: '',
|
||||||
|
ticksuffix: ' ',
|
||||||
|
autosize: false
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
var config = {
|
||||||
|
displayModeBar: false,
|
||||||
|
responsive: true
|
||||||
|
}
|
||||||
|
|
||||||
|
Plotly.newPlot('ddmap', data, layout, config);
|
||||||
|
|
||||||
|
var intervalId = window.setInterval(function () {
|
||||||
|
var apiData = $.getJSON('http://' + host + ':3000/map', function () { })
|
||||||
|
|
||||||
|
.done(function (data) {
|
||||||
|
|
||||||
|
// case draw new plot
|
||||||
|
if (data.nRows != nRows || data.nCols != nCols) {
|
||||||
|
nRows = data.nRows;
|
||||||
|
nCols = data.nCols;
|
||||||
|
|
||||||
|
data = [
|
||||||
|
{
|
||||||
|
z: data.data,
|
||||||
|
x: data.delay,
|
||||||
|
y: data.doppler,
|
||||||
|
colorscale: 'Jet',
|
||||||
|
zauto: false,
|
||||||
|
zmin: 0,
|
||||||
|
zmax: Math.max(13, data.maxPower),
|
||||||
|
type: 'heatmap'
|
||||||
|
}
|
||||||
|
];
|
||||||
|
layout = {
|
||||||
|
autosize: false,
|
||||||
|
margin: {
|
||||||
|
l: 50,
|
||||||
|
r: 50,
|
||||||
|
b: 50,
|
||||||
|
t: 50,
|
||||||
|
pad: 0
|
||||||
|
},
|
||||||
|
width: document.getElementById('ddmap').offsetWidth,
|
||||||
|
height: document.getElementById('ddmap').offsetHeight,
|
||||||
|
plot_bgcolor: "rgba(0,0,0,0)",
|
||||||
|
paper_bgcolor: "rgba(0,0,0,0)",
|
||||||
|
annotations: [],
|
||||||
|
displayModeBar: false,
|
||||||
|
xaxis: {
|
||||||
|
ticks: '',
|
||||||
|
side: 'bottom'
|
||||||
|
},
|
||||||
|
yaxis: {
|
||||||
|
ticks: '',
|
||||||
|
ticksuffix: ' ',
|
||||||
|
autosize: false,
|
||||||
|
categoryorder: "total descending"
|
||||||
|
}
|
||||||
|
};
|
||||||
|
Plotly.newPlot('ddmap', data, layout, { displayModeBar: false });
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
data_update =
|
||||||
|
{
|
||||||
|
'z': [data.data],
|
||||||
|
'zmax': Math.max(13, data.maxPower)
|
||||||
|
};
|
||||||
|
layout_update = {
|
||||||
|
};
|
||||||
|
Plotly.update('ddmap', data_update, layout_update, { displayModeBar: false });
|
||||||
|
}
|
||||||
|
|
||||||
|
})
|
||||||
|
|
||||||
|
.fail(function () {
|
||||||
|
console.log('API Fail');
|
||||||
|
})
|
||||||
|
|
||||||
|
.always(function () {
|
||||||
|
|
||||||
|
});
|
||||||
|
}, 100);
|
BIN
lib/armadillo-12.0.1.tar.xz
Normal file
BIN
lib/armadillo-12.0.1.tar.xz
Normal file
Binary file not shown.
212
lib/asio-1.26.0/asio.hpp
Normal file
212
lib/asio-1.26.0/asio.hpp
Normal file
|
@ -0,0 +1,212 @@
|
||||||
|
//
|
||||||
|
// asio.hpp
|
||||||
|
// ~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_HPP
|
||||||
|
#define ASIO_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/any_completion_executor.hpp"
|
||||||
|
#include "asio/any_completion_handler.hpp"
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/append.hpp"
|
||||||
|
#include "asio/as_tuple.hpp"
|
||||||
|
#include "asio/associated_allocator.hpp"
|
||||||
|
#include "asio/associated_executor.hpp"
|
||||||
|
#include "asio/associated_cancellation_slot.hpp"
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/awaitable.hpp"
|
||||||
|
#include "asio/basic_datagram_socket.hpp"
|
||||||
|
#include "asio/basic_deadline_timer.hpp"
|
||||||
|
#include "asio/basic_file.hpp"
|
||||||
|
#include "asio/basic_io_object.hpp"
|
||||||
|
#include "asio/basic_random_access_file.hpp"
|
||||||
|
#include "asio/basic_raw_socket.hpp"
|
||||||
|
#include "asio/basic_readable_pipe.hpp"
|
||||||
|
#include "asio/basic_seq_packet_socket.hpp"
|
||||||
|
#include "asio/basic_serial_port.hpp"
|
||||||
|
#include "asio/basic_signal_set.hpp"
|
||||||
|
#include "asio/basic_socket.hpp"
|
||||||
|
#include "asio/basic_socket_acceptor.hpp"
|
||||||
|
#include "asio/basic_socket_iostream.hpp"
|
||||||
|
#include "asio/basic_socket_streambuf.hpp"
|
||||||
|
#include "asio/basic_stream_file.hpp"
|
||||||
|
#include "asio/basic_stream_socket.hpp"
|
||||||
|
#include "asio/basic_streambuf.hpp"
|
||||||
|
#include "asio/basic_waitable_timer.hpp"
|
||||||
|
#include "asio/basic_writable_pipe.hpp"
|
||||||
|
#include "asio/bind_allocator.hpp"
|
||||||
|
#include "asio/bind_cancellation_slot.hpp"
|
||||||
|
#include "asio/bind_executor.hpp"
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/buffer_registration.hpp"
|
||||||
|
#include "asio/buffered_read_stream_fwd.hpp"
|
||||||
|
#include "asio/buffered_read_stream.hpp"
|
||||||
|
#include "asio/buffered_stream_fwd.hpp"
|
||||||
|
#include "asio/buffered_stream.hpp"
|
||||||
|
#include "asio/buffered_write_stream_fwd.hpp"
|
||||||
|
#include "asio/buffered_write_stream.hpp"
|
||||||
|
#include "asio/buffers_iterator.hpp"
|
||||||
|
#include "asio/cancellation_signal.hpp"
|
||||||
|
#include "asio/cancellation_state.hpp"
|
||||||
|
#include "asio/cancellation_type.hpp"
|
||||||
|
#include "asio/co_spawn.hpp"
|
||||||
|
#include "asio/completion_condition.hpp"
|
||||||
|
#include "asio/compose.hpp"
|
||||||
|
#include "asio/connect.hpp"
|
||||||
|
#include "asio/connect_pipe.hpp"
|
||||||
|
#include "asio/consign.hpp"
|
||||||
|
#include "asio/coroutine.hpp"
|
||||||
|
#include "asio/deadline_timer.hpp"
|
||||||
|
#include "asio/defer.hpp"
|
||||||
|
#include "asio/deferred.hpp"
|
||||||
|
#include "asio/detached.hpp"
|
||||||
|
#include "asio/dispatch.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/error_code.hpp"
|
||||||
|
#include "asio/execution.hpp"
|
||||||
|
#include "asio/execution/allocator.hpp"
|
||||||
|
#include "asio/execution/any_executor.hpp"
|
||||||
|
#include "asio/execution/blocking.hpp"
|
||||||
|
#include "asio/execution/blocking_adaptation.hpp"
|
||||||
|
#include "asio/execution/bulk_execute.hpp"
|
||||||
|
#include "asio/execution/bulk_guarantee.hpp"
|
||||||
|
#include "asio/execution/connect.hpp"
|
||||||
|
#include "asio/execution/context.hpp"
|
||||||
|
#include "asio/execution/context_as.hpp"
|
||||||
|
#include "asio/execution/execute.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/execution/invocable_archetype.hpp"
|
||||||
|
#include "asio/execution/mapping.hpp"
|
||||||
|
#include "asio/execution/occupancy.hpp"
|
||||||
|
#include "asio/execution/operation_state.hpp"
|
||||||
|
#include "asio/execution/outstanding_work.hpp"
|
||||||
|
#include "asio/execution/prefer_only.hpp"
|
||||||
|
#include "asio/execution/receiver.hpp"
|
||||||
|
#include "asio/execution/receiver_invocation_error.hpp"
|
||||||
|
#include "asio/execution/relationship.hpp"
|
||||||
|
#include "asio/execution/schedule.hpp"
|
||||||
|
#include "asio/execution/scheduler.hpp"
|
||||||
|
#include "asio/execution/sender.hpp"
|
||||||
|
#include "asio/execution/set_done.hpp"
|
||||||
|
#include "asio/execution/set_error.hpp"
|
||||||
|
#include "asio/execution/set_value.hpp"
|
||||||
|
#include "asio/execution/start.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/executor.hpp"
|
||||||
|
#include "asio/executor_work_guard.hpp"
|
||||||
|
#include "asio/file_base.hpp"
|
||||||
|
#include "asio/generic/basic_endpoint.hpp"
|
||||||
|
#include "asio/generic/datagram_protocol.hpp"
|
||||||
|
#include "asio/generic/raw_protocol.hpp"
|
||||||
|
#include "asio/generic/seq_packet_protocol.hpp"
|
||||||
|
#include "asio/generic/stream_protocol.hpp"
|
||||||
|
#include "asio/handler_alloc_hook.hpp"
|
||||||
|
#include "asio/handler_continuation_hook.hpp"
|
||||||
|
#include "asio/handler_invoke_hook.hpp"
|
||||||
|
#include "asio/high_resolution_timer.hpp"
|
||||||
|
#include "asio/io_context.hpp"
|
||||||
|
#include "asio/io_context_strand.hpp"
|
||||||
|
#include "asio/io_service.hpp"
|
||||||
|
#include "asio/io_service_strand.hpp"
|
||||||
|
#include "asio/ip/address.hpp"
|
||||||
|
#include "asio/ip/address_v4.hpp"
|
||||||
|
#include "asio/ip/address_v4_iterator.hpp"
|
||||||
|
#include "asio/ip/address_v4_range.hpp"
|
||||||
|
#include "asio/ip/address_v6.hpp"
|
||||||
|
#include "asio/ip/address_v6_iterator.hpp"
|
||||||
|
#include "asio/ip/address_v6_range.hpp"
|
||||||
|
#include "asio/ip/network_v4.hpp"
|
||||||
|
#include "asio/ip/network_v6.hpp"
|
||||||
|
#include "asio/ip/bad_address_cast.hpp"
|
||||||
|
#include "asio/ip/basic_endpoint.hpp"
|
||||||
|
#include "asio/ip/basic_resolver.hpp"
|
||||||
|
#include "asio/ip/basic_resolver_entry.hpp"
|
||||||
|
#include "asio/ip/basic_resolver_iterator.hpp"
|
||||||
|
#include "asio/ip/basic_resolver_query.hpp"
|
||||||
|
#include "asio/ip/host_name.hpp"
|
||||||
|
#include "asio/ip/icmp.hpp"
|
||||||
|
#include "asio/ip/multicast.hpp"
|
||||||
|
#include "asio/ip/resolver_base.hpp"
|
||||||
|
#include "asio/ip/resolver_query_base.hpp"
|
||||||
|
#include "asio/ip/tcp.hpp"
|
||||||
|
#include "asio/ip/udp.hpp"
|
||||||
|
#include "asio/ip/unicast.hpp"
|
||||||
|
#include "asio/ip/v6_only.hpp"
|
||||||
|
#include "asio/is_applicable_property.hpp"
|
||||||
|
#include "asio/is_contiguous_iterator.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
#include "asio/is_read_buffered.hpp"
|
||||||
|
#include "asio/is_write_buffered.hpp"
|
||||||
|
#include "asio/local/basic_endpoint.hpp"
|
||||||
|
#include "asio/local/connect_pair.hpp"
|
||||||
|
#include "asio/local/datagram_protocol.hpp"
|
||||||
|
#include "asio/local/stream_protocol.hpp"
|
||||||
|
#include "asio/multiple_exceptions.hpp"
|
||||||
|
#include "asio/packaged_task.hpp"
|
||||||
|
#include "asio/placeholders.hpp"
|
||||||
|
#include "asio/posix/basic_descriptor.hpp"
|
||||||
|
#include "asio/posix/basic_stream_descriptor.hpp"
|
||||||
|
#include "asio/posix/descriptor.hpp"
|
||||||
|
#include "asio/posix/descriptor_base.hpp"
|
||||||
|
#include "asio/posix/stream_descriptor.hpp"
|
||||||
|
#include "asio/post.hpp"
|
||||||
|
#include "asio/prefer.hpp"
|
||||||
|
#include "asio/prepend.hpp"
|
||||||
|
#include "asio/query.hpp"
|
||||||
|
#include "asio/random_access_file.hpp"
|
||||||
|
#include "asio/read.hpp"
|
||||||
|
#include "asio/read_at.hpp"
|
||||||
|
#include "asio/read_until.hpp"
|
||||||
|
#include "asio/readable_pipe.hpp"
|
||||||
|
#include "asio/recycling_allocator.hpp"
|
||||||
|
#include "asio/redirect_error.hpp"
|
||||||
|
#include "asio/registered_buffer.hpp"
|
||||||
|
#include "asio/require.hpp"
|
||||||
|
#include "asio/require_concept.hpp"
|
||||||
|
#include "asio/serial_port.hpp"
|
||||||
|
#include "asio/serial_port_base.hpp"
|
||||||
|
#include "asio/signal_set.hpp"
|
||||||
|
#include "asio/socket_base.hpp"
|
||||||
|
#include "asio/static_thread_pool.hpp"
|
||||||
|
#include "asio/steady_timer.hpp"
|
||||||
|
#include "asio/strand.hpp"
|
||||||
|
#include "asio/stream_file.hpp"
|
||||||
|
#include "asio/streambuf.hpp"
|
||||||
|
#include "asio/system_context.hpp"
|
||||||
|
#include "asio/system_error.hpp"
|
||||||
|
#include "asio/system_executor.hpp"
|
||||||
|
#include "asio/system_timer.hpp"
|
||||||
|
#include "asio/this_coro.hpp"
|
||||||
|
#include "asio/thread.hpp"
|
||||||
|
#include "asio/thread_pool.hpp"
|
||||||
|
#include "asio/time_traits.hpp"
|
||||||
|
#include "asio/use_awaitable.hpp"
|
||||||
|
#include "asio/use_future.hpp"
|
||||||
|
#include "asio/uses_executor.hpp"
|
||||||
|
#include "asio/version.hpp"
|
||||||
|
#include "asio/wait_traits.hpp"
|
||||||
|
#include "asio/windows/basic_object_handle.hpp"
|
||||||
|
#include "asio/windows/basic_overlapped_handle.hpp"
|
||||||
|
#include "asio/windows/basic_random_access_handle.hpp"
|
||||||
|
#include "asio/windows/basic_stream_handle.hpp"
|
||||||
|
#include "asio/windows/object_handle.hpp"
|
||||||
|
#include "asio/windows/overlapped_handle.hpp"
|
||||||
|
#include "asio/windows/overlapped_ptr.hpp"
|
||||||
|
#include "asio/windows/random_access_handle.hpp"
|
||||||
|
#include "asio/windows/stream_handle.hpp"
|
||||||
|
#include "asio/writable_pipe.hpp"
|
||||||
|
#include "asio/write.hpp"
|
||||||
|
#include "asio/write_at.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_HPP
|
342
lib/asio-1.26.0/asio/any_completion_executor.hpp
Normal file
342
lib/asio-1.26.0/asio/any_completion_executor.hpp
Normal file
|
@ -0,0 +1,342 @@
|
||||||
|
//
|
||||||
|
// any_completion_executor.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ANY_COMPLETION_EXECUTOR_HPP
|
||||||
|
#define ASIO_ANY_COMPLETION_EXECUTOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#if defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
# include "asio/executor.hpp"
|
||||||
|
#else // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
# include "asio/execution.hpp"
|
||||||
|
#endif // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
typedef executor any_completion_executor;
|
||||||
|
|
||||||
|
#else // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
/// Polymorphic executor type for use with I/O objects.
|
||||||
|
/**
|
||||||
|
* The @c any_completion_executor type is a polymorphic executor that supports
|
||||||
|
* the set of properties required for the execution of completion handlers. It
|
||||||
|
* is defined as the execution::any_executor class template parameterised as
|
||||||
|
* follows:
|
||||||
|
* @code execution::any_executor<
|
||||||
|
* execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
* execution::prefer_only<execution::outstanding_work_t::untracked_t>
|
||||||
|
* execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
* execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
* > @endcode
|
||||||
|
*/
|
||||||
|
class any_completion_executor :
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
public execution::any_executor<...>
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
public execution::any_executor<
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
>
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef execution::any_executor<
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
> base_type;
|
||||||
|
|
||||||
|
typedef void supportable_properties_type(
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
);
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Default constructor.
|
||||||
|
ASIO_DECL any_completion_executor() ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// Construct in an empty state. Equivalent effects to default constructor.
|
||||||
|
ASIO_DECL any_completion_executor(nullptr_t) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// Copy constructor.
|
||||||
|
ASIO_DECL any_completion_executor(
|
||||||
|
const any_completion_executor& e) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move constructor.
|
||||||
|
ASIO_DECL any_completion_executor(
|
||||||
|
any_completion_executor&& e) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <class... OtherSupportableProperties>
|
||||||
|
any_completion_executor(
|
||||||
|
execution::any_executor<OtherSupportableProperties...> e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename OtherAnyExecutor>
|
||||||
|
any_completion_executor(OtherAnyExecutor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<OtherAnyExecutor, any_completion_executor>::value
|
||||||
|
&& is_base_of<execution::detail::any_executor_base,
|
||||||
|
OtherAnyExecutor>::value,
|
||||||
|
typename execution::detail::supportable_properties<
|
||||||
|
0, supportable_properties_type>::template
|
||||||
|
is_valid_target<OtherAnyExecutor>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0)
|
||||||
|
: base_type(ASIO_MOVE_CAST(OtherAnyExecutor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <class... OtherSupportableProperties>
|
||||||
|
any_completion_executor(std::nothrow_t,
|
||||||
|
execution::any_executor<OtherSupportableProperties...> e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename OtherAnyExecutor>
|
||||||
|
any_completion_executor(std::nothrow_t, OtherAnyExecutor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<OtherAnyExecutor, any_completion_executor>::value
|
||||||
|
&& is_base_of<execution::detail::any_executor_base,
|
||||||
|
OtherAnyExecutor>::value,
|
||||||
|
typename execution::detail::supportable_properties<
|
||||||
|
0, supportable_properties_type>::template
|
||||||
|
is_valid_target<OtherAnyExecutor>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: base_type(std::nothrow, ASIO_MOVE_CAST(OtherAnyExecutor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
ASIO_DECL any_completion_executor(std::nothrow_t,
|
||||||
|
const any_completion_executor& e) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
ASIO_DECL any_completion_executor(std::nothrow_t,
|
||||||
|
any_completion_executor&& e) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct a polymorphic wrapper for the specified executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_completion_executor(Executor e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_completion_executor(Executor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<Executor, any_completion_executor>::value
|
||||||
|
&& !is_base_of<execution::detail::any_executor_base,
|
||||||
|
Executor>::value,
|
||||||
|
execution::detail::is_valid_target_executor<
|
||||||
|
Executor, supportable_properties_type>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0)
|
||||||
|
: base_type(ASIO_MOVE_CAST(Executor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct a polymorphic wrapper for the specified executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_completion_executor(std::nothrow_t, Executor e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_completion_executor(std::nothrow_t, Executor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<Executor, any_completion_executor>::value
|
||||||
|
&& !is_base_of<execution::detail::any_executor_base,
|
||||||
|
Executor>::value,
|
||||||
|
execution::detail::is_valid_target_executor<
|
||||||
|
Executor, supportable_properties_type>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: base_type(std::nothrow, ASIO_MOVE_CAST(Executor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Assignment operator.
|
||||||
|
ASIO_DECL any_completion_executor& operator=(
|
||||||
|
const any_completion_executor& e) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move assignment operator.
|
||||||
|
ASIO_DECL any_completion_executor& operator=(
|
||||||
|
any_completion_executor&& e) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Assignment operator that sets the polymorphic wrapper to the empty state.
|
||||||
|
ASIO_DECL any_completion_executor& operator=(nullptr_t);
|
||||||
|
|
||||||
|
/// Destructor.
|
||||||
|
ASIO_DECL ~any_completion_executor();
|
||||||
|
|
||||||
|
/// Swap targets with another polymorphic wrapper.
|
||||||
|
ASIO_DECL void swap(any_completion_executor& other) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// Obtain a polymorphic wrapper with the specified property.
|
||||||
|
/**
|
||||||
|
* Do not call this function directly. It is intended for use with the
|
||||||
|
* asio::require and asio::prefer customisation points.
|
||||||
|
*
|
||||||
|
* For example:
|
||||||
|
* @code any_completion_executor ex = ...;
|
||||||
|
* auto ex2 = asio::require(ex, execution::relationship.fork); @endcode
|
||||||
|
*/
|
||||||
|
template <typename Property>
|
||||||
|
any_completion_executor require(const Property& p,
|
||||||
|
typename constraint<
|
||||||
|
traits::require_member<const base_type&, const Property&>::is_valid
|
||||||
|
>::type = 0) const
|
||||||
|
{
|
||||||
|
return static_cast<const base_type&>(*this).require(p);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a polymorphic wrapper with the specified property.
|
||||||
|
/**
|
||||||
|
* Do not call this function directly. It is intended for use with the
|
||||||
|
* asio::prefer customisation point.
|
||||||
|
*
|
||||||
|
* For example:
|
||||||
|
* @code any_completion_executor ex = ...;
|
||||||
|
* auto ex2 = asio::prefer(ex, execution::relationship.fork); @endcode
|
||||||
|
*/
|
||||||
|
template <typename Property>
|
||||||
|
any_completion_executor prefer(const Property& p,
|
||||||
|
typename constraint<
|
||||||
|
traits::prefer_member<const base_type&, const Property&>::is_valid
|
||||||
|
>::type = 0) const
|
||||||
|
{
|
||||||
|
return static_cast<const base_type&>(*this).prefer(p);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_completion_executor any_completion_executor::prefer(
|
||||||
|
const execution::outstanding_work_t::tracked_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_completion_executor any_completion_executor::prefer(
|
||||||
|
const execution::outstanding_work_t::untracked_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_completion_executor any_completion_executor::prefer(
|
||||||
|
const execution::relationship_t::fork_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_completion_executor any_completion_executor::prefer(
|
||||||
|
const execution::relationship_t::continuation_t&, int) const;
|
||||||
|
|
||||||
|
namespace traits {
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_EQUALITY_COMPARABLE_TRAIT)
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct equality_comparable<any_completion_executor>
|
||||||
|
{
|
||||||
|
static const bool is_valid = true;
|
||||||
|
static const bool is_noexcept = true;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_EQUALITY_COMPARABLE_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_EXECUTE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename F>
|
||||||
|
struct execute_member<any_completion_executor, F>
|
||||||
|
{
|
||||||
|
static const bool is_valid = true;
|
||||||
|
static const bool is_noexcept = false;
|
||||||
|
typedef void result_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_EXECUTE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename Prop>
|
||||||
|
struct query_member<any_completion_executor, Prop> :
|
||||||
|
query_member<any_completion_executor::base_type, Prop>
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename Prop>
|
||||||
|
struct require_member<any_completion_executor, Prop> :
|
||||||
|
require_member<any_completion_executor::base_type, Prop>
|
||||||
|
{
|
||||||
|
typedef any_completion_executor result_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename Prop>
|
||||||
|
struct prefer_member<any_completion_executor, Prop> :
|
||||||
|
prefer_member<any_completion_executor::base_type, Prop>
|
||||||
|
{
|
||||||
|
typedef any_completion_executor result_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
} // namespace traits
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HEADER_ONLY) \
|
||||||
|
&& !defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
# include "asio/impl/any_completion_executor.ipp"
|
||||||
|
#endif // defined(ASIO_HEADER_ONLY)
|
||||||
|
// && !defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
#endif // ASIO_ANY_COMPLETION_EXECUTOR_HPP
|
684
lib/asio-1.26.0/asio/any_completion_handler.hpp
Normal file
684
lib/asio-1.26.0/asio/any_completion_handler.hpp
Normal file
|
@ -0,0 +1,684 @@
|
||||||
|
//
|
||||||
|
// any_completion_handler.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ANY_COMPLETION_HANDLER_HPP
|
||||||
|
#define ASIO_ANY_COMPLETION_HANDLER_HPP
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if (defined(ASIO_HAS_STD_TUPLE) \
|
||||||
|
&& defined(ASIO_HAS_MOVE) \
|
||||||
|
&& defined(ASIO_HAS_VARIADIC_TEMPLATES)) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <cstring>
|
||||||
|
#include <functional>
|
||||||
|
#include <memory>
|
||||||
|
#include <utility>
|
||||||
|
#include "asio/any_completion_executor.hpp"
|
||||||
|
#include "asio/associated_allocator.hpp"
|
||||||
|
#include "asio/associated_cancellation_slot.hpp"
|
||||||
|
#include "asio/associated_executor.hpp"
|
||||||
|
#include "asio/cancellation_state.hpp"
|
||||||
|
#include "asio/recycling_allocator.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class any_completion_handler_impl_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename S>
|
||||||
|
explicit any_completion_handler_impl_base(S&& slot)
|
||||||
|
: cancel_state_(ASIO_MOVE_CAST(S)(slot), enable_total_cancellation())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
cancellation_slot get_cancellation_slot() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancel_state_.slot();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
cancellation_state cancel_state_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
class any_completion_handler_impl :
|
||||||
|
public any_completion_handler_impl_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename S, typename H>
|
||||||
|
any_completion_handler_impl(S&& slot, H&& h)
|
||||||
|
: any_completion_handler_impl_base(ASIO_MOVE_CAST(S)(slot)),
|
||||||
|
handler_(ASIO_MOVE_CAST(H)(h))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
struct uninit_deleter
|
||||||
|
{
|
||||||
|
typename std::allocator_traits<
|
||||||
|
associated_allocator_t<Handler,
|
||||||
|
asio::recycling_allocator<void>>>::template
|
||||||
|
rebind_alloc<any_completion_handler_impl> alloc;
|
||||||
|
|
||||||
|
void operator()(any_completion_handler_impl* ptr)
|
||||||
|
{
|
||||||
|
std::allocator_traits<decltype(alloc)>::deallocate(alloc, ptr, 1);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
struct deleter
|
||||||
|
{
|
||||||
|
typename std::allocator_traits<
|
||||||
|
associated_allocator_t<Handler,
|
||||||
|
asio::recycling_allocator<void>>>::template
|
||||||
|
rebind_alloc<any_completion_handler_impl> alloc;
|
||||||
|
|
||||||
|
void operator()(any_completion_handler_impl* ptr)
|
||||||
|
{
|
||||||
|
std::allocator_traits<decltype(alloc)>::destroy(alloc, ptr);
|
||||||
|
std::allocator_traits<decltype(alloc)>::deallocate(alloc, ptr, 1);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename S, typename H>
|
||||||
|
static any_completion_handler_impl* create(S&& slot, H&& h)
|
||||||
|
{
|
||||||
|
uninit_deleter d{
|
||||||
|
(get_associated_allocator)(h,
|
||||||
|
asio::recycling_allocator<void>())};
|
||||||
|
|
||||||
|
std::unique_ptr<any_completion_handler_impl, uninit_deleter> uninit_ptr(
|
||||||
|
std::allocator_traits<decltype(d.alloc)>::allocate(d.alloc, 1), d);
|
||||||
|
|
||||||
|
any_completion_handler_impl* ptr =
|
||||||
|
new (uninit_ptr.get()) any_completion_handler_impl(
|
||||||
|
ASIO_MOVE_CAST(S)(slot), ASIO_MOVE_CAST(H)(h));
|
||||||
|
|
||||||
|
uninit_ptr.release();
|
||||||
|
return ptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
void destroy()
|
||||||
|
{
|
||||||
|
deleter d{
|
||||||
|
(get_associated_allocator)(handler_,
|
||||||
|
asio::recycling_allocator<void>())};
|
||||||
|
|
||||||
|
d(this);
|
||||||
|
}
|
||||||
|
|
||||||
|
any_completion_executor executor(
|
||||||
|
const any_completion_executor& candidate) const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return any_completion_executor(std::nothrow,
|
||||||
|
(get_associated_executor)(handler_, candidate));
|
||||||
|
}
|
||||||
|
|
||||||
|
void* allocate(std::size_t size, std::size_t align) const
|
||||||
|
{
|
||||||
|
typename std::allocator_traits<
|
||||||
|
associated_allocator_t<Handler,
|
||||||
|
asio::recycling_allocator<void>>>::template
|
||||||
|
rebind_alloc<unsigned char> alloc(
|
||||||
|
(get_associated_allocator)(handler_,
|
||||||
|
asio::recycling_allocator<void>()));
|
||||||
|
|
||||||
|
std::size_t space = size + align - 1;
|
||||||
|
unsigned char* base =
|
||||||
|
std::allocator_traits<decltype(alloc)>::allocate(
|
||||||
|
alloc, space + sizeof(std::ptrdiff_t));
|
||||||
|
|
||||||
|
void* p = base;
|
||||||
|
if (detail::align(align, size, p, space))
|
||||||
|
{
|
||||||
|
std::ptrdiff_t off = static_cast<unsigned char*>(p) - base;
|
||||||
|
std::memcpy(static_cast<unsigned char*>(p) + size, &off, sizeof(off));
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::bad_alloc ex;
|
||||||
|
asio::detail::throw_exception(ex);
|
||||||
|
return nullptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
void deallocate(void* p, std::size_t size, std::size_t align) const
|
||||||
|
{
|
||||||
|
if (p)
|
||||||
|
{
|
||||||
|
typename std::allocator_traits<
|
||||||
|
associated_allocator_t<Handler,
|
||||||
|
asio::recycling_allocator<void>>>::template
|
||||||
|
rebind_alloc<unsigned char> alloc(
|
||||||
|
(get_associated_allocator)(handler_,
|
||||||
|
asio::recycling_allocator<void>()));
|
||||||
|
|
||||||
|
std::ptrdiff_t off;
|
||||||
|
std::memcpy(&off, static_cast<unsigned char*>(p) + size, sizeof(off));
|
||||||
|
unsigned char* base = static_cast<unsigned char*>(p) - off;
|
||||||
|
|
||||||
|
std::allocator_traits<decltype(alloc)>::deallocate(
|
||||||
|
alloc, base, size + align -1 + sizeof(std::ptrdiff_t));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename... Args>
|
||||||
|
void call(Args&&... args)
|
||||||
|
{
|
||||||
|
deleter d{
|
||||||
|
(get_associated_allocator)(handler_,
|
||||||
|
asio::recycling_allocator<void>())};
|
||||||
|
|
||||||
|
std::unique_ptr<any_completion_handler_impl, deleter> ptr(this, d);
|
||||||
|
Handler handler(ASIO_MOVE_CAST(Handler)(handler_));
|
||||||
|
ptr.reset();
|
||||||
|
|
||||||
|
ASIO_MOVE_CAST(Handler)(handler)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
Handler handler_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Signature>
|
||||||
|
class any_completion_handler_call_fn;
|
||||||
|
|
||||||
|
template <typename R, typename... Args>
|
||||||
|
class any_completion_handler_call_fn<R(Args...)>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
using type = void(*)(any_completion_handler_impl_base*, Args...);
|
||||||
|
|
||||||
|
constexpr any_completion_handler_call_fn(type fn)
|
||||||
|
: call_fn_(fn)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void call(any_completion_handler_impl_base* impl, Args... args) const
|
||||||
|
{
|
||||||
|
call_fn_(impl, ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
static void impl(any_completion_handler_impl_base* impl, Args... args)
|
||||||
|
{
|
||||||
|
static_cast<any_completion_handler_impl<Handler>*>(impl)->call(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
type call_fn_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename... Signatures>
|
||||||
|
class any_completion_handler_call_fns;
|
||||||
|
|
||||||
|
template <typename Signature>
|
||||||
|
class any_completion_handler_call_fns<Signature> :
|
||||||
|
public any_completion_handler_call_fn<Signature>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
using any_completion_handler_call_fn<
|
||||||
|
Signature>::any_completion_handler_call_fn;
|
||||||
|
using any_completion_handler_call_fn<Signature>::call;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Signature, typename... Signatures>
|
||||||
|
class any_completion_handler_call_fns<Signature, Signatures...> :
|
||||||
|
public any_completion_handler_call_fn<Signature>,
|
||||||
|
public any_completion_handler_call_fns<Signatures...>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename CallFn, typename... CallFns>
|
||||||
|
constexpr any_completion_handler_call_fns(CallFn fn, CallFns... fns)
|
||||||
|
: any_completion_handler_call_fn<Signature>(fn),
|
||||||
|
any_completion_handler_call_fns<Signatures...>(fns...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
using any_completion_handler_call_fn<Signature>::call;
|
||||||
|
using any_completion_handler_call_fns<Signatures...>::call;
|
||||||
|
};
|
||||||
|
|
||||||
|
class any_completion_handler_destroy_fn
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
using type = void(*)(any_completion_handler_impl_base*);
|
||||||
|
|
||||||
|
constexpr any_completion_handler_destroy_fn(type fn)
|
||||||
|
: destroy_fn_(fn)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void destroy(any_completion_handler_impl_base* impl) const
|
||||||
|
{
|
||||||
|
destroy_fn_(impl);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
static void impl(any_completion_handler_impl_base* impl)
|
||||||
|
{
|
||||||
|
static_cast<any_completion_handler_impl<Handler>*>(impl)->destroy();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
type destroy_fn_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class any_completion_handler_executor_fn
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
using type = any_completion_executor(*)(
|
||||||
|
any_completion_handler_impl_base*, const any_completion_executor&);
|
||||||
|
|
||||||
|
constexpr any_completion_handler_executor_fn(type fn)
|
||||||
|
: executor_fn_(fn)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
any_completion_executor executor(any_completion_handler_impl_base* impl,
|
||||||
|
const any_completion_executor& candidate) const
|
||||||
|
{
|
||||||
|
return executor_fn_(impl, candidate);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
static any_completion_executor impl(any_completion_handler_impl_base* impl,
|
||||||
|
const any_completion_executor& candidate)
|
||||||
|
{
|
||||||
|
return static_cast<any_completion_handler_impl<Handler>*>(impl)->executor(
|
||||||
|
candidate);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
type executor_fn_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class any_completion_handler_allocate_fn
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
using type = void*(*)(any_completion_handler_impl_base*,
|
||||||
|
std::size_t, std::size_t);
|
||||||
|
|
||||||
|
constexpr any_completion_handler_allocate_fn(type fn)
|
||||||
|
: allocate_fn_(fn)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void* allocate(any_completion_handler_impl_base* impl,
|
||||||
|
std::size_t size, std::size_t align) const
|
||||||
|
{
|
||||||
|
return allocate_fn_(impl, size, align);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
static void* impl(any_completion_handler_impl_base* impl,
|
||||||
|
std::size_t size, std::size_t align)
|
||||||
|
{
|
||||||
|
return static_cast<any_completion_handler_impl<Handler>*>(impl)->allocate(
|
||||||
|
size, align);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
type allocate_fn_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class any_completion_handler_deallocate_fn
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
using type = void(*)(any_completion_handler_impl_base*,
|
||||||
|
void*, std::size_t, std::size_t);
|
||||||
|
|
||||||
|
constexpr any_completion_handler_deallocate_fn(type fn)
|
||||||
|
: deallocate_fn_(fn)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void deallocate(any_completion_handler_impl_base* impl,
|
||||||
|
void* p, std::size_t size, std::size_t align) const
|
||||||
|
{
|
||||||
|
deallocate_fn_(impl, p, size, align);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
static void impl(any_completion_handler_impl_base* impl,
|
||||||
|
void* p, std::size_t size, std::size_t align)
|
||||||
|
{
|
||||||
|
static_cast<any_completion_handler_impl<Handler>*>(impl)->deallocate(
|
||||||
|
p, size, align);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
type deallocate_fn_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename... Signatures>
|
||||||
|
class any_completion_handler_fn_table
|
||||||
|
: private any_completion_handler_destroy_fn,
|
||||||
|
private any_completion_handler_executor_fn,
|
||||||
|
private any_completion_handler_allocate_fn,
|
||||||
|
private any_completion_handler_deallocate_fn,
|
||||||
|
private any_completion_handler_call_fns<Signatures...>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename... CallFns>
|
||||||
|
constexpr any_completion_handler_fn_table(
|
||||||
|
any_completion_handler_destroy_fn::type destroy_fn,
|
||||||
|
any_completion_handler_executor_fn::type executor_fn,
|
||||||
|
any_completion_handler_allocate_fn::type allocate_fn,
|
||||||
|
any_completion_handler_deallocate_fn::type deallocate_fn,
|
||||||
|
CallFns... call_fns)
|
||||||
|
: any_completion_handler_destroy_fn(destroy_fn),
|
||||||
|
any_completion_handler_executor_fn(executor_fn),
|
||||||
|
any_completion_handler_allocate_fn(allocate_fn),
|
||||||
|
any_completion_handler_deallocate_fn(deallocate_fn),
|
||||||
|
any_completion_handler_call_fns<Signatures...>(call_fns...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
using any_completion_handler_destroy_fn::destroy;
|
||||||
|
using any_completion_handler_executor_fn::executor;
|
||||||
|
using any_completion_handler_allocate_fn::allocate;
|
||||||
|
using any_completion_handler_deallocate_fn::deallocate;
|
||||||
|
using any_completion_handler_call_fns<Signatures...>::call;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Handler, typename... Signatures>
|
||||||
|
struct any_completion_handler_fn_table_instance
|
||||||
|
{
|
||||||
|
static constexpr any_completion_handler_fn_table<Signatures...>
|
||||||
|
value = any_completion_handler_fn_table<Signatures...>(
|
||||||
|
&any_completion_handler_destroy_fn::impl<Handler>,
|
||||||
|
&any_completion_handler_executor_fn::impl<Handler>,
|
||||||
|
&any_completion_handler_allocate_fn::impl<Handler>,
|
||||||
|
&any_completion_handler_deallocate_fn::impl<Handler>,
|
||||||
|
&any_completion_handler_call_fn<Signatures>::template impl<Handler>...);
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Handler, typename... Signatures>
|
||||||
|
constexpr any_completion_handler_fn_table<Signatures...>
|
||||||
|
any_completion_handler_fn_table_instance<Handler, Signatures...>::value;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
template <typename... Signatures>
|
||||||
|
class any_completion_handler;
|
||||||
|
|
||||||
|
template <typename T, typename... Signatures>
|
||||||
|
class any_completion_handler_allocator
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
template <typename...>
|
||||||
|
friend class any_completion_handler;
|
||||||
|
|
||||||
|
template <typename, typename...>
|
||||||
|
friend class any_completion_handler_allocator;
|
||||||
|
|
||||||
|
const detail::any_completion_handler_fn_table<Signatures...>* fn_table_;
|
||||||
|
detail::any_completion_handler_impl_base* impl_;
|
||||||
|
|
||||||
|
constexpr any_completion_handler_allocator(int,
|
||||||
|
const any_completion_handler<Signatures...>& h) ASIO_NOEXCEPT
|
||||||
|
: fn_table_(h.fn_table_),
|
||||||
|
impl_(h.impl_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
public:
|
||||||
|
typedef T value_type;
|
||||||
|
|
||||||
|
template <typename U>
|
||||||
|
struct rebind
|
||||||
|
{
|
||||||
|
typedef any_completion_handler_allocator<U, Signatures...> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename U>
|
||||||
|
constexpr any_completion_handler_allocator(
|
||||||
|
const any_completion_handler_allocator<U, Signatures...>& a)
|
||||||
|
ASIO_NOEXCEPT
|
||||||
|
: fn_table_(a.fn_table_),
|
||||||
|
impl_(a.impl_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr bool operator==(
|
||||||
|
const any_completion_handler_allocator& other) const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return fn_table_ == other.fn_table_ && impl_ == other.impl_;
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr bool operator!=(
|
||||||
|
const any_completion_handler_allocator& other) const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return fn_table_ != other.fn_table_ || impl_ != other.impl_;
|
||||||
|
}
|
||||||
|
|
||||||
|
T* allocate(std::size_t n) const
|
||||||
|
{
|
||||||
|
return static_cast<T*>(
|
||||||
|
fn_table_->allocate(
|
||||||
|
impl_, sizeof(T) * n, alignof(T)));
|
||||||
|
}
|
||||||
|
|
||||||
|
void deallocate(T* p, std::size_t n) const
|
||||||
|
{
|
||||||
|
fn_table_->deallocate(impl_, p, sizeof(T) * n, alignof(T));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename... Signatures>
|
||||||
|
class any_completion_handler_allocator<void, Signatures...>
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
template <typename...>
|
||||||
|
friend class any_completion_handler;
|
||||||
|
|
||||||
|
template <typename, typename...>
|
||||||
|
friend class any_completion_handler_allocator;
|
||||||
|
|
||||||
|
const detail::any_completion_handler_fn_table<Signatures...>* fn_table_;
|
||||||
|
detail::any_completion_handler_impl_base* impl_;
|
||||||
|
|
||||||
|
constexpr any_completion_handler_allocator(int,
|
||||||
|
const any_completion_handler<Signatures...>& h) ASIO_NOEXCEPT
|
||||||
|
: fn_table_(h.fn_table_),
|
||||||
|
impl_(h.impl_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
public:
|
||||||
|
typedef void value_type;
|
||||||
|
|
||||||
|
template <typename U>
|
||||||
|
struct rebind
|
||||||
|
{
|
||||||
|
typedef any_completion_handler_allocator<U, Signatures...> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename U>
|
||||||
|
constexpr any_completion_handler_allocator(
|
||||||
|
const any_completion_handler_allocator<U, Signatures...>& a)
|
||||||
|
ASIO_NOEXCEPT
|
||||||
|
: fn_table_(a.fn_table_),
|
||||||
|
impl_(a.impl_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr bool operator==(
|
||||||
|
const any_completion_handler_allocator& other) const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return fn_table_ == other.fn_table_ && impl_ == other.impl_;
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr bool operator!=(
|
||||||
|
const any_completion_handler_allocator& other) const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return fn_table_ != other.fn_table_ || impl_ != other.impl_;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename... Signatures>
|
||||||
|
class any_completion_handler
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
template <typename, typename...>
|
||||||
|
friend class any_completion_handler_allocator;
|
||||||
|
|
||||||
|
template <typename, typename>
|
||||||
|
friend struct associated_executor;
|
||||||
|
|
||||||
|
const detail::any_completion_handler_fn_table<Signatures...>* fn_table_;
|
||||||
|
detail::any_completion_handler_impl_base* impl_;
|
||||||
|
|
||||||
|
public:
|
||||||
|
using allocator_type = any_completion_handler_allocator<void, Signatures...>;
|
||||||
|
using cancellation_slot_type = cancellation_slot;
|
||||||
|
|
||||||
|
constexpr any_completion_handler()
|
||||||
|
: fn_table_(nullptr),
|
||||||
|
impl_(nullptr)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr any_completion_handler(nullptr_t)
|
||||||
|
: fn_table_(nullptr),
|
||||||
|
impl_(nullptr)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename H, typename Handler = typename decay<H>::type>
|
||||||
|
any_completion_handler(H&& h)
|
||||||
|
: fn_table_(
|
||||||
|
&detail::any_completion_handler_fn_table_instance<
|
||||||
|
Handler, Signatures...>::value),
|
||||||
|
impl_(detail::any_completion_handler_impl<Handler>::create(
|
||||||
|
(get_associated_cancellation_slot)(h), ASIO_MOVE_CAST(H)(h)))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
any_completion_handler(any_completion_handler&& other) ASIO_NOEXCEPT
|
||||||
|
: fn_table_(other.fn_table_),
|
||||||
|
impl_(other.impl_)
|
||||||
|
{
|
||||||
|
other.fn_table_ = nullptr;
|
||||||
|
other.impl_ = nullptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
any_completion_handler& operator=(
|
||||||
|
any_completion_handler&& other) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
any_completion_handler(other).swap(*this);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
any_completion_handler& operator=(nullptr_t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
any_completion_handler().swap(*this);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
~any_completion_handler()
|
||||||
|
{
|
||||||
|
if (impl_)
|
||||||
|
fn_table_->destroy(impl_);
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr explicit operator bool() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_ != nullptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
constexpr bool operator!() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_ == nullptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
void swap(any_completion_handler& other) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
std::swap(fn_table_, other.fn_table_);
|
||||||
|
std::swap(impl_, other.impl_);
|
||||||
|
}
|
||||||
|
|
||||||
|
allocator_type get_allocator() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return allocator_type(0, *this);
|
||||||
|
}
|
||||||
|
|
||||||
|
cancellation_slot_type get_cancellation_slot() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_->get_cancellation_slot();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename... Args>
|
||||||
|
auto operator()(Args&&... args)
|
||||||
|
-> decltype(fn_table_->call(impl_, ASIO_MOVE_CAST(Args)(args)...))
|
||||||
|
{
|
||||||
|
if (detail::any_completion_handler_impl_base* impl = impl_)
|
||||||
|
{
|
||||||
|
impl_ = nullptr;
|
||||||
|
return fn_table_->call(impl, ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
std::bad_function_call ex;
|
||||||
|
asio::detail::throw_exception(ex);
|
||||||
|
}
|
||||||
|
|
||||||
|
friend constexpr bool operator==(
|
||||||
|
const any_completion_handler& a, nullptr_t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return a.impl_ == nullptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
friend constexpr bool operator==(
|
||||||
|
nullptr_t, const any_completion_handler& b) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return nullptr == b.impl_;
|
||||||
|
}
|
||||||
|
|
||||||
|
friend constexpr bool operator!=(
|
||||||
|
const any_completion_handler& a, nullptr_t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return a.impl_ != nullptr;
|
||||||
|
}
|
||||||
|
|
||||||
|
friend constexpr bool operator!=(
|
||||||
|
nullptr_t, const any_completion_handler& b) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return nullptr != b.impl_;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename... Signatures, typename Candidate>
|
||||||
|
struct associated_executor<any_completion_handler<Signatures...>, Candidate>
|
||||||
|
{
|
||||||
|
using type = any_completion_executor;
|
||||||
|
|
||||||
|
static type get(const any_completion_handler<Signatures...>& handler,
|
||||||
|
const Candidate& candidate = Candidate()) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return handler.fn_table_->executor(handler.impl_,
|
||||||
|
any_completion_executor(std::nothrow, candidate));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // (defined(ASIO_HAS_STD_TUPLE)
|
||||||
|
// && defined(ASIO_HAS_MOVE)
|
||||||
|
// && defined(ASIO_HAS_VARIADIC_TEMPLATES))
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_ANY_COMPLETION_HANDLER_HPP
|
359
lib/asio-1.26.0/asio/any_io_executor.hpp
Normal file
359
lib/asio-1.26.0/asio/any_io_executor.hpp
Normal file
|
@ -0,0 +1,359 @@
|
||||||
|
//
|
||||||
|
// any_io_executor.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ANY_IO_EXECUTOR_HPP
|
||||||
|
#define ASIO_ANY_IO_EXECUTOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#if defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
# include "asio/executor.hpp"
|
||||||
|
#else // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
# include "asio/execution.hpp"
|
||||||
|
# include "asio/execution_context.hpp"
|
||||||
|
#endif // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
typedef executor any_io_executor;
|
||||||
|
|
||||||
|
#else // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
/// Polymorphic executor type for use with I/O objects.
|
||||||
|
/**
|
||||||
|
* The @c any_io_executor type is a polymorphic executor that supports the set
|
||||||
|
* of properties required by I/O objects. It is defined as the
|
||||||
|
* execution::any_executor class template parameterised as follows:
|
||||||
|
* @code execution::any_executor<
|
||||||
|
* execution::context_as_t<execution_context&>,
|
||||||
|
* execution::blocking_t::never_t,
|
||||||
|
* execution::prefer_only<execution::blocking_t::possibly_t>,
|
||||||
|
* execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
* execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
* execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
* execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
* > @endcode
|
||||||
|
*/
|
||||||
|
class any_io_executor :
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
public execution::any_executor<...>
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
public execution::any_executor<
|
||||||
|
execution::context_as_t<execution_context&>,
|
||||||
|
execution::blocking_t::never_t,
|
||||||
|
execution::prefer_only<execution::blocking_t::possibly_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
>
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef execution::any_executor<
|
||||||
|
execution::context_as_t<execution_context&>,
|
||||||
|
execution::blocking_t::never_t,
|
||||||
|
execution::prefer_only<execution::blocking_t::possibly_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
> base_type;
|
||||||
|
|
||||||
|
typedef void supportable_properties_type(
|
||||||
|
execution::context_as_t<execution_context&>,
|
||||||
|
execution::blocking_t::never_t,
|
||||||
|
execution::prefer_only<execution::blocking_t::possibly_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::tracked_t>,
|
||||||
|
execution::prefer_only<execution::outstanding_work_t::untracked_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::fork_t>,
|
||||||
|
execution::prefer_only<execution::relationship_t::continuation_t>
|
||||||
|
);
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Default constructor.
|
||||||
|
ASIO_DECL any_io_executor() ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// Construct in an empty state. Equivalent effects to default constructor.
|
||||||
|
ASIO_DECL any_io_executor(nullptr_t) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// Copy constructor.
|
||||||
|
ASIO_DECL any_io_executor(const any_io_executor& e) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move constructor.
|
||||||
|
ASIO_DECL any_io_executor(any_io_executor&& e) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <class... OtherSupportableProperties>
|
||||||
|
any_io_executor(execution::any_executor<OtherSupportableProperties...> e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename OtherAnyExecutor>
|
||||||
|
any_io_executor(OtherAnyExecutor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<OtherAnyExecutor, any_io_executor>::value
|
||||||
|
&& is_base_of<execution::detail::any_executor_base,
|
||||||
|
OtherAnyExecutor>::value,
|
||||||
|
typename execution::detail::supportable_properties<
|
||||||
|
0, supportable_properties_type>::template
|
||||||
|
is_valid_target<OtherAnyExecutor>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0)
|
||||||
|
: base_type(ASIO_MOVE_CAST(OtherAnyExecutor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <class... OtherSupportableProperties>
|
||||||
|
any_io_executor(std::nothrow_t,
|
||||||
|
execution::any_executor<OtherSupportableProperties...> e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename OtherAnyExecutor>
|
||||||
|
any_io_executor(std::nothrow_t, OtherAnyExecutor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<OtherAnyExecutor, any_io_executor>::value
|
||||||
|
&& is_base_of<execution::detail::any_executor_base,
|
||||||
|
OtherAnyExecutor>::value,
|
||||||
|
typename execution::detail::supportable_properties<
|
||||||
|
0, supportable_properties_type>::template
|
||||||
|
is_valid_target<OtherAnyExecutor>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: base_type(std::nothrow, ASIO_MOVE_CAST(OtherAnyExecutor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
ASIO_DECL any_io_executor(std::nothrow_t,
|
||||||
|
const any_io_executor& e) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Construct to point to the same target as another any_executor.
|
||||||
|
ASIO_DECL any_io_executor(std::nothrow_t,
|
||||||
|
any_io_executor&& e) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct a polymorphic wrapper for the specified executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_io_executor(Executor e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_io_executor(Executor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<Executor, any_io_executor>::value
|
||||||
|
&& !is_base_of<execution::detail::any_executor_base,
|
||||||
|
Executor>::value,
|
||||||
|
execution::detail::is_valid_target_executor<
|
||||||
|
Executor, supportable_properties_type>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0)
|
||||||
|
: base_type(ASIO_MOVE_CAST(Executor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct a polymorphic wrapper for the specified executor.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_io_executor(std::nothrow_t, Executor e);
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <ASIO_EXECUTION_EXECUTOR Executor>
|
||||||
|
any_io_executor(std::nothrow_t, Executor e,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<Executor, any_io_executor>::value
|
||||||
|
&& !is_base_of<execution::detail::any_executor_base,
|
||||||
|
Executor>::value,
|
||||||
|
execution::detail::is_valid_target_executor<
|
||||||
|
Executor, supportable_properties_type>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: base_type(std::nothrow, ASIO_MOVE_CAST(Executor)(e))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Assignment operator.
|
||||||
|
ASIO_DECL any_io_executor& operator=(
|
||||||
|
const any_io_executor& e) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move assignment operator.
|
||||||
|
ASIO_DECL any_io_executor& operator=(
|
||||||
|
any_io_executor&& e) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Assignment operator that sets the polymorphic wrapper to the empty state.
|
||||||
|
ASIO_DECL any_io_executor& operator=(nullptr_t);
|
||||||
|
|
||||||
|
/// Destructor.
|
||||||
|
ASIO_DECL ~any_io_executor();
|
||||||
|
|
||||||
|
/// Swap targets with another polymorphic wrapper.
|
||||||
|
ASIO_DECL void swap(any_io_executor& other) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// Obtain a polymorphic wrapper with the specified property.
|
||||||
|
/**
|
||||||
|
* Do not call this function directly. It is intended for use with the
|
||||||
|
* asio::require and asio::prefer customisation points.
|
||||||
|
*
|
||||||
|
* For example:
|
||||||
|
* @code any_io_executor ex = ...;
|
||||||
|
* auto ex2 = asio::require(ex, execution::blocking.possibly); @endcode
|
||||||
|
*/
|
||||||
|
template <typename Property>
|
||||||
|
any_io_executor require(const Property& p,
|
||||||
|
typename constraint<
|
||||||
|
traits::require_member<const base_type&, const Property&>::is_valid
|
||||||
|
>::type = 0) const
|
||||||
|
{
|
||||||
|
return static_cast<const base_type&>(*this).require(p);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a polymorphic wrapper with the specified property.
|
||||||
|
/**
|
||||||
|
* Do not call this function directly. It is intended for use with the
|
||||||
|
* asio::prefer customisation point.
|
||||||
|
*
|
||||||
|
* For example:
|
||||||
|
* @code any_io_executor ex = ...;
|
||||||
|
* auto ex2 = asio::prefer(ex, execution::blocking.possibly); @endcode
|
||||||
|
*/
|
||||||
|
template <typename Property>
|
||||||
|
any_io_executor prefer(const Property& p,
|
||||||
|
typename constraint<
|
||||||
|
traits::prefer_member<const base_type&, const Property&>::is_valid
|
||||||
|
>::type = 0) const
|
||||||
|
{
|
||||||
|
return static_cast<const base_type&>(*this).prefer(p);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_io_executor any_io_executor::require(
|
||||||
|
const execution::blocking_t::never_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_io_executor any_io_executor::prefer(
|
||||||
|
const execution::blocking_t::possibly_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_io_executor any_io_executor::prefer(
|
||||||
|
const execution::outstanding_work_t::tracked_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_io_executor any_io_executor::prefer(
|
||||||
|
const execution::outstanding_work_t::untracked_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_io_executor any_io_executor::prefer(
|
||||||
|
const execution::relationship_t::fork_t&, int) const;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
ASIO_DECL any_io_executor any_io_executor::prefer(
|
||||||
|
const execution::relationship_t::continuation_t&, int) const;
|
||||||
|
|
||||||
|
namespace traits {
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_EQUALITY_COMPARABLE_TRAIT)
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct equality_comparable<any_io_executor>
|
||||||
|
{
|
||||||
|
static const bool is_valid = true;
|
||||||
|
static const bool is_noexcept = true;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_EQUALITY_COMPARABLE_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_EXECUTE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename F>
|
||||||
|
struct execute_member<any_io_executor, F>
|
||||||
|
{
|
||||||
|
static const bool is_valid = true;
|
||||||
|
static const bool is_noexcept = false;
|
||||||
|
typedef void result_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_EXECUTE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename Prop>
|
||||||
|
struct query_member<any_io_executor, Prop> :
|
||||||
|
query_member<any_io_executor::base_type, Prop>
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename Prop>
|
||||||
|
struct require_member<any_io_executor, Prop> :
|
||||||
|
require_member<any_io_executor::base_type, Prop>
|
||||||
|
{
|
||||||
|
typedef any_io_executor result_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
template <typename Prop>
|
||||||
|
struct prefer_member<any_io_executor, Prop> :
|
||||||
|
prefer_member<any_io_executor::base_type, Prop>
|
||||||
|
{
|
||||||
|
typedef any_io_executor result_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT)
|
||||||
|
|
||||||
|
} // namespace traits
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HEADER_ONLY) \
|
||||||
|
&& !defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
# include "asio/impl/any_io_executor.ipp"
|
||||||
|
#endif // defined(ASIO_HEADER_ONLY)
|
||||||
|
// && !defined(ASIO_USE_TS_EXECUTOR_AS_DEFAULT)
|
||||||
|
|
||||||
|
#endif // ASIO_ANY_IO_EXECUTOR_HPP
|
78
lib/asio-1.26.0/asio/append.hpp
Normal file
78
lib/asio-1.26.0/asio/append.hpp
Normal file
|
@ -0,0 +1,78 @@
|
||||||
|
//
|
||||||
|
// append.hpp
|
||||||
|
// ~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_APPEND_HPP
|
||||||
|
#define ASIO_APPEND_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if (defined(ASIO_HAS_STD_TUPLE) \
|
||||||
|
&& defined(ASIO_HAS_VARIADIC_TEMPLATES)) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <tuple>
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Completion token type used to specify that the completion handler
|
||||||
|
/// arguments should be passed additional values after the results of the
|
||||||
|
/// operation.
|
||||||
|
template <typename CompletionToken, typename... Values>
|
||||||
|
class append_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Constructor.
|
||||||
|
template <typename T, typename... V>
|
||||||
|
ASIO_CONSTEXPR explicit append_t(
|
||||||
|
ASIO_MOVE_ARG(T) completion_token,
|
||||||
|
ASIO_MOVE_ARG(V)... values)
|
||||||
|
: token_(ASIO_MOVE_CAST(T)(completion_token)),
|
||||||
|
values_(ASIO_MOVE_CAST(V)(values)...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
//private:
|
||||||
|
CompletionToken token_;
|
||||||
|
std::tuple<Values...> values_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Completion token type used to specify that the completion handler
|
||||||
|
/// arguments should be passed additional values after the results of the
|
||||||
|
/// operation.
|
||||||
|
template <typename CompletionToken, typename... Values>
|
||||||
|
ASIO_NODISCARD inline ASIO_CONSTEXPR append_t<
|
||||||
|
typename decay<CompletionToken>::type, typename decay<Values>::type...>
|
||||||
|
append(ASIO_MOVE_ARG(CompletionToken) completion_token,
|
||||||
|
ASIO_MOVE_ARG(Values)... values)
|
||||||
|
{
|
||||||
|
return append_t<
|
||||||
|
typename decay<CompletionToken>::type, typename decay<Values>::type...>(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(completion_token),
|
||||||
|
ASIO_MOVE_CAST(Values)(values)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/append.hpp"
|
||||||
|
|
||||||
|
#endif // (defined(ASIO_HAS_STD_TUPLE)
|
||||||
|
// && defined(ASIO_HAS_VARIADIC_TEMPLATES))
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_APPEND_HPP
|
139
lib/asio-1.26.0/asio/as_tuple.hpp
Normal file
139
lib/asio-1.26.0/asio/as_tuple.hpp
Normal file
|
@ -0,0 +1,139 @@
|
||||||
|
//
|
||||||
|
// as_tuple.hpp
|
||||||
|
// ~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_AS_TUPLE_HPP
|
||||||
|
#define ASIO_AS_TUPLE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if (defined(ASIO_HAS_STD_TUPLE) \
|
||||||
|
&& defined(ASIO_HAS_VARIADIC_TEMPLATES)) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// A @ref completion_token adapter used to specify that the completion handler
|
||||||
|
/// arguments should be combined into a single tuple argument.
|
||||||
|
/**
|
||||||
|
* The as_tuple_t class is used to indicate that any arguments to the
|
||||||
|
* completion handler should be combined and passed as a single tuple argument.
|
||||||
|
* The arguments are first moved into a @c std::tuple and that tuple is then
|
||||||
|
* passed to the completion handler.
|
||||||
|
*/
|
||||||
|
template <typename CompletionToken>
|
||||||
|
class as_tuple_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Tag type used to prevent the "default" constructor from being used for
|
||||||
|
/// conversions.
|
||||||
|
struct default_constructor_tag {};
|
||||||
|
|
||||||
|
/// Default constructor.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the underlying completion token is
|
||||||
|
* default constructible and move constructible. The underlying completion
|
||||||
|
* token is itself defaulted as an argument to allow it to capture a source
|
||||||
|
* location.
|
||||||
|
*/
|
||||||
|
ASIO_CONSTEXPR as_tuple_t(
|
||||||
|
default_constructor_tag = default_constructor_tag(),
|
||||||
|
CompletionToken token = CompletionToken())
|
||||||
|
: token_(ASIO_MOVE_CAST(CompletionToken)(token))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor.
|
||||||
|
template <typename T>
|
||||||
|
ASIO_CONSTEXPR explicit as_tuple_t(
|
||||||
|
ASIO_MOVE_ARG(T) completion_token)
|
||||||
|
: token_(ASIO_MOVE_CAST(T)(completion_token))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Adapts an executor to add the @c as_tuple_t completion token as the
|
||||||
|
/// default.
|
||||||
|
template <typename InnerExecutor>
|
||||||
|
struct executor_with_default : InnerExecutor
|
||||||
|
{
|
||||||
|
/// Specify @c as_tuple_t as the default completion token type.
|
||||||
|
typedef as_tuple_t default_completion_token_type;
|
||||||
|
|
||||||
|
/// Construct the adapted executor from the inner executor type.
|
||||||
|
template <typename InnerExecutor1>
|
||||||
|
executor_with_default(const InnerExecutor1& ex,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<InnerExecutor1, executor_with_default>::value,
|
||||||
|
is_convertible<InnerExecutor1, InnerExecutor>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: InnerExecutor(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Type alias to adapt an I/O object to use @c as_tuple_t as its
|
||||||
|
/// default completion token type.
|
||||||
|
#if defined(ASIO_HAS_ALIAS_TEMPLATES) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename T>
|
||||||
|
using as_default_on_t = typename T::template rebind_executor<
|
||||||
|
executor_with_default<typename T::executor_type> >::other;
|
||||||
|
#endif // defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Function helper to adapt an I/O object to use @c as_tuple_t as its
|
||||||
|
/// default completion token type.
|
||||||
|
template <typename T>
|
||||||
|
static typename decay<T>::type::template rebind_executor<
|
||||||
|
executor_with_default<typename decay<T>::type::executor_type>
|
||||||
|
>::other
|
||||||
|
as_default_on(ASIO_MOVE_ARG(T) object)
|
||||||
|
{
|
||||||
|
return typename decay<T>::type::template rebind_executor<
|
||||||
|
executor_with_default<typename decay<T>::type::executor_type>
|
||||||
|
>::other(ASIO_MOVE_CAST(T)(object));
|
||||||
|
}
|
||||||
|
|
||||||
|
//private:
|
||||||
|
CompletionToken token_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Adapt a @ref completion_token to specify that the completion handler
|
||||||
|
/// arguments should be combined into a single tuple argument.
|
||||||
|
template <typename CompletionToken>
|
||||||
|
ASIO_NODISCARD inline
|
||||||
|
ASIO_CONSTEXPR as_tuple_t<typename decay<CompletionToken>::type>
|
||||||
|
as_tuple(ASIO_MOVE_ARG(CompletionToken) completion_token)
|
||||||
|
{
|
||||||
|
return as_tuple_t<typename decay<CompletionToken>::type>(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(completion_token));
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/as_tuple.hpp"
|
||||||
|
|
||||||
|
#endif // (defined(ASIO_HAS_STD_TUPLE)
|
||||||
|
// && defined(ASIO_HAS_VARIADIC_TEMPLATES))
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_AS_TUPLE_HPP
|
233
lib/asio-1.26.0/asio/associated_allocator.hpp
Normal file
233
lib/asio-1.26.0/asio/associated_allocator.hpp
Normal file
|
@ -0,0 +1,233 @@
|
||||||
|
//
|
||||||
|
// associated_allocator.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ASSOCIATED_ALLOCATOR_HPP
|
||||||
|
#define ASIO_ASSOCIATED_ALLOCATOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <memory>
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/detail/functional.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename T, typename Allocator>
|
||||||
|
struct associated_allocator;
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct has_allocator_type : false_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct has_allocator_type<T,
|
||||||
|
typename void_type<typename T::allocator_type>::type>
|
||||||
|
: true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename A, typename = void, typename = void>
|
||||||
|
struct associated_allocator_impl
|
||||||
|
{
|
||||||
|
typedef void asio_associated_allocator_is_unspecialised;
|
||||||
|
|
||||||
|
typedef A type;
|
||||||
|
|
||||||
|
static type get(const T&) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return type();
|
||||||
|
}
|
||||||
|
|
||||||
|
static const type& get(const T&, const A& a) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return a;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename A>
|
||||||
|
struct associated_allocator_impl<T, A,
|
||||||
|
typename void_type<typename T::allocator_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::allocator_type type;
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const T& t) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((t.get_allocator()))
|
||||||
|
{
|
||||||
|
return t.get_allocator();
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const T& t, const A&) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((t.get_allocator()))
|
||||||
|
{
|
||||||
|
return t.get_allocator();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename A>
|
||||||
|
struct associated_allocator_impl<T, A,
|
||||||
|
typename enable_if<
|
||||||
|
!has_allocator_type<T>::value
|
||||||
|
>::type,
|
||||||
|
typename void_type<
|
||||||
|
typename associator<associated_allocator, T, A>::type
|
||||||
|
>::type> : associator<associated_allocator, T, A>
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Traits type used to obtain the allocator associated with an object.
|
||||||
|
/**
|
||||||
|
* A program may specialise this traits type if the @c T template parameter in
|
||||||
|
* the specialisation is a user-defined type. The template parameter @c
|
||||||
|
* Allocator shall be a type meeting the Allocator requirements.
|
||||||
|
*
|
||||||
|
* Specialisations shall meet the following requirements, where @c t is a const
|
||||||
|
* reference to an object of type @c T, and @c a is an object of type @c
|
||||||
|
* Allocator.
|
||||||
|
*
|
||||||
|
* @li Provide a nested typedef @c type that identifies a type meeting the
|
||||||
|
* Allocator requirements.
|
||||||
|
*
|
||||||
|
* @li Provide a noexcept static member function named @c get, callable as @c
|
||||||
|
* get(t) and with return type @c type or a (possibly const) reference to @c
|
||||||
|
* type.
|
||||||
|
*
|
||||||
|
* @li Provide a noexcept static member function named @c get, callable as @c
|
||||||
|
* get(t,a) and with return type @c type or a (possibly const) reference to @c
|
||||||
|
* type.
|
||||||
|
*/
|
||||||
|
template <typename T, typename Allocator = std::allocator<void> >
|
||||||
|
struct associated_allocator
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: detail::associated_allocator_impl<T, Allocator>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// If @c T has a nested type @c allocator_type, <tt>T::allocator_type</tt>.
|
||||||
|
/// Otherwise @c Allocator.
|
||||||
|
typedef see_below type;
|
||||||
|
|
||||||
|
/// If @c T has a nested type @c allocator_type, returns
|
||||||
|
/// <tt>t.get_allocator()</tt>. Otherwise returns @c type().
|
||||||
|
static decltype(auto) get(const T& t) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// If @c T has a nested type @c allocator_type, returns
|
||||||
|
/// <tt>t.get_allocator()</tt>. Otherwise returns @c a.
|
||||||
|
static decltype(auto) get(const T& t, const Allocator& a) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated allocator.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_allocator<T>::get(t)</tt>
|
||||||
|
*/
|
||||||
|
template <typename T>
|
||||||
|
ASIO_NODISCARD inline typename associated_allocator<T>::type
|
||||||
|
get_associated_allocator(const T& t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return associated_allocator<T>::get(t);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated allocator.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_allocator<T, Allocator>::get(t, a)</tt>
|
||||||
|
*/
|
||||||
|
template <typename T, typename Allocator>
|
||||||
|
ASIO_NODISCARD inline ASIO_AUTO_RETURN_TYPE_PREFIX2(
|
||||||
|
typename associated_allocator<T, Allocator>::type)
|
||||||
|
get_associated_allocator(const T& t, const Allocator& a) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_allocator<T, Allocator>::get(t, a)))
|
||||||
|
{
|
||||||
|
return associated_allocator<T, Allocator>::get(t, a);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename T, typename Allocator = std::allocator<void> >
|
||||||
|
using associated_allocator_t
|
||||||
|
= typename associated_allocator<T, Allocator>::type;
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T, typename A, typename = void>
|
||||||
|
struct associated_allocator_forwarding_base
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename A>
|
||||||
|
struct associated_allocator_forwarding_base<T, A,
|
||||||
|
typename enable_if<
|
||||||
|
is_same<
|
||||||
|
typename associated_allocator<T,
|
||||||
|
A>::asio_associated_allocator_is_unspecialised,
|
||||||
|
void
|
||||||
|
>::value
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef void asio_associated_allocator_is_unspecialised;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_REFERENCE_WRAPPER) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Specialisation of associated_allocator for @c std::reference_wrapper.
|
||||||
|
template <typename T, typename Allocator>
|
||||||
|
struct associated_allocator<reference_wrapper<T>, Allocator>
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: detail::associated_allocator_forwarding_base<T, Allocator>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
/// Forwards @c type to the associator specialisation for the unwrapped type
|
||||||
|
/// @c T.
|
||||||
|
typedef typename associated_allocator<T, Allocator>::type type;
|
||||||
|
|
||||||
|
/// Forwards the request to get the allocator to the associator specialisation
|
||||||
|
/// for the unwrapped type @c T.
|
||||||
|
static type get(reference_wrapper<T> t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return associated_allocator<T, Allocator>::get(t.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Forwards the request to get the allocator to the associator specialisation
|
||||||
|
/// for the unwrapped type @c T.
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
reference_wrapper<T> t, const Allocator& a) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_allocator<T, Allocator>::get(t.get(), a)))
|
||||||
|
{
|
||||||
|
return associated_allocator<T, Allocator>::get(t.get(), a);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_REFERENCE_WRAPPER)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_ASSOCIATED_ALLOCATOR_HPP
|
238
lib/asio-1.26.0/asio/associated_cancellation_slot.hpp
Normal file
238
lib/asio-1.26.0/asio/associated_cancellation_slot.hpp
Normal file
|
@ -0,0 +1,238 @@
|
||||||
|
//
|
||||||
|
// associated_cancellation_slot.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ASSOCIATED_CANCELLATION_SLOT_HPP
|
||||||
|
#define ASIO_ASSOCIATED_CANCELLATION_SLOT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/cancellation_signal.hpp"
|
||||||
|
#include "asio/detail/functional.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename T, typename CancellationSlot>
|
||||||
|
struct associated_cancellation_slot;
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct has_cancellation_slot_type : false_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct has_cancellation_slot_type<T,
|
||||||
|
typename void_type<typename T::cancellation_slot_type>::type>
|
||||||
|
: true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename S, typename = void, typename = void>
|
||||||
|
struct associated_cancellation_slot_impl
|
||||||
|
{
|
||||||
|
typedef void asio_associated_cancellation_slot_is_unspecialised;
|
||||||
|
|
||||||
|
typedef S type;
|
||||||
|
|
||||||
|
static type get(const T&) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return type();
|
||||||
|
}
|
||||||
|
|
||||||
|
static const type& get(const T&, const S& s) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename S>
|
||||||
|
struct associated_cancellation_slot_impl<T, S,
|
||||||
|
typename void_type<typename T::cancellation_slot_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::cancellation_slot_type type;
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const T& t) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((t.get_cancellation_slot()))
|
||||||
|
{
|
||||||
|
return t.get_cancellation_slot();
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const T& t, const S&) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((t.get_cancellation_slot()))
|
||||||
|
{
|
||||||
|
return t.get_cancellation_slot();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename S>
|
||||||
|
struct associated_cancellation_slot_impl<T, S,
|
||||||
|
typename enable_if<
|
||||||
|
!has_cancellation_slot_type<T>::value
|
||||||
|
>::type,
|
||||||
|
typename void_type<
|
||||||
|
typename associator<associated_cancellation_slot, T, S>::type
|
||||||
|
>::type> : associator<associated_cancellation_slot, T, S>
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Traits type used to obtain the cancellation_slot associated with an object.
|
||||||
|
/**
|
||||||
|
* A program may specialise this traits type if the @c T template parameter in
|
||||||
|
* the specialisation is a user-defined type. The template parameter @c
|
||||||
|
* CancellationSlot shall be a type meeting the CancellationSlot requirements.
|
||||||
|
*
|
||||||
|
* Specialisations shall meet the following requirements, where @c t is a const
|
||||||
|
* reference to an object of type @c T, and @c s is an object of type @c
|
||||||
|
* CancellationSlot.
|
||||||
|
*
|
||||||
|
* @li Provide a nested typedef @c type that identifies a type meeting the
|
||||||
|
* CancellationSlot requirements.
|
||||||
|
*
|
||||||
|
* @li Provide a noexcept static member function named @c get, callable as @c
|
||||||
|
* get(t) and with return type @c type or a (possibly const) reference to @c
|
||||||
|
* type.
|
||||||
|
*
|
||||||
|
* @li Provide a noexcept static member function named @c get, callable as @c
|
||||||
|
* get(t,s) and with return type @c type or a (possibly const) reference to @c
|
||||||
|
* type.
|
||||||
|
*/
|
||||||
|
template <typename T, typename CancellationSlot = cancellation_slot>
|
||||||
|
struct associated_cancellation_slot
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: detail::associated_cancellation_slot_impl<T, CancellationSlot>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// If @c T has a nested type @c cancellation_slot_type,
|
||||||
|
/// <tt>T::cancellation_slot_type</tt>. Otherwise
|
||||||
|
/// @c CancellationSlot.
|
||||||
|
typedef see_below type;
|
||||||
|
|
||||||
|
/// If @c T has a nested type @c cancellation_slot_type, returns
|
||||||
|
/// <tt>t.get_cancellation_slot()</tt>. Otherwise returns @c type().
|
||||||
|
static decltype(auto) get(const T& t) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// If @c T has a nested type @c cancellation_slot_type, returns
|
||||||
|
/// <tt>t.get_cancellation_slot()</tt>. Otherwise returns @c s.
|
||||||
|
static decltype(auto) get(const T& t,
|
||||||
|
const CancellationSlot& s) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated cancellation_slot.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_cancellation_slot<T>::get(t)</tt>
|
||||||
|
*/
|
||||||
|
template <typename T>
|
||||||
|
ASIO_NODISCARD inline typename associated_cancellation_slot<T>::type
|
||||||
|
get_associated_cancellation_slot(const T& t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return associated_cancellation_slot<T>::get(t);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated cancellation_slot.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_cancellation_slot<T,
|
||||||
|
* CancellationSlot>::get(t, st)</tt>
|
||||||
|
*/
|
||||||
|
template <typename T, typename CancellationSlot>
|
||||||
|
ASIO_NODISCARD inline ASIO_AUTO_RETURN_TYPE_PREFIX2(
|
||||||
|
typename associated_cancellation_slot<T, CancellationSlot>::type)
|
||||||
|
get_associated_cancellation_slot(const T& t,
|
||||||
|
const CancellationSlot& st) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_cancellation_slot<T, CancellationSlot>::get(t, st)))
|
||||||
|
{
|
||||||
|
return associated_cancellation_slot<T, CancellationSlot>::get(t, st);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename T, typename CancellationSlot = cancellation_slot>
|
||||||
|
using associated_cancellation_slot_t =
|
||||||
|
typename associated_cancellation_slot<T, CancellationSlot>::type;
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T, typename S, typename = void>
|
||||||
|
struct associated_cancellation_slot_forwarding_base
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename S>
|
||||||
|
struct associated_cancellation_slot_forwarding_base<T, S,
|
||||||
|
typename enable_if<
|
||||||
|
is_same<
|
||||||
|
typename associated_cancellation_slot<T,
|
||||||
|
S>::asio_associated_cancellation_slot_is_unspecialised,
|
||||||
|
void
|
||||||
|
>::value
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef void asio_associated_cancellation_slot_is_unspecialised;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_REFERENCE_WRAPPER) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Specialisation of associated_cancellation_slot for @c
|
||||||
|
/// std::reference_wrapper.
|
||||||
|
template <typename T, typename CancellationSlot>
|
||||||
|
struct associated_cancellation_slot<reference_wrapper<T>, CancellationSlot>
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: detail::associated_cancellation_slot_forwarding_base<T, CancellationSlot>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
/// Forwards @c type to the associator specialisation for the unwrapped type
|
||||||
|
/// @c T.
|
||||||
|
typedef typename associated_cancellation_slot<T, CancellationSlot>::type type;
|
||||||
|
|
||||||
|
/// Forwards the request to get the cancellation slot to the associator
|
||||||
|
/// specialisation for the unwrapped type @c T.
|
||||||
|
static type get(reference_wrapper<T> t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return associated_cancellation_slot<T, CancellationSlot>::get(t.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Forwards the request to get the cancellation slot to the associator
|
||||||
|
/// specialisation for the unwrapped type @c T.
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(reference_wrapper<T> t,
|
||||||
|
const CancellationSlot& s = CancellationSlot()) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_cancellation_slot<T, CancellationSlot>::get(t.get(), s)))
|
||||||
|
{
|
||||||
|
return associated_cancellation_slot<T, CancellationSlot>::get(t.get(), s);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_REFERENCE_WRAPPER)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_ASSOCIATED_CANCELLATION_SLOT_HPP
|
257
lib/asio-1.26.0/asio/associated_executor.hpp
Normal file
257
lib/asio-1.26.0/asio/associated_executor.hpp
Normal file
|
@ -0,0 +1,257 @@
|
||||||
|
//
|
||||||
|
// associated_executor.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ASSOCIATED_EXECUTOR_HPP
|
||||||
|
#define ASIO_ASSOCIATED_EXECUTOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/detail/functional.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
#include "asio/system_executor.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
struct associated_executor;
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct has_executor_type : false_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct has_executor_type<T,
|
||||||
|
typename void_type<typename T::executor_type>::type>
|
||||||
|
: true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename E, typename = void, typename = void>
|
||||||
|
struct associated_executor_impl
|
||||||
|
{
|
||||||
|
typedef void asio_associated_executor_is_unspecialised;
|
||||||
|
|
||||||
|
typedef E type;
|
||||||
|
|
||||||
|
static type get(const T&) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return type();
|
||||||
|
}
|
||||||
|
|
||||||
|
static const type& get(const T&, const E& e) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return e;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename E>
|
||||||
|
struct associated_executor_impl<T, E,
|
||||||
|
typename void_type<typename T::executor_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::executor_type type;
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const T& t) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((t.get_executor()))
|
||||||
|
{
|
||||||
|
return t.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const T& t, const E&) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((t.get_executor()))
|
||||||
|
{
|
||||||
|
return t.get_executor();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename E>
|
||||||
|
struct associated_executor_impl<T, E,
|
||||||
|
typename enable_if<
|
||||||
|
!has_executor_type<T>::value
|
||||||
|
>::type,
|
||||||
|
typename void_type<
|
||||||
|
typename associator<associated_executor, T, E>::type
|
||||||
|
>::type> : associator<associated_executor, T, E>
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Traits type used to obtain the executor associated with an object.
|
||||||
|
/**
|
||||||
|
* A program may specialise this traits type if the @c T template parameter in
|
||||||
|
* the specialisation is a user-defined type. The template parameter @c
|
||||||
|
* Executor shall be a type meeting the Executor requirements.
|
||||||
|
*
|
||||||
|
* Specialisations shall meet the following requirements, where @c t is a const
|
||||||
|
* reference to an object of type @c T, and @c e is an object of type @c
|
||||||
|
* Executor.
|
||||||
|
*
|
||||||
|
* @li Provide a nested typedef @c type that identifies a type meeting the
|
||||||
|
* Executor requirements.
|
||||||
|
*
|
||||||
|
* @li Provide a noexcept static member function named @c get, callable as @c
|
||||||
|
* get(t) and with return type @c type or a (possibly const) reference to @c
|
||||||
|
* type.
|
||||||
|
*
|
||||||
|
* @li Provide a noexcept static member function named @c get, callable as @c
|
||||||
|
* get(t,e) and with return type @c type or a (possibly const) reference to @c
|
||||||
|
* type.
|
||||||
|
*/
|
||||||
|
template <typename T, typename Executor = system_executor>
|
||||||
|
struct associated_executor
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: detail::associated_executor_impl<T, Executor>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// If @c T has a nested type @c executor_type, <tt>T::executor_type</tt>.
|
||||||
|
/// Otherwise @c Executor.
|
||||||
|
typedef see_below type;
|
||||||
|
|
||||||
|
/// If @c T has a nested type @c executor_type, returns
|
||||||
|
/// <tt>t.get_executor()</tt>. Otherwise returns @c type().
|
||||||
|
static decltype(auto) get(const T& t) ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
/// If @c T has a nested type @c executor_type, returns
|
||||||
|
/// <tt>t.get_executor()</tt>. Otherwise returns @c ex.
|
||||||
|
static decltype(auto) get(const T& t, const Executor& ex) ASIO_NOEXCEPT;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated executor.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_executor<T>::get(t)</tt>
|
||||||
|
*/
|
||||||
|
template <typename T>
|
||||||
|
ASIO_NODISCARD inline typename associated_executor<T>::type
|
||||||
|
get_associated_executor(const T& t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return associated_executor<T>::get(t);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated executor.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_executor<T, Executor>::get(t, ex)</tt>
|
||||||
|
*/
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
ASIO_NODISCARD inline ASIO_AUTO_RETURN_TYPE_PREFIX2(
|
||||||
|
typename associated_executor<T, Executor>::type)
|
||||||
|
get_associated_executor(const T& t, const Executor& ex,
|
||||||
|
typename constraint<
|
||||||
|
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_executor<T, Executor>::get(t, ex)))
|
||||||
|
{
|
||||||
|
return associated_executor<T, Executor>::get(t, ex);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Helper function to obtain an object's associated executor.
|
||||||
|
/**
|
||||||
|
* @returns <tt>associated_executor<T, typename
|
||||||
|
* ExecutionContext::executor_type>::get(t, ctx.get_executor())</tt>
|
||||||
|
*/
|
||||||
|
template <typename T, typename ExecutionContext>
|
||||||
|
ASIO_NODISCARD inline ASIO_AUTO_RETURN_TYPE_PREFIX2(
|
||||||
|
typename associated_executor<T,
|
||||||
|
typename ExecutionContext::executor_type>::type)
|
||||||
|
get_associated_executor(const T& t, ExecutionContext& ctx,
|
||||||
|
typename constraint<is_convertible<ExecutionContext&,
|
||||||
|
execution_context&>::value>::type = 0) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_executor<T,
|
||||||
|
typename ExecutionContext::executor_type>::get(t, ctx.get_executor())))
|
||||||
|
{
|
||||||
|
return associated_executor<T,
|
||||||
|
typename ExecutionContext::executor_type>::get(t, ctx.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename T, typename Executor = system_executor>
|
||||||
|
using associated_executor_t = typename associated_executor<T, Executor>::type;
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T, typename E, typename = void>
|
||||||
|
struct associated_executor_forwarding_base
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename E>
|
||||||
|
struct associated_executor_forwarding_base<T, E,
|
||||||
|
typename enable_if<
|
||||||
|
is_same<
|
||||||
|
typename associated_executor<T,
|
||||||
|
E>::asio_associated_executor_is_unspecialised,
|
||||||
|
void
|
||||||
|
>::value
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef void asio_associated_executor_is_unspecialised;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_REFERENCE_WRAPPER) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Specialisation of associated_executor for @c std::reference_wrapper.
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
struct associated_executor<reference_wrapper<T>, Executor>
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: detail::associated_executor_forwarding_base<T, Executor>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
/// Forwards @c type to the associator specialisation for the unwrapped type
|
||||||
|
/// @c T.
|
||||||
|
typedef typename associated_executor<T, Executor>::type type;
|
||||||
|
|
||||||
|
/// Forwards the request to get the executor to the associator specialisation
|
||||||
|
/// for the unwrapped type @c T.
|
||||||
|
static type get(reference_wrapper<T> t) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return associated_executor<T, Executor>::get(t.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Forwards the request to get the executor to the associator specialisation
|
||||||
|
/// for the unwrapped type @c T.
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
reference_wrapper<T> t, const Executor& ex) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
associated_executor<T, Executor>::get(t.get(), ex)))
|
||||||
|
{
|
||||||
|
return associated_executor<T, Executor>::get(t.get(), ex);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_REFERENCE_WRAPPER)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_ASSOCIATED_EXECUTOR_HPP
|
35
lib/asio-1.26.0/asio/associator.hpp
Normal file
35
lib/asio-1.26.0/asio/associator.hpp
Normal file
|
@ -0,0 +1,35 @@
|
||||||
|
//
|
||||||
|
// associator.hpp
|
||||||
|
// ~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_ASSOCIATOR_HPP
|
||||||
|
#define ASIO_ASSOCIATOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Used to generically specialise associators for a type.
|
||||||
|
template <template <typename, typename> class Associator,
|
||||||
|
typename T, typename DefaultCandidate>
|
||||||
|
struct associator
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_ASSOCIATOR_HPP
|
1627
lib/asio-1.26.0/asio/async_result.hpp
Normal file
1627
lib/asio-1.26.0/asio/async_result.hpp
Normal file
File diff suppressed because it is too large
Load diff
142
lib/asio-1.26.0/asio/awaitable.hpp
Normal file
142
lib/asio-1.26.0/asio/awaitable.hpp
Normal file
|
@ -0,0 +1,142 @@
|
||||||
|
//
|
||||||
|
// awaitable.hpp
|
||||||
|
// ~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_AWAITABLE_HPP
|
||||||
|
#define ASIO_AWAITABLE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_CO_AWAIT) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_COROUTINE)
|
||||||
|
# include <coroutine>
|
||||||
|
#else // defined(ASIO_HAS_STD_COROUTINE)
|
||||||
|
# include <experimental/coroutine>
|
||||||
|
#endif // defined(ASIO_HAS_STD_COROUTINE)
|
||||||
|
|
||||||
|
#include <utility>
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_COROUTINE)
|
||||||
|
using std::coroutine_handle;
|
||||||
|
using std::suspend_always;
|
||||||
|
#else // defined(ASIO_HAS_STD_COROUTINE)
|
||||||
|
using std::experimental::coroutine_handle;
|
||||||
|
using std::experimental::suspend_always;
|
||||||
|
#endif // defined(ASIO_HAS_STD_COROUTINE)
|
||||||
|
|
||||||
|
template <typename> class awaitable_thread;
|
||||||
|
template <typename, typename> class awaitable_frame;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// The return type of a coroutine or asynchronous operation.
|
||||||
|
template <typename T, typename Executor = any_io_executor>
|
||||||
|
class ASIO_NODISCARD awaitable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the awaited value.
|
||||||
|
typedef T value_type;
|
||||||
|
|
||||||
|
/// The executor type that will be used for the coroutine.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Default constructor.
|
||||||
|
constexpr awaitable() noexcept
|
||||||
|
: frame_(nullptr)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move constructor.
|
||||||
|
awaitable(awaitable&& other) noexcept
|
||||||
|
: frame_(std::exchange(other.frame_, nullptr))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Destructor
|
||||||
|
~awaitable()
|
||||||
|
{
|
||||||
|
if (frame_)
|
||||||
|
frame_->destroy();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move assignment.
|
||||||
|
awaitable& operator=(awaitable&& other) noexcept
|
||||||
|
{
|
||||||
|
if (this != &other)
|
||||||
|
frame_ = std::exchange(other.frame_, nullptr);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Checks if the awaitable refers to a future result.
|
||||||
|
bool valid() const noexcept
|
||||||
|
{
|
||||||
|
return !!frame_;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
// Support for co_await keyword.
|
||||||
|
bool await_ready() const noexcept
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Support for co_await keyword.
|
||||||
|
template <class U>
|
||||||
|
void await_suspend(
|
||||||
|
detail::coroutine_handle<detail::awaitable_frame<U, Executor>> h)
|
||||||
|
{
|
||||||
|
frame_->push_frame(&h.promise());
|
||||||
|
}
|
||||||
|
|
||||||
|
// Support for co_await keyword.
|
||||||
|
T await_resume()
|
||||||
|
{
|
||||||
|
return awaitable(static_cast<awaitable&&>(*this)).frame_->get();
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
private:
|
||||||
|
template <typename> friend class detail::awaitable_thread;
|
||||||
|
template <typename, typename> friend class detail::awaitable_frame;
|
||||||
|
|
||||||
|
// Not copy constructible or copy assignable.
|
||||||
|
awaitable(const awaitable&) = delete;
|
||||||
|
awaitable& operator=(const awaitable&) = delete;
|
||||||
|
|
||||||
|
// Construct the awaitable from a coroutine's frame object.
|
||||||
|
explicit awaitable(detail::awaitable_frame<T, Executor>* a)
|
||||||
|
: frame_(a)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
detail::awaitable_frame<T, Executor>* frame_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/awaitable.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_CO_AWAIT) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_AWAITABLE_HPP
|
1396
lib/asio-1.26.0/asio/basic_datagram_socket.hpp
Normal file
1396
lib/asio-1.26.0/asio/basic_datagram_socket.hpp
Normal file
File diff suppressed because it is too large
Load diff
715
lib/asio-1.26.0/asio/basic_deadline_timer.hpp
Normal file
715
lib/asio-1.26.0/asio/basic_deadline_timer.hpp
Normal file
|
@ -0,0 +1,715 @@
|
||||||
|
//
|
||||||
|
// basic_deadline_timer.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_DEADLINE_TIMER_HPP
|
||||||
|
#define ASIO_BASIC_DEADLINE_TIMER_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/detail/deadline_timer_service.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/io_object_impl.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/time_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Provides waitable timer functionality.
|
||||||
|
/**
|
||||||
|
* The basic_deadline_timer class template provides the ability to perform a
|
||||||
|
* blocking or asynchronous wait for a timer to expire.
|
||||||
|
*
|
||||||
|
* A deadline timer is always in one of two states: "expired" or "not expired".
|
||||||
|
* If the wait() or async_wait() function is called on an expired timer, the
|
||||||
|
* wait operation will complete immediately.
|
||||||
|
*
|
||||||
|
* Most applications will use the asio::deadline_timer typedef.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Examples
|
||||||
|
* Performing a blocking wait:
|
||||||
|
* @code
|
||||||
|
* // Construct a timer without setting an expiry time.
|
||||||
|
* asio::deadline_timer timer(my_context);
|
||||||
|
*
|
||||||
|
* // Set an expiry time relative to now.
|
||||||
|
* timer.expires_from_now(boost::posix_time::seconds(5));
|
||||||
|
*
|
||||||
|
* // Wait for the timer to expire.
|
||||||
|
* timer.wait();
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par
|
||||||
|
* Performing an asynchronous wait:
|
||||||
|
* @code
|
||||||
|
* void handler(const asio::error_code& error)
|
||||||
|
* {
|
||||||
|
* if (!error)
|
||||||
|
* {
|
||||||
|
* // Timer expired.
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* ...
|
||||||
|
*
|
||||||
|
* // Construct a timer with an absolute expiry time.
|
||||||
|
* asio::deadline_timer timer(my_context,
|
||||||
|
* boost::posix_time::time_from_string("2005-12-07 23:59:59.000"));
|
||||||
|
*
|
||||||
|
* // Start an asynchronous wait.
|
||||||
|
* timer.async_wait(handler);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Changing an active deadline_timer's expiry time
|
||||||
|
*
|
||||||
|
* Changing the expiry time of a timer while there are pending asynchronous
|
||||||
|
* waits causes those wait operations to be cancelled. To ensure that the action
|
||||||
|
* associated with the timer is performed only once, use something like this:
|
||||||
|
* used:
|
||||||
|
*
|
||||||
|
* @code
|
||||||
|
* void on_some_event()
|
||||||
|
* {
|
||||||
|
* if (my_timer.expires_from_now(seconds(5)) > 0)
|
||||||
|
* {
|
||||||
|
* // We managed to cancel the timer. Start new asynchronous wait.
|
||||||
|
* my_timer.async_wait(on_timeout);
|
||||||
|
* }
|
||||||
|
* else
|
||||||
|
* {
|
||||||
|
* // Too late, timer has already expired!
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* void on_timeout(const asio::error_code& e)
|
||||||
|
* {
|
||||||
|
* if (e != asio::error::operation_aborted)
|
||||||
|
* {
|
||||||
|
* // Timer was not cancelled, take necessary action.
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @li The asio::basic_deadline_timer::expires_from_now() function
|
||||||
|
* cancels any pending asynchronous waits, and returns the number of
|
||||||
|
* asynchronous waits that were cancelled. If it returns 0 then you were too
|
||||||
|
* late and the wait handler has already been executed, or will soon be
|
||||||
|
* executed. If it returns 1 then the wait handler was successfully cancelled.
|
||||||
|
*
|
||||||
|
* @li If a wait handler is cancelled, the asio::error_code passed to
|
||||||
|
* it contains the value asio::error::operation_aborted.
|
||||||
|
*/
|
||||||
|
template <typename Time,
|
||||||
|
typename TimeTraits = asio::time_traits<Time>,
|
||||||
|
typename Executor = any_io_executor>
|
||||||
|
class basic_deadline_timer
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_wait;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the timer type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The timer type when rebound to the specified executor.
|
||||||
|
typedef basic_deadline_timer<Time, TimeTraits, Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The time traits type.
|
||||||
|
typedef TimeTraits traits_type;
|
||||||
|
|
||||||
|
/// The time type.
|
||||||
|
typedef typename traits_type::time_type time_type;
|
||||||
|
|
||||||
|
/// The duration type.
|
||||||
|
typedef typename traits_type::duration_type duration_type;
|
||||||
|
|
||||||
|
/// Constructor.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer without setting an expiry time. The
|
||||||
|
* expires_at() or expires_from_now() functions must be called to set an
|
||||||
|
* expiry time before the timer can be waited on.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the timer will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the timer.
|
||||||
|
*/
|
||||||
|
explicit basic_deadline_timer(const executor_type& ex)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer without setting an expiry time. The
|
||||||
|
* expires_at() or expires_from_now() functions must be called to set an
|
||||||
|
* expiry time before the timer can be waited on.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the timer will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the timer.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_deadline_timer(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the timer will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, expressed
|
||||||
|
* as an absolute time.
|
||||||
|
*/
|
||||||
|
basic_deadline_timer(const executor_type& ex, const time_type& expiry_time)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_at(impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_at");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the timer will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, expressed
|
||||||
|
* as an absolute time.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_deadline_timer(ExecutionContext& context, const time_type& expiry_time,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_at(impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_at");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the timer will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, relative to
|
||||||
|
* now.
|
||||||
|
*/
|
||||||
|
basic_deadline_timer(const executor_type& ex,
|
||||||
|
const duration_type& expiry_time)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_from_now(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_from_now");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the timer will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, relative to
|
||||||
|
* now.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_deadline_timer(ExecutionContext& context,
|
||||||
|
const duration_type& expiry_time,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_from_now(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_from_now");
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_deadline_timer from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a timer from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_deadline_timer object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_deadline_timer(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_deadline_timer(basic_deadline_timer&& other)
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_deadline_timer from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a timer from one object to another. Cancels
|
||||||
|
* any outstanding asynchronous operations associated with the target object.
|
||||||
|
*
|
||||||
|
* @param other The other basic_deadline_timer object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_deadline_timer(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_deadline_timer& operator=(basic_deadline_timer&& other)
|
||||||
|
{
|
||||||
|
impl_ = std::move(other.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the timer.
|
||||||
|
/**
|
||||||
|
* This function destroys the timer, cancelling any outstanding asynchronous
|
||||||
|
* wait operations associated with the timer as if by calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_deadline_timer()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
const executor_type& get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel any asynchronous operations that are waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of any pending asynchronous wait
|
||||||
|
* operations against the timer. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel() is called, then the
|
||||||
|
* handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel any asynchronous operations that are waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of any pending asynchronous wait
|
||||||
|
* operations against the timer. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel() is called, then the
|
||||||
|
* handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancels one asynchronous operation that is waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of one pending asynchronous wait
|
||||||
|
* operation against the timer. Handlers are cancelled in FIFO order. The
|
||||||
|
* handler for the cancelled operation will be invoked with the
|
||||||
|
* asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled. That is,
|
||||||
|
* either 0 or 1.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel_one() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel_one()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().cancel_one(
|
||||||
|
impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel_one");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancels one asynchronous operation that is waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of one pending asynchronous wait
|
||||||
|
* operation against the timer. Handlers are cancelled in FIFO order. The
|
||||||
|
* handler for the cancelled operation will be invoked with the
|
||||||
|
* asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled. That is,
|
||||||
|
* either 0 or 1.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel_one() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel_one(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().cancel_one(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the timer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the timer's current expiry time.
|
||||||
|
* Whether the timer has expired or not does not affect this value.
|
||||||
|
*/
|
||||||
|
time_type expires_at() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_at(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the timer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_at() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_at(const time_type& expiry_time)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().expires_at(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_at");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the timer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_at() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_at(const time_type& expiry_time,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_at(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the timer's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the timer's current expiry time.
|
||||||
|
* Whether the timer has expired or not does not affect this value.
|
||||||
|
*/
|
||||||
|
duration_type expires_from_now() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_from_now(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the timer's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_from_now() is called,
|
||||||
|
* then the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_from_now(const duration_type& expiry_time)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().expires_from_now(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_from_now");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the timer's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_from_now() is called,
|
||||||
|
* then the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_from_now(const duration_type& expiry_time,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_from_now(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Perform a blocking wait on the timer.
|
||||||
|
/**
|
||||||
|
* This function is used to wait for the timer to expire. This function
|
||||||
|
* blocks and does not return until the timer has expired.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void wait()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().wait(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "wait");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Perform a blocking wait on the timer.
|
||||||
|
/**
|
||||||
|
* This function is used to wait for the timer to expire. This function
|
||||||
|
* blocks and does not return until the timer has expired.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
void wait(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().wait(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous wait on the timer.
|
||||||
|
/**
|
||||||
|
* This function may be used to initiate an asynchronous wait against the
|
||||||
|
* timer. It is an initiating function for an @ref asynchronous_operation,
|
||||||
|
* and always returns immediately.
|
||||||
|
*
|
||||||
|
* For each call to async_wait(), the completion handler will be called
|
||||||
|
* exactly once. The completion handler will be called when:
|
||||||
|
*
|
||||||
|
* @li The timer has expired.
|
||||||
|
*
|
||||||
|
* @li The timer was cancelled, in which case the handler is passed the error
|
||||||
|
* code asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the timer expires. Potential
|
||||||
|
* completion tokens include @ref use_future, @ref use_awaitable, @ref
|
||||||
|
* yield_context, or a function object with the correct completion signature.
|
||||||
|
* The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error // Result of operation.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code) @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* This asynchronous operation supports cancellation for the following
|
||||||
|
* asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code))
|
||||||
|
WaitToken ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WaitToken,
|
||||||
|
void (asio::error_code))
|
||||||
|
async_wait(
|
||||||
|
ASIO_MOVE_ARG(WaitToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WaitToken, void (asio::error_code)>(
|
||||||
|
declval<initiate_async_wait>(), token)))
|
||||||
|
{
|
||||||
|
return async_initiate<WaitToken, void (asio::error_code)>(
|
||||||
|
initiate_async_wait(this), token);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_deadline_timer(const basic_deadline_timer&) ASIO_DELETED;
|
||||||
|
basic_deadline_timer& operator=(
|
||||||
|
const basic_deadline_timer&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_wait
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_wait(basic_deadline_timer* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename WaitHandler>
|
||||||
|
void operator()(ASIO_MOVE_ARG(WaitHandler) handler) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a WaitHandler.
|
||||||
|
ASIO_WAIT_HANDLER_CHECK(WaitHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<WaitHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_wait(
|
||||||
|
self_->impl_.get_implementation(),
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_deadline_timer* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
detail::io_object_impl<
|
||||||
|
detail::deadline_timer_service<TimeTraits>, Executor> impl_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_DEADLINE_TIMER_HPP
|
829
lib/asio-1.26.0/asio/basic_file.hpp
Normal file
829
lib/asio-1.26.0/asio/basic_file.hpp
Normal file
|
@ -0,0 +1,829 @@
|
||||||
|
//
|
||||||
|
// basic_file.hpp
|
||||||
|
// ~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_FILE_HPP
|
||||||
|
#define ASIO_BASIC_FILE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_FILE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <string>
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/cstdint.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/io_object_impl.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/post.hpp"
|
||||||
|
#include "asio/file_base.hpp"
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
# include "asio/detail/win_iocp_file_service.hpp"
|
||||||
|
#elif defined(ASIO_HAS_IO_URING)
|
||||||
|
# include "asio/detail/io_uring_file_service.hpp"
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
# include <utility>
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_FILE_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_FILE_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Executor = any_io_executor>
|
||||||
|
class basic_file;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_FILE_FWD_DECL)
|
||||||
|
|
||||||
|
/// Provides file functionality.
|
||||||
|
/**
|
||||||
|
* The basic_file class template provides functionality that is common to both
|
||||||
|
* stream-oriented and random-access files.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*/
|
||||||
|
template <typename Executor>
|
||||||
|
class basic_file
|
||||||
|
: public file_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the file type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The file type when rebound to the specified executor.
|
||||||
|
typedef basic_file<Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The native representation of a file.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef implementation_defined native_handle_type;
|
||||||
|
#elif defined(ASIO_HAS_IOCP)
|
||||||
|
typedef detail::win_iocp_file_service::native_handle_type native_handle_type;
|
||||||
|
#elif defined(ASIO_HAS_IO_URING)
|
||||||
|
typedef detail::io_uring_file_service::native_handle_type native_handle_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct a basic_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file without opening it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*/
|
||||||
|
explicit basic_file(const executor_type& ex)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file without opening it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_file(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file and opens it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*/
|
||||||
|
explicit basic_file(const executor_type& ex,
|
||||||
|
const char* path, file_base::flags open_flags)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().open(impl_.get_implementation(), path, open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file and opens it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_file(ExecutionContext& context,
|
||||||
|
const char* path, file_base::flags open_flags,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().open(impl_.get_implementation(), path, open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file and opens it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*/
|
||||||
|
explicit basic_file(const executor_type& ex,
|
||||||
|
const std::string& path, file_base::flags open_flags)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().open(impl_.get_implementation(),
|
||||||
|
path.c_str(), open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file and opens it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_file(ExecutionContext& context,
|
||||||
|
const std::string& path, file_base::flags open_flags,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().open(impl_.get_implementation(),
|
||||||
|
path.c_str(), open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_file on an existing native file handle.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file object to hold an existing native file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param native_file A native file handle.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_file(const executor_type& ex, const native_handle_type& native_file)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(
|
||||||
|
impl_.get_implementation(), native_file, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_file on an existing native file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file object to hold an existing native file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param native_file A native file.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_file(ExecutionContext& context, const native_handle_type& native_file,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(
|
||||||
|
impl_.get_implementation(), native_file, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_file from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_file object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_file(const executor_type&) constructor.
|
||||||
|
*/
|
||||||
|
basic_file(basic_file&& other) ASIO_NOEXCEPT
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_file from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_file object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_file(const executor_type&) constructor.
|
||||||
|
*/
|
||||||
|
basic_file& operator=(basic_file&& other)
|
||||||
|
{
|
||||||
|
impl_ = std::move(other.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
// All files have access to each other's implementations.
|
||||||
|
template <typename Executor1>
|
||||||
|
friend class basic_file;
|
||||||
|
|
||||||
|
/// Move-construct a basic_file from a file of another executor type.
|
||||||
|
/**
|
||||||
|
* This constructor moves a file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_file object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_file(const executor_type&) constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
basic_file(basic_file<Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_file from a file of another executor type.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_file object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_file(const executor_type&) constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_file&
|
||||||
|
>::type operator=(basic_file<Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_file tmp(std::move(other));
|
||||||
|
impl_ = std::move(tmp.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
const executor_type& get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Open the file using the specified path.
|
||||||
|
/**
|
||||||
|
* This function opens the file so that it will use the specified path.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::stream_file file(my_context);
|
||||||
|
* file.open("/path/to/my/file", asio::stream_file::read_only);
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
void open(const char* path, file_base::flags open_flags)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().open(impl_.get_implementation(), path, open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Open the file using the specified path.
|
||||||
|
/**
|
||||||
|
* This function opens the file so that it will use the specified path.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::stream_file file(my_context);
|
||||||
|
* asio::error_code ec;
|
||||||
|
* file.open("/path/to/my/file", asio::stream_file::read_only, ec);
|
||||||
|
* if (ec)
|
||||||
|
* {
|
||||||
|
* // An error occurred.
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID open(const char* path,
|
||||||
|
file_base::flags open_flags, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().open(impl_.get_implementation(), path, open_flags, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Open the file using the specified path.
|
||||||
|
/**
|
||||||
|
* This function opens the file so that it will use the specified path.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::stream_file file(my_context);
|
||||||
|
* file.open("/path/to/my/file", asio::stream_file::read_only);
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
void open(const std::string& path, file_base::flags open_flags)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().open(impl_.get_implementation(),
|
||||||
|
path.c_str(), open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Open the file using the specified path.
|
||||||
|
/**
|
||||||
|
* This function opens the file so that it will use the specified path.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::stream_file file(my_context);
|
||||||
|
* asio::error_code ec;
|
||||||
|
* file.open("/path/to/my/file", asio::stream_file::read_only, ec);
|
||||||
|
* if (ec)
|
||||||
|
* {
|
||||||
|
* // An error occurred.
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID open(const std::string& path,
|
||||||
|
file_base::flags open_flags, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().open(impl_.get_implementation(),
|
||||||
|
path.c_str(), open_flags, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Assign an existing native file to the file.
|
||||||
|
/*
|
||||||
|
* This function opens the file to hold an existing native file.
|
||||||
|
*
|
||||||
|
* @param native_file A native file.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void assign(const native_handle_type& native_file)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(
|
||||||
|
impl_.get_implementation(), native_file, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Assign an existing native file to the file.
|
||||||
|
/*
|
||||||
|
* This function opens the file to hold an existing native file.
|
||||||
|
*
|
||||||
|
* @param native_file A native file.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID assign(const native_handle_type& native_file,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().assign(
|
||||||
|
impl_.get_implementation(), native_file, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine whether the file is open.
|
||||||
|
bool is_open() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().is_open(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the file.
|
||||||
|
/**
|
||||||
|
* This function is used to close the file. Any asynchronous read or write
|
||||||
|
* operations will be cancelled immediately, and will complete with the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. Note that, even if
|
||||||
|
* the function indicates an error, the underlying descriptor is closed.
|
||||||
|
*/
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "close");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the file.
|
||||||
|
/**
|
||||||
|
* This function is used to close the file. Any asynchronous read or write
|
||||||
|
* operations will be cancelled immediately, and will complete with the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any. Note that, even if
|
||||||
|
* the function indicates an error, the underlying descriptor is closed.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::stream_file file(my_context);
|
||||||
|
* ...
|
||||||
|
* asio::error_code ec;
|
||||||
|
* file.close(ec);
|
||||||
|
* if (ec)
|
||||||
|
* {
|
||||||
|
* // An error occurred.
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Release ownership of the underlying native file.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read and write
|
||||||
|
* operations to finish immediately, and the handlers for cancelled
|
||||||
|
* operations will be passed the asio::error::operation_aborted error.
|
||||||
|
* Ownership of the native file is then transferred to the caller.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note This function is unsupported on Windows versions prior to Windows
|
||||||
|
* 8.1, and will fail with asio::error::operation_not_supported on
|
||||||
|
* these platforms.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0603)
|
||||||
|
__declspec(deprecated("This function always fails with "
|
||||||
|
"operation_not_supported when used on Windows versions "
|
||||||
|
"prior to Windows 8.1."))
|
||||||
|
#endif
|
||||||
|
native_handle_type release()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
native_handle_type s = impl_.get_service().release(
|
||||||
|
impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "release");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Release ownership of the underlying native file.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read and write
|
||||||
|
* operations to finish immediately, and the handlers for cancelled
|
||||||
|
* operations will be passed the asio::error::operation_aborted error.
|
||||||
|
* Ownership of the native file is then transferred to the caller.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note This function is unsupported on Windows versions prior to Windows
|
||||||
|
* 8.1, and will fail with asio::error::operation_not_supported on
|
||||||
|
* these platforms.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0603)
|
||||||
|
__declspec(deprecated("This function always fails with "
|
||||||
|
"operation_not_supported when used on Windows versions "
|
||||||
|
"prior to Windows 8.1."))
|
||||||
|
#endif
|
||||||
|
native_handle_type release(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().release(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the native file representation.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the underlying representation of the
|
||||||
|
* file. This is intended to allow access to native file functionality
|
||||||
|
* that is not otherwise provided.
|
||||||
|
*/
|
||||||
|
native_handle_type native_handle()
|
||||||
|
{
|
||||||
|
return impl_.get_service().native_handle(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all asynchronous operations associated with the file.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read and write
|
||||||
|
* operations to finish immediately, and the handlers for cancelled
|
||||||
|
* operations will be passed the asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note Calls to cancel() will always fail with
|
||||||
|
* asio::error::operation_not_supported when run on Windows XP, Windows
|
||||||
|
* Server 2003, and earlier versions of Windows, unless
|
||||||
|
* ASIO_ENABLE_CANCELIO is defined. However, the CancelIo function has
|
||||||
|
* two issues that should be considered before enabling its use:
|
||||||
|
*
|
||||||
|
* @li It will only cancel asynchronous operations that were initiated in the
|
||||||
|
* current thread.
|
||||||
|
*
|
||||||
|
* @li It can appear to complete without error, but the request to cancel the
|
||||||
|
* unfinished operations may be silently ignored by the operating system.
|
||||||
|
* Whether it works or not seems to depend on the drivers that are installed.
|
||||||
|
*
|
||||||
|
* For portable cancellation, consider using the close() function to
|
||||||
|
* simultaneously cancel the outstanding operations and close the file.
|
||||||
|
*
|
||||||
|
* When running on Windows Vista, Windows Server 2008, and later, the
|
||||||
|
* CancelIoEx function is always used. This function does not have the
|
||||||
|
* problems described above.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0600) \
|
||||||
|
&& !defined(ASIO_ENABLE_CANCELIO)
|
||||||
|
__declspec(deprecated("By default, this function always fails with "
|
||||||
|
"operation_not_supported when used on Windows XP, Windows Server 2003, "
|
||||||
|
"or earlier. Consult documentation for details."))
|
||||||
|
#endif
|
||||||
|
void cancel()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all asynchronous operations associated with the file.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read and write
|
||||||
|
* operations to finish immediately, and the handlers for cancelled
|
||||||
|
* operations will be passed the asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note Calls to cancel() will always fail with
|
||||||
|
* asio::error::operation_not_supported when run on Windows XP, Windows
|
||||||
|
* Server 2003, and earlier versions of Windows, unless
|
||||||
|
* ASIO_ENABLE_CANCELIO is defined. However, the CancelIo function has
|
||||||
|
* two issues that should be considered before enabling its use:
|
||||||
|
*
|
||||||
|
* @li It will only cancel asynchronous operations that were initiated in the
|
||||||
|
* current thread.
|
||||||
|
*
|
||||||
|
* @li It can appear to complete without error, but the request to cancel the
|
||||||
|
* unfinished operations may be silently ignored by the operating system.
|
||||||
|
* Whether it works or not seems to depend on the drivers that are installed.
|
||||||
|
*
|
||||||
|
* For portable cancellation, consider using the close() function to
|
||||||
|
* simultaneously cancel the outstanding operations and close the file.
|
||||||
|
*
|
||||||
|
* When running on Windows Vista, Windows Server 2008, and later, the
|
||||||
|
* CancelIoEx function is always used. This function does not have the
|
||||||
|
* problems described above.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0600) \
|
||||||
|
&& !defined(ASIO_ENABLE_CANCELIO)
|
||||||
|
__declspec(deprecated("By default, this function always fails with "
|
||||||
|
"operation_not_supported when used on Windows XP, Windows Server 2003, "
|
||||||
|
"or earlier. Consult documentation for details."))
|
||||||
|
#endif
|
||||||
|
ASIO_SYNC_OP_VOID cancel(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the size of the file.
|
||||||
|
/**
|
||||||
|
* This function determines the size of the file, in bytes.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
uint64_t size() const
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
uint64_t s = impl_.get_service().size(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "size");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the size of the file.
|
||||||
|
/**
|
||||||
|
* This function determines the size of the file, in bytes.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
uint64_t size(asio::error_code& ec) const
|
||||||
|
{
|
||||||
|
return impl_.get_service().size(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Alter the size of the file.
|
||||||
|
/**
|
||||||
|
* This function resizes the file to the specified size, in bytes. If the
|
||||||
|
* current file size exceeds @c n then any extra data is discarded. If the
|
||||||
|
* current size is less than @c n then the file is extended and filled with
|
||||||
|
* zeroes.
|
||||||
|
*
|
||||||
|
* @param n The new size for the file.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void resize(uint64_t n)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().resize(impl_.get_implementation(), n, ec);
|
||||||
|
asio::detail::throw_error(ec, "resize");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Alter the size of the file.
|
||||||
|
/**
|
||||||
|
* This function resizes the file to the specified size, in bytes. If the
|
||||||
|
* current file size exceeds @c n then any extra data is discarded. If the
|
||||||
|
* current size is less than @c n then the file is extended and filled with
|
||||||
|
* zeroes.
|
||||||
|
*
|
||||||
|
* @param n The new size for the file.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID resize(uint64_t n, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().resize(impl_.get_implementation(), n, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Synchronise the file to disk.
|
||||||
|
/**
|
||||||
|
* This function synchronises the file data and metadata to disk. Note that
|
||||||
|
* the semantics of this synchronisation vary between operation systems.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void sync_all()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().sync_all(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "sync_all");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Synchronise the file to disk.
|
||||||
|
/**
|
||||||
|
* This function synchronises the file data and metadata to disk. Note that
|
||||||
|
* the semantics of this synchronisation vary between operation systems.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID sync_all(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().sync_all(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Synchronise the file data to disk.
|
||||||
|
/**
|
||||||
|
* This function synchronises the file data to disk. Note that the semantics
|
||||||
|
* of this synchronisation vary between operation systems.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void sync_data()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().sync_data(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "sync_data");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Synchronise the file data to disk.
|
||||||
|
/**
|
||||||
|
* This function synchronises the file data to disk. Note that the semantics
|
||||||
|
* of this synchronisation vary between operation systems.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID sync_data(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().sync_data(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
/// Protected destructor to prevent deletion through this type.
|
||||||
|
/**
|
||||||
|
* This function destroys the file, cancelling any outstanding asynchronous
|
||||||
|
* operations associated with the file as if by calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_file()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
detail::io_object_impl<detail::win_iocp_file_service, Executor> impl_;
|
||||||
|
#elif defined(ASIO_HAS_IO_URING)
|
||||||
|
detail::io_object_impl<detail::io_uring_file_service, Executor> impl_;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_file(const basic_file&) ASIO_DELETED;
|
||||||
|
basic_file& operator=(const basic_file&) ASIO_DELETED;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_FILE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_FILE_HPP
|
290
lib/asio-1.26.0/asio/basic_io_object.hpp
Normal file
290
lib/asio-1.26.0/asio/basic_io_object.hpp
Normal file
|
@ -0,0 +1,290 @@
|
||||||
|
//
|
||||||
|
// basic_io_object.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_IO_OBJECT_HPP
|
||||||
|
#define ASIO_BASIC_IO_OBJECT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/io_context.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
namespace detail
|
||||||
|
{
|
||||||
|
// Type trait used to determine whether a service supports move.
|
||||||
|
template <typename IoObjectService>
|
||||||
|
class service_has_move
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
typedef IoObjectService service_type;
|
||||||
|
typedef typename service_type::implementation_type implementation_type;
|
||||||
|
|
||||||
|
template <typename T, typename U>
|
||||||
|
static auto asio_service_has_move_eval(T* t, U* u)
|
||||||
|
-> decltype(t->move_construct(*u, *u), char());
|
||||||
|
static char (&asio_service_has_move_eval(...))[2];
|
||||||
|
|
||||||
|
public:
|
||||||
|
static const bool value =
|
||||||
|
sizeof(asio_service_has_move_eval(
|
||||||
|
static_cast<service_type*>(0),
|
||||||
|
static_cast<implementation_type*>(0))) == 1;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
/// Base class for all I/O objects.
|
||||||
|
/**
|
||||||
|
* @note All I/O objects are non-copyable. However, when using C++0x, certain
|
||||||
|
* I/O objects do support move construction and move assignment.
|
||||||
|
*/
|
||||||
|
#if !defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename IoObjectService>
|
||||||
|
#else
|
||||||
|
template <typename IoObjectService,
|
||||||
|
bool Movable = detail::service_has_move<IoObjectService>::value>
|
||||||
|
#endif
|
||||||
|
class basic_io_object
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the service that will be used to provide I/O operations.
|
||||||
|
typedef IoObjectService service_type;
|
||||||
|
|
||||||
|
/// The underlying implementation type of I/O object.
|
||||||
|
typedef typename service_type::implementation_type implementation_type;
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use get_executor().) Get the io_context associated with the
|
||||||
|
/// object.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the io_context object that the I/O
|
||||||
|
* object uses to dispatch handlers for asynchronous operations.
|
||||||
|
*
|
||||||
|
* @return A reference to the io_context object that the I/O object will use
|
||||||
|
* to dispatch handlers. Ownership is not transferred to the caller.
|
||||||
|
*/
|
||||||
|
asio::io_context& get_io_context()
|
||||||
|
{
|
||||||
|
return service_.get_io_context();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use get_executor().) Get the io_context associated with the
|
||||||
|
/// object.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the io_context object that the I/O
|
||||||
|
* object uses to dispatch handlers for asynchronous operations.
|
||||||
|
*
|
||||||
|
* @return A reference to the io_context object that the I/O object will use
|
||||||
|
* to dispatch handlers. Ownership is not transferred to the caller.
|
||||||
|
*/
|
||||||
|
asio::io_context& get_io_service()
|
||||||
|
{
|
||||||
|
return service_.get_io_context();
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef asio::io_context::executor_type executor_type;
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
executor_type get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return service_.get_io_context().get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
/// Construct a basic_io_object.
|
||||||
|
/**
|
||||||
|
* Performs:
|
||||||
|
* @code get_service().construct(get_implementation()); @endcode
|
||||||
|
*/
|
||||||
|
explicit basic_io_object(asio::io_context& io_context)
|
||||||
|
: service_(asio::use_service<IoObjectService>(io_context))
|
||||||
|
{
|
||||||
|
service_.construct(implementation_);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_io_object.
|
||||||
|
/**
|
||||||
|
* Performs:
|
||||||
|
* @code get_service().move_construct(
|
||||||
|
* get_implementation(), other.get_implementation()); @endcode
|
||||||
|
*
|
||||||
|
* @note Available only for services that support movability,
|
||||||
|
*/
|
||||||
|
basic_io_object(basic_io_object&& other);
|
||||||
|
|
||||||
|
/// Move-assign a basic_io_object.
|
||||||
|
/**
|
||||||
|
* Performs:
|
||||||
|
* @code get_service().move_assign(get_implementation(),
|
||||||
|
* other.get_service(), other.get_implementation()); @endcode
|
||||||
|
*
|
||||||
|
* @note Available only for services that support movability,
|
||||||
|
*/
|
||||||
|
basic_io_object& operator=(basic_io_object&& other);
|
||||||
|
|
||||||
|
/// Perform a converting move-construction of a basic_io_object.
|
||||||
|
template <typename IoObjectService1>
|
||||||
|
basic_io_object(IoObjectService1& other_service,
|
||||||
|
typename IoObjectService1::implementation_type& other_implementation);
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Protected destructor to prevent deletion through this type.
|
||||||
|
/**
|
||||||
|
* Performs:
|
||||||
|
* @code get_service().destroy(get_implementation()); @endcode
|
||||||
|
*/
|
||||||
|
~basic_io_object()
|
||||||
|
{
|
||||||
|
service_.destroy(implementation_);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the service associated with the I/O object.
|
||||||
|
service_type& get_service()
|
||||||
|
{
|
||||||
|
return service_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the service associated with the I/O object.
|
||||||
|
const service_type& get_service() const
|
||||||
|
{
|
||||||
|
return service_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the underlying implementation of the I/O object.
|
||||||
|
implementation_type& get_implementation()
|
||||||
|
{
|
||||||
|
return implementation_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the underlying implementation of the I/O object.
|
||||||
|
const implementation_type& get_implementation() const
|
||||||
|
{
|
||||||
|
return implementation_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_io_object(const basic_io_object&);
|
||||||
|
basic_io_object& operator=(const basic_io_object&);
|
||||||
|
|
||||||
|
// The service associated with the I/O object.
|
||||||
|
service_type& service_;
|
||||||
|
|
||||||
|
/// The underlying implementation of the I/O object.
|
||||||
|
implementation_type implementation_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
// Specialisation for movable objects.
|
||||||
|
template <typename IoObjectService>
|
||||||
|
class basic_io_object<IoObjectService, true>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef IoObjectService service_type;
|
||||||
|
typedef typename service_type::implementation_type implementation_type;
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
asio::io_context& get_io_context()
|
||||||
|
{
|
||||||
|
return service_->get_io_context();
|
||||||
|
}
|
||||||
|
|
||||||
|
asio::io_context& get_io_service()
|
||||||
|
{
|
||||||
|
return service_->get_io_context();
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
typedef asio::io_context::executor_type executor_type;
|
||||||
|
|
||||||
|
executor_type get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return service_->get_io_context().get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
explicit basic_io_object(asio::io_context& io_context)
|
||||||
|
: service_(&asio::use_service<IoObjectService>(io_context))
|
||||||
|
{
|
||||||
|
service_->construct(implementation_);
|
||||||
|
}
|
||||||
|
|
||||||
|
basic_io_object(basic_io_object&& other)
|
||||||
|
: service_(&other.get_service())
|
||||||
|
{
|
||||||
|
service_->move_construct(implementation_, other.implementation_);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename IoObjectService1>
|
||||||
|
basic_io_object(IoObjectService1& other_service,
|
||||||
|
typename IoObjectService1::implementation_type& other_implementation)
|
||||||
|
: service_(&asio::use_service<IoObjectService>(
|
||||||
|
other_service.get_io_context()))
|
||||||
|
{
|
||||||
|
service_->converting_move_construct(implementation_,
|
||||||
|
other_service, other_implementation);
|
||||||
|
}
|
||||||
|
|
||||||
|
~basic_io_object()
|
||||||
|
{
|
||||||
|
service_->destroy(implementation_);
|
||||||
|
}
|
||||||
|
|
||||||
|
basic_io_object& operator=(basic_io_object&& other)
|
||||||
|
{
|
||||||
|
service_->move_assign(implementation_,
|
||||||
|
*other.service_, other.implementation_);
|
||||||
|
service_ = other.service_;
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
service_type& get_service()
|
||||||
|
{
|
||||||
|
return *service_;
|
||||||
|
}
|
||||||
|
|
||||||
|
const service_type& get_service() const
|
||||||
|
{
|
||||||
|
return *service_;
|
||||||
|
}
|
||||||
|
|
||||||
|
implementation_type& get_implementation()
|
||||||
|
{
|
||||||
|
return implementation_;
|
||||||
|
}
|
||||||
|
|
||||||
|
const implementation_type& get_implementation() const
|
||||||
|
{
|
||||||
|
return implementation_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_io_object(const basic_io_object&);
|
||||||
|
void operator=(const basic_io_object&);
|
||||||
|
|
||||||
|
IoObjectService* service_;
|
||||||
|
implementation_type implementation_;
|
||||||
|
};
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_IO_OBJECT_HPP
|
701
lib/asio-1.26.0/asio/basic_random_access_file.hpp
Normal file
701
lib/asio-1.26.0/asio/basic_random_access_file.hpp
Normal file
|
@ -0,0 +1,701 @@
|
||||||
|
//
|
||||||
|
// basic_random_access_file.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_RANDOM_ACCESS_FILE_HPP
|
||||||
|
#define ASIO_BASIC_RANDOM_ACCESS_FILE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_FILE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/basic_file.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_RANDOM_ACCESS_FILE_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_RANDOM_ACCESS_FILE_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Executor = any_io_executor>
|
||||||
|
class basic_random_access_file;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_RANDOM_ACCESS_FILE_FWD_DECL)
|
||||||
|
|
||||||
|
/// Provides random-access file functionality.
|
||||||
|
/**
|
||||||
|
* The basic_random_access_file class template provides asynchronous and
|
||||||
|
* blocking random-access file functionality.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* Synchronous @c read_some_at and @c write_some_at operations are thread safe
|
||||||
|
* with respect to each other, if the underlying operating system calls are
|
||||||
|
* also thread safe. This means that it is permitted to perform concurrent
|
||||||
|
* calls to these synchronous operations on a single file object. Other
|
||||||
|
* synchronous operations, such as @c open or @c close, are not thread safe.
|
||||||
|
*/
|
||||||
|
template <typename Executor>
|
||||||
|
class basic_random_access_file
|
||||||
|
: public basic_file<Executor>
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_write_some_at;
|
||||||
|
class initiate_async_read_some_at;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the file type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The file type when rebound to the specified executor.
|
||||||
|
typedef basic_random_access_file<Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The native representation of a file.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef implementation_defined native_handle_type;
|
||||||
|
#else
|
||||||
|
typedef typename basic_file<Executor>::native_handle_type native_handle_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct a basic_random_access_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file without opening it. The file needs to
|
||||||
|
* be opened before data can be read from or or written to it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*/
|
||||||
|
explicit basic_random_access_file(const executor_type& ex)
|
||||||
|
: basic_file<Executor>(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_random_access_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file without opening it. The file needs to
|
||||||
|
* be opened before data can be read from or or written to it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_random_access_file(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_random_access_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_random_access_file(const executor_type& ex,
|
||||||
|
const char* path, file_base::flags open_flags)
|
||||||
|
: basic_file<Executor>(ex, path, open_flags)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_random_access_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_random_access_file(ExecutionContext& context,
|
||||||
|
const char* path, file_base::flags open_flags,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context, path, open_flags)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_random_access_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_random_access_file(const executor_type& ex,
|
||||||
|
const std::string& path, file_base::flags open_flags)
|
||||||
|
: basic_file<Executor>(ex, path, open_flags)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_random_access_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_random_access_file(ExecutionContext& context,
|
||||||
|
const std::string& path, file_base::flags open_flags,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context, path, open_flags)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_random_access_file on an existing native file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a random-access file object to hold an
|
||||||
|
* existing native file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param native_file The new underlying file implementation.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_random_access_file(const executor_type& ex,
|
||||||
|
const native_handle_type& native_file)
|
||||||
|
: basic_file<Executor>(ex, native_file)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_random_access_file on an existing native file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a random-access file object to hold an
|
||||||
|
* existing native file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param native_file The new underlying file implementation.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_random_access_file(ExecutionContext& context,
|
||||||
|
const native_handle_type& native_file,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context, native_file)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_random_access_file from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a random-access file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_random_access_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_random_access_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_random_access_file(basic_random_access_file&& other) ASIO_NOEXCEPT
|
||||||
|
: basic_file<Executor>(std::move(other))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_random_access_file from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a random-access file from one object to
|
||||||
|
* another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_random_access_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_random_access_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_random_access_file& operator=(basic_random_access_file&& other)
|
||||||
|
{
|
||||||
|
basic_file<Executor>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-construct a basic_random_access_file from a file of another executor
|
||||||
|
/// type.
|
||||||
|
/**
|
||||||
|
* This constructor moves a random-access file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_random_access_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_random_access_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
basic_random_access_file(basic_random_access_file<Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(std::move(other))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_random_access_file from a file of another executor
|
||||||
|
/// type.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a random-access file from one object to
|
||||||
|
* another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_random_access_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_random_access_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_random_access_file&
|
||||||
|
>::type operator=(basic_random_access_file<Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_file<Executor>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the file.
|
||||||
|
/**
|
||||||
|
* This function destroys the file, cancelling any outstanding asynchronous
|
||||||
|
* operations associated with the file as if by calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_random_access_file()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write some data to the handle at the specified offset.
|
||||||
|
/**
|
||||||
|
* This function is used to write data to the random-access handle. The
|
||||||
|
* function call will block until one or more bytes of the data has been
|
||||||
|
* written successfully, or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param offset The offset at which the data will be written.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the handle.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes written.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the end of the file was reached.
|
||||||
|
*
|
||||||
|
* @note The write_some_at operation may not write all of the data. Consider
|
||||||
|
* using the @ref write_at function if you need to ensure that all data is
|
||||||
|
* written before the blocking operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To write a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* handle.write_some_at(42, asio::buffer(data, size));
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on writing multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some_at(uint64_t offset,
|
||||||
|
const ConstBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().write_some_at(
|
||||||
|
this->impl_.get_implementation(), offset, buffers, ec);
|
||||||
|
asio::detail::throw_error(ec, "write_some_at");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write some data to the handle at the specified offset.
|
||||||
|
/**
|
||||||
|
* This function is used to write data to the random-access handle. The
|
||||||
|
* function call will block until one or more bytes of the data has been
|
||||||
|
* written successfully, or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param offset The offset at which the data will be written.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the handle.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes written. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The write_some operation may not write all of the data to the
|
||||||
|
* file. Consider using the @ref write_at function if you need to ensure that
|
||||||
|
* all data is written before the blocking operation completes.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some_at(uint64_t offset,
|
||||||
|
const ConstBufferSequence& buffers, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().write_some_at(
|
||||||
|
this->impl_.get_implementation(), offset, buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous write at the specified offset.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously write data to the random-access
|
||||||
|
* handle. It is an initiating function for an @ref asynchronous_operation,
|
||||||
|
* and always returns immediately.
|
||||||
|
*
|
||||||
|
* @param offset The offset at which the data will be written.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the handle.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the write completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes written.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @note The write operation may not write all of the data to the file.
|
||||||
|
* Consider using the @ref async_write_at function if you need to ensure that
|
||||||
|
* all data is written before the asynchronous operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To write a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* handle.async_write_some_at(42, asio::buffer(data, size), handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on writing multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* This asynchronous operation supports cancellation for the following
|
||||||
|
* asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_write_some_at(uint64_t offset,
|
||||||
|
const ConstBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(WriteToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_write_some_at>(), token, offset, buffers)))
|
||||||
|
{
|
||||||
|
return async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_write_some_at(this), token, offset, buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the handle at the specified offset.
|
||||||
|
/**
|
||||||
|
* This function is used to read data from the random-access handle. The
|
||||||
|
* function call will block until one or more bytes of data has been read
|
||||||
|
* successfully, or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param offset The offset at which the data will be read.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes read.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the end of the file was reached.
|
||||||
|
*
|
||||||
|
* @note The read_some operation may not read all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read_at function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the blocking operation
|
||||||
|
* completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To read into a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* handle.read_some_at(42, asio::buffer(data, size));
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on reading into multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some_at(uint64_t offset,
|
||||||
|
const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().read_some_at(
|
||||||
|
this->impl_.get_implementation(), offset, buffers, ec);
|
||||||
|
asio::detail::throw_error(ec, "read_some_at");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the handle at the specified offset.
|
||||||
|
/**
|
||||||
|
* This function is used to read data from the random-access handle. The
|
||||||
|
* function call will block until one or more bytes of data has been read
|
||||||
|
* successfully, or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param offset The offset at which the data will be read.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes read. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The read_some operation may not read all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read_at function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the blocking operation
|
||||||
|
* completes.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some_at(uint64_t offset,
|
||||||
|
const MutableBufferSequence& buffers, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().read_some_at(
|
||||||
|
this->impl_.get_implementation(), offset, buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous read at the specified offset.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously read data from the random-access
|
||||||
|
* handle. It is an initiating function for an @ref asynchronous_operation,
|
||||||
|
* and always returns immediately.
|
||||||
|
*
|
||||||
|
* @param offset The offset at which the data will be read.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the read completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes read.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @note The read operation may not read all of the requested number of bytes.
|
||||||
|
* Consider using the @ref async_read_at function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the asynchronous operation
|
||||||
|
* completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To read into a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* handle.async_read_some_at(42, asio::buffer(data, size), handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on reading into multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* This asynchronous operation supports cancellation for the following
|
||||||
|
* asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_read_some_at(uint64_t offset,
|
||||||
|
const MutableBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(ReadToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_read_some_at>(), token, offset, buffers)))
|
||||||
|
{
|
||||||
|
return async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_read_some_at(this), token, offset, buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_random_access_file(const basic_random_access_file&) ASIO_DELETED;
|
||||||
|
basic_random_access_file& operator=(
|
||||||
|
const basic_random_access_file&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_write_some_at
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_write_some_at(basic_random_access_file* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename WriteHandler, typename ConstBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(WriteHandler) handler,
|
||||||
|
uint64_t offset, const ConstBufferSequence& buffers) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a WriteHandler.
|
||||||
|
ASIO_WRITE_HANDLER_CHECK(WriteHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<WriteHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_write_some_at(
|
||||||
|
self_->impl_.get_implementation(), offset, buffers,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_random_access_file* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class initiate_async_read_some_at
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_read_some_at(basic_random_access_file* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename ReadHandler, typename MutableBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(ReadHandler) handler,
|
||||||
|
uint64_t offset, const MutableBufferSequence& buffers) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a ReadHandler.
|
||||||
|
ASIO_READ_HANDLER_CHECK(ReadHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<ReadHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_read_some_at(
|
||||||
|
self_->impl_.get_implementation(), offset, buffers,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_random_access_file* self_;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_FILE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_RANDOM_ACCESS_FILE_HPP
|
1387
lib/asio-1.26.0/asio/basic_raw_socket.hpp
Normal file
1387
lib/asio-1.26.0/asio/basic_raw_socket.hpp
Normal file
File diff suppressed because it is too large
Load diff
635
lib/asio-1.26.0/asio/basic_readable_pipe.hpp
Normal file
635
lib/asio-1.26.0/asio/basic_readable_pipe.hpp
Normal file
|
@ -0,0 +1,635 @@
|
||||||
|
//
|
||||||
|
// basic_readable_pipe.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_READABLE_PIPE_HPP
|
||||||
|
#define ASIO_BASIC_READABLE_PIPE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_PIPE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <string>
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/io_object_impl.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
# include "asio/detail/win_iocp_handle_service.hpp"
|
||||||
|
#elif defined(ASIO_HAS_IO_URING_AS_DEFAULT)
|
||||||
|
# include "asio/detail/io_uring_descriptor_service.hpp"
|
||||||
|
#else
|
||||||
|
# include "asio/detail/reactive_descriptor_service.hpp"
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
# include <utility>
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Provides pipe functionality.
|
||||||
|
/**
|
||||||
|
* The basic_readable_pipe class provides a wrapper over pipe
|
||||||
|
* functionality.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*/
|
||||||
|
template <typename Executor = any_io_executor>
|
||||||
|
class basic_readable_pipe
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_read_some;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the pipe type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The pipe type when rebound to the specified executor.
|
||||||
|
typedef basic_readable_pipe<Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The native representation of a pipe.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef implementation_defined native_handle_type;
|
||||||
|
#elif defined(ASIO_HAS_IOCP)
|
||||||
|
typedef detail::win_iocp_handle_service::native_handle_type
|
||||||
|
native_handle_type;
|
||||||
|
#elif defined(ASIO_HAS_IO_URING_AS_DEFAULT)
|
||||||
|
typedef detail::io_uring_descriptor_service::native_handle_type
|
||||||
|
native_handle_type;
|
||||||
|
#else
|
||||||
|
typedef detail::reactive_descriptor_service::native_handle_type
|
||||||
|
native_handle_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// A basic_readable_pipe is always the lowest layer.
|
||||||
|
typedef basic_readable_pipe lowest_layer_type;
|
||||||
|
|
||||||
|
/// Construct a basic_readable_pipe without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe without opening it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the pipe will use, by default, to dispatch
|
||||||
|
* handlers for any asynchronous operations performed on the pipe.
|
||||||
|
*/
|
||||||
|
explicit basic_readable_pipe(const executor_type& ex)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_readable_pipe without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe without opening it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the pipe will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the pipe.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_readable_pipe(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_readable_pipe on an existing native pipe.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe object to hold an existing native
|
||||||
|
* pipe.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the pipe will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the
|
||||||
|
* pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_readable_pipe(const executor_type& ex,
|
||||||
|
const native_handle_type& native_pipe)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(),
|
||||||
|
native_pipe, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_readable_pipe on an existing native pipe.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe object to hold an existing native
|
||||||
|
* pipe.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the pipe will use, by default, to dispatch handlers for any
|
||||||
|
* asynchronous operations performed on the pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_readable_pipe(ExecutionContext& context,
|
||||||
|
const native_handle_type& native_pipe,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(),
|
||||||
|
native_pipe, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_readable_pipe from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_readable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_readable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_readable_pipe(basic_readable_pipe&& other)
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_readable_pipe from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_readable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_readable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_readable_pipe& operator=(basic_readable_pipe&& other)
|
||||||
|
{
|
||||||
|
impl_ = std::move(other.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
// All pipes have access to each other's implementations.
|
||||||
|
template <typename Executor1>
|
||||||
|
friend class basic_readable_pipe;
|
||||||
|
|
||||||
|
/// Move-construct a basic_readable_pipe from a pipe of another executor type.
|
||||||
|
/**
|
||||||
|
* This constructor moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_readable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_readable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
basic_readable_pipe(basic_readable_pipe<Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_readable_pipe from a pipe of another executor type.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_readable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_readable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_readable_pipe&
|
||||||
|
>::type operator=(basic_readable_pipe<Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_readable_pipe tmp(std::move(other));
|
||||||
|
impl_ = std::move(tmp.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the pipe.
|
||||||
|
/**
|
||||||
|
* This function destroys the pipe, cancelling any outstanding
|
||||||
|
* asynchronous wait operations associated with the pipe as if by
|
||||||
|
* calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_readable_pipe()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
const executor_type& get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the lowest layer.
|
||||||
|
/**
|
||||||
|
* This function returns a reference to the lowest layer in a stack of
|
||||||
|
* layers. Since a basic_readable_pipe cannot contain any further layers, it
|
||||||
|
* simply returns a reference to itself.
|
||||||
|
*
|
||||||
|
* @return A reference to the lowest layer in the stack of layers. Ownership
|
||||||
|
* is not transferred to the caller.
|
||||||
|
*/
|
||||||
|
lowest_layer_type& lowest_layer()
|
||||||
|
{
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a const reference to the lowest layer.
|
||||||
|
/**
|
||||||
|
* This function returns a const reference to the lowest layer in a stack of
|
||||||
|
* layers. Since a basic_readable_pipe cannot contain any further layers, it
|
||||||
|
* simply returns a reference to itself.
|
||||||
|
*
|
||||||
|
* @return A const reference to the lowest layer in the stack of layers.
|
||||||
|
* Ownership is not transferred to the caller.
|
||||||
|
*/
|
||||||
|
const lowest_layer_type& lowest_layer() const
|
||||||
|
{
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Assign an existing native pipe to the pipe.
|
||||||
|
/*
|
||||||
|
* This function opens the pipe to hold an existing native pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void assign(const native_handle_type& native_pipe)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(), native_pipe, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Assign an existing native pipe to the pipe.
|
||||||
|
/*
|
||||||
|
* This function opens the pipe to hold an existing native pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID assign(const native_handle_type& native_pipe,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(), native_pipe, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine whether the pipe is open.
|
||||||
|
bool is_open() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().is_open(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to close the pipe. Any asynchronous read operations
|
||||||
|
* will be cancelled immediately, and will complete with the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "close");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to close the pipe. Any asynchronous read operations
|
||||||
|
* will be cancelled immediately, and will complete with the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Release ownership of the underlying native pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read operations to
|
||||||
|
* finish immediately, and the handlers for cancelled operations will be
|
||||||
|
* passed the asio::error::operation_aborted error. Ownership of the
|
||||||
|
* native pipe is then transferred to the caller.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note This function is unsupported on Windows versions prior to Windows
|
||||||
|
* 8.1, and will fail with asio::error::operation_not_supported on
|
||||||
|
* these platforms.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0603)
|
||||||
|
__declspec(deprecated("This function always fails with "
|
||||||
|
"operation_not_supported when used on Windows versions "
|
||||||
|
"prior to Windows 8.1."))
|
||||||
|
#endif
|
||||||
|
native_handle_type release()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
native_handle_type s = impl_.get_service().release(
|
||||||
|
impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "release");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Release ownership of the underlying native pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read operations to
|
||||||
|
* finish immediately, and the handlers for cancelled operations will be
|
||||||
|
* passed the asio::error::operation_aborted error. Ownership of the
|
||||||
|
* native pipe is then transferred to the caller.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note This function is unsupported on Windows versions prior to Windows
|
||||||
|
* 8.1, and will fail with asio::error::operation_not_supported on
|
||||||
|
* these platforms.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0603)
|
||||||
|
__declspec(deprecated("This function always fails with "
|
||||||
|
"operation_not_supported when used on Windows versions "
|
||||||
|
"prior to Windows 8.1."))
|
||||||
|
#endif
|
||||||
|
native_handle_type release(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().release(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the native pipe representation.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the underlying representation of the
|
||||||
|
* pipe. This is intended to allow access to native pipe
|
||||||
|
* functionality that is not otherwise provided.
|
||||||
|
*/
|
||||||
|
native_handle_type native_handle()
|
||||||
|
{
|
||||||
|
return impl_.get_service().native_handle(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all asynchronous operations associated with the pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read operations to finish
|
||||||
|
* immediately, and the handlers for cancelled operations will be passed the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void cancel()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all asynchronous operations associated with the pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous read operations to finish
|
||||||
|
* immediately, and the handlers for cancelled operations will be passed the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID cancel(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to read data from the pipe. The function call will
|
||||||
|
* block until one or more bytes of data has been read successfully, or until
|
||||||
|
* an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes read.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the connection was closed by the
|
||||||
|
* peer.
|
||||||
|
*
|
||||||
|
* @note The read_some operation may not read all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the blocking operation
|
||||||
|
* completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To read into a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* basic_readable_pipe.read_some(asio::buffer(data, size));
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on reading into multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().read_some(
|
||||||
|
impl_.get_implementation(), buffers, ec);
|
||||||
|
asio::detail::throw_error(ec, "read_some");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to read data from the pipe. The function call will
|
||||||
|
* block until one or more bytes of data has been read successfully, or until
|
||||||
|
* an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes read. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The read_some operation may not read all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the blocking operation
|
||||||
|
* completes.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().read_some(
|
||||||
|
impl_.get_implementation(), buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous read.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously read data from the pipe. It is an
|
||||||
|
* initiating function for an @ref asynchronous_operation, and always returns
|
||||||
|
* immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the read completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes read.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @note The read operation may not read all of the requested number of bytes.
|
||||||
|
* Consider using the @ref async_read function if you need to ensure that the
|
||||||
|
* requested amount of data is read before the asynchronous operation
|
||||||
|
* completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To read into a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* basic_readable_pipe.async_read_some(
|
||||||
|
* asio::buffer(data, size), handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on reading into multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_read_some(const MutableBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(ReadToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_read_some>(), token, buffers)))
|
||||||
|
{
|
||||||
|
return async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_read_some(this), token, buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_readable_pipe(const basic_readable_pipe&) ASIO_DELETED;
|
||||||
|
basic_readable_pipe& operator=(const basic_readable_pipe&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_read_some
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_read_some(basic_readable_pipe* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename ReadHandler, typename MutableBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(ReadHandler) handler,
|
||||||
|
const MutableBufferSequence& buffers) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a ReadHandler.
|
||||||
|
ASIO_READ_HANDLER_CHECK(ReadHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<ReadHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_read_some(
|
||||||
|
self_->impl_.get_implementation(), buffers,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_readable_pipe* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
detail::io_object_impl<detail::win_iocp_handle_service, Executor> impl_;
|
||||||
|
#elif defined(ASIO_HAS_IO_URING_AS_DEFAULT)
|
||||||
|
detail::io_object_impl<detail::io_uring_descriptor_service, Executor> impl_;
|
||||||
|
#else
|
||||||
|
detail::io_object_impl<detail::reactive_descriptor_service, Executor> impl_;
|
||||||
|
#endif
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_PIPE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_READABLE_PIPE_HPP
|
835
lib/asio-1.26.0/asio/basic_seq_packet_socket.hpp
Normal file
835
lib/asio-1.26.0/asio/basic_seq_packet_socket.hpp
Normal file
|
@ -0,0 +1,835 @@
|
||||||
|
//
|
||||||
|
// basic_seq_packet_socket.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_SEQ_PACKET_SOCKET_HPP
|
||||||
|
#define ASIO_BASIC_SEQ_PACKET_SOCKET_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/basic_socket.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_SEQ_PACKET_SOCKET_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_SEQ_PACKET_SOCKET_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Protocol, typename Executor = any_io_executor>
|
||||||
|
class basic_seq_packet_socket;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_SEQ_PACKET_SOCKET_FWD_DECL)
|
||||||
|
|
||||||
|
/// Provides sequenced packet socket functionality.
|
||||||
|
/**
|
||||||
|
* The basic_seq_packet_socket class template provides asynchronous and blocking
|
||||||
|
* sequenced packet socket functionality.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* Synchronous @c send, @c receive, @c connect, and @c shutdown operations are
|
||||||
|
* thread safe with respect to each other, if the underlying operating system
|
||||||
|
* calls are also thread safe. This means that it is permitted to perform
|
||||||
|
* concurrent calls to these synchronous operations on a single socket object.
|
||||||
|
* Other synchronous operations, such as @c open or @c close, are not thread
|
||||||
|
* safe.
|
||||||
|
*/
|
||||||
|
template <typename Protocol, typename Executor>
|
||||||
|
class basic_seq_packet_socket
|
||||||
|
: public basic_socket<Protocol, Executor>
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_send;
|
||||||
|
class initiate_async_receive_with_flags;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the socket type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The socket type when rebound to the specified executor.
|
||||||
|
typedef basic_seq_packet_socket<Protocol, Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The native representation of a socket.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef implementation_defined native_handle_type;
|
||||||
|
#else
|
||||||
|
typedef typename basic_socket<Protocol,
|
||||||
|
Executor>::native_handle_type native_handle_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// The protocol type.
|
||||||
|
typedef Protocol protocol_type;
|
||||||
|
|
||||||
|
/// The endpoint type.
|
||||||
|
typedef typename Protocol::endpoint endpoint_type;
|
||||||
|
|
||||||
|
/// Construct a basic_seq_packet_socket without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor creates a sequenced packet socket without opening it. The
|
||||||
|
* socket needs to be opened and then connected or accepted before data can
|
||||||
|
* be sent or received on it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the socket will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the socket.
|
||||||
|
*/
|
||||||
|
explicit basic_seq_packet_socket(const executor_type& ex)
|
||||||
|
: basic_socket<Protocol, Executor>(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_seq_packet_socket without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor creates a sequenced packet socket without opening it. The
|
||||||
|
* socket needs to be opened and then connected or accepted before data can
|
||||||
|
* be sent or received on it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the socket will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the socket.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_seq_packet_socket(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: basic_socket<Protocol, Executor>(context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_seq_packet_socket.
|
||||||
|
/**
|
||||||
|
* This constructor creates and opens a sequenced_packet socket. The socket
|
||||||
|
* needs to be connected or accepted before data can be sent or received on
|
||||||
|
* it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the socket will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the socket.
|
||||||
|
*
|
||||||
|
* @param protocol An object specifying protocol parameters to be used.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_seq_packet_socket(const executor_type& ex,
|
||||||
|
const protocol_type& protocol)
|
||||||
|
: basic_socket<Protocol, Executor>(ex, protocol)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_seq_packet_socket.
|
||||||
|
/**
|
||||||
|
* This constructor creates and opens a sequenced_packet socket. The socket
|
||||||
|
* needs to be connected or accepted before data can be sent or received on
|
||||||
|
* it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the socket will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the socket.
|
||||||
|
*
|
||||||
|
* @param protocol An object specifying protocol parameters to be used.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_seq_packet_socket(ExecutionContext& context,
|
||||||
|
const protocol_type& protocol,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_socket<Protocol, Executor>(context, protocol)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_seq_packet_socket, opening it and binding it to the
|
||||||
|
/// given local endpoint.
|
||||||
|
/**
|
||||||
|
* This constructor creates a sequenced packet socket and automatically opens
|
||||||
|
* it bound to the specified endpoint on the local machine. The protocol used
|
||||||
|
* is the protocol associated with the given endpoint.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the socket will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the socket.
|
||||||
|
*
|
||||||
|
* @param endpoint An endpoint on the local machine to which the sequenced
|
||||||
|
* packet socket will be bound.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_seq_packet_socket(const executor_type& ex,
|
||||||
|
const endpoint_type& endpoint)
|
||||||
|
: basic_socket<Protocol, Executor>(ex, endpoint)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_seq_packet_socket, opening it and binding it to the
|
||||||
|
/// given local endpoint.
|
||||||
|
/**
|
||||||
|
* This constructor creates a sequenced packet socket and automatically opens
|
||||||
|
* it bound to the specified endpoint on the local machine. The protocol used
|
||||||
|
* is the protocol associated with the given endpoint.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the socket will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the socket.
|
||||||
|
*
|
||||||
|
* @param endpoint An endpoint on the local machine to which the sequenced
|
||||||
|
* packet socket will be bound.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_seq_packet_socket(ExecutionContext& context,
|
||||||
|
const endpoint_type& endpoint,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: basic_socket<Protocol, Executor>(context, endpoint)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_seq_packet_socket on an existing native socket.
|
||||||
|
/**
|
||||||
|
* This constructor creates a sequenced packet socket object to hold an
|
||||||
|
* existing native socket.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the socket will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the socket.
|
||||||
|
*
|
||||||
|
* @param protocol An object specifying protocol parameters to be used.
|
||||||
|
*
|
||||||
|
* @param native_socket The new underlying socket implementation.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_seq_packet_socket(const executor_type& ex,
|
||||||
|
const protocol_type& protocol, const native_handle_type& native_socket)
|
||||||
|
: basic_socket<Protocol, Executor>(ex, protocol, native_socket)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_seq_packet_socket on an existing native socket.
|
||||||
|
/**
|
||||||
|
* This constructor creates a sequenced packet socket object to hold an
|
||||||
|
* existing native socket.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the socket will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the socket.
|
||||||
|
*
|
||||||
|
* @param protocol An object specifying protocol parameters to be used.
|
||||||
|
*
|
||||||
|
* @param native_socket The new underlying socket implementation.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_seq_packet_socket(ExecutionContext& context,
|
||||||
|
const protocol_type& protocol, const native_handle_type& native_socket,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: basic_socket<Protocol, Executor>(context, protocol, native_socket)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_seq_packet_socket from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a sequenced packet socket from one object to
|
||||||
|
* another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_seq_packet_socket object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_seq_packet_socket(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_seq_packet_socket(basic_seq_packet_socket&& other) ASIO_NOEXCEPT
|
||||||
|
: basic_socket<Protocol, Executor>(std::move(other))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_seq_packet_socket from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a sequenced packet socket from one object to
|
||||||
|
* another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_seq_packet_socket object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_seq_packet_socket(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_seq_packet_socket& operator=(basic_seq_packet_socket&& other)
|
||||||
|
{
|
||||||
|
basic_socket<Protocol, Executor>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-construct a basic_seq_packet_socket from a socket of another protocol
|
||||||
|
/// type.
|
||||||
|
/**
|
||||||
|
* This constructor moves a sequenced packet socket from one object to
|
||||||
|
* another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_seq_packet_socket object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_seq_packet_socket(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Protocol1, typename Executor1>
|
||||||
|
basic_seq_packet_socket(basic_seq_packet_socket<Protocol1, Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Protocol1, Protocol>::value
|
||||||
|
&& is_convertible<Executor1, Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
: basic_socket<Protocol, Executor>(std::move(other))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_seq_packet_socket from a socket of another protocol
|
||||||
|
/// type.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a sequenced packet socket from one object to
|
||||||
|
* another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_seq_packet_socket object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_seq_packet_socket(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Protocol1, typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Protocol1, Protocol>::value
|
||||||
|
&& is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_seq_packet_socket&
|
||||||
|
>::type operator=(basic_seq_packet_socket<Protocol1, Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_socket<Protocol, Executor>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the socket.
|
||||||
|
/**
|
||||||
|
* This function destroys the socket, cancelling any outstanding asynchronous
|
||||||
|
* operations associated with the socket as if by calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_seq_packet_socket()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Send some data on the socket.
|
||||||
|
/**
|
||||||
|
* This function is used to send data on the sequenced packet socket. The
|
||||||
|
* function call will block until the data has been sent successfully, or an
|
||||||
|
* until error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be sent on the socket.
|
||||||
|
*
|
||||||
|
* @param flags Flags specifying how the send call is to be made.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes sent.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To send a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* socket.send(asio::buffer(data, size), 0);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on sending multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t send(const ConstBufferSequence& buffers,
|
||||||
|
socket_base::message_flags flags)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().send(
|
||||||
|
this->impl_.get_implementation(), buffers, flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "send");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Send some data on the socket.
|
||||||
|
/**
|
||||||
|
* This function is used to send data on the sequenced packet socket. The
|
||||||
|
* function call will block the data has been sent successfully, or an until
|
||||||
|
* error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be sent on the socket.
|
||||||
|
*
|
||||||
|
* @param flags Flags specifying how the send call is to be made.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes sent. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The send operation may not transmit all of the data to the peer.
|
||||||
|
* Consider using the @ref write function if you need to ensure that all data
|
||||||
|
* is written before the blocking operation completes.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t send(const ConstBufferSequence& buffers,
|
||||||
|
socket_base::message_flags flags, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().send(
|
||||||
|
this->impl_.get_implementation(), buffers, flags, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous send.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously send data on the sequenced packet
|
||||||
|
* socket. It is an initiating function for an @ref asynchronous_operation,
|
||||||
|
* and always returns immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be sent on the socket. Although
|
||||||
|
* the buffers object may be copied as necessary, ownership of the underlying
|
||||||
|
* memory blocks is retained by the caller, which must guarantee that they
|
||||||
|
* remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param flags Flags specifying how the send call is to be made.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the send completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes sent.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To send a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* socket.async_send(asio::buffer(data, size), 0, handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on sending multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* On POSIX or Windows operating systems, this asynchronous operation supports
|
||||||
|
* cancellation for the following asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_send(const ConstBufferSequence& buffers,
|
||||||
|
socket_base::message_flags flags,
|
||||||
|
ASIO_MOVE_ARG(WriteToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_send>(), token, buffers, flags)))
|
||||||
|
{
|
||||||
|
return async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_send(this), token, buffers, flags);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Receive some data on the socket.
|
||||||
|
/**
|
||||||
|
* This function is used to receive data on the sequenced packet socket. The
|
||||||
|
* function call will block until data has been received successfully, or
|
||||||
|
* until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be received.
|
||||||
|
*
|
||||||
|
* @param out_flags After the receive call completes, contains flags
|
||||||
|
* associated with the received data. For example, if the
|
||||||
|
* socket_base::message_end_of_record bit is set then the received data marks
|
||||||
|
* the end of a record.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes received.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the connection was closed by the
|
||||||
|
* peer.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To receive into a single data buffer use the @ref buffer function as
|
||||||
|
* follows:
|
||||||
|
* @code
|
||||||
|
* socket.receive(asio::buffer(data, size), out_flags);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on receiving into
|
||||||
|
* multiple buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t receive(const MutableBufferSequence& buffers,
|
||||||
|
socket_base::message_flags& out_flags)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().receive_with_flags(
|
||||||
|
this->impl_.get_implementation(), buffers, 0, out_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "receive");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Receive some data on the socket.
|
||||||
|
/**
|
||||||
|
* This function is used to receive data on the sequenced packet socket. The
|
||||||
|
* function call will block until data has been received successfully, or
|
||||||
|
* until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be received.
|
||||||
|
*
|
||||||
|
* @param in_flags Flags specifying how the receive call is to be made.
|
||||||
|
*
|
||||||
|
* @param out_flags After the receive call completes, contains flags
|
||||||
|
* associated with the received data. For example, if the
|
||||||
|
* socket_base::message_end_of_record bit is set then the received data marks
|
||||||
|
* the end of a record.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes received.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the connection was closed by the
|
||||||
|
* peer.
|
||||||
|
*
|
||||||
|
* @note The receive operation may not receive all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read function if you need to ensure that the
|
||||||
|
* requested amount of data is read before the blocking operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To receive into a single data buffer use the @ref buffer function as
|
||||||
|
* follows:
|
||||||
|
* @code
|
||||||
|
* socket.receive(asio::buffer(data, size), 0, out_flags);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on receiving into
|
||||||
|
* multiple buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t receive(const MutableBufferSequence& buffers,
|
||||||
|
socket_base::message_flags in_flags,
|
||||||
|
socket_base::message_flags& out_flags)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().receive_with_flags(
|
||||||
|
this->impl_.get_implementation(), buffers, in_flags, out_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "receive");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Receive some data on a connected socket.
|
||||||
|
/**
|
||||||
|
* This function is used to receive data on the sequenced packet socket. The
|
||||||
|
* function call will block until data has been received successfully, or
|
||||||
|
* until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be received.
|
||||||
|
*
|
||||||
|
* @param in_flags Flags specifying how the receive call is to be made.
|
||||||
|
*
|
||||||
|
* @param out_flags After the receive call completes, contains flags
|
||||||
|
* associated with the received data. For example, if the
|
||||||
|
* socket_base::message_end_of_record bit is set then the received data marks
|
||||||
|
* the end of a record.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes received. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The receive operation may not receive all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read function if you need to ensure that the
|
||||||
|
* requested amount of data is read before the blocking operation completes.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t receive(const MutableBufferSequence& buffers,
|
||||||
|
socket_base::message_flags in_flags,
|
||||||
|
socket_base::message_flags& out_flags, asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().receive_with_flags(
|
||||||
|
this->impl_.get_implementation(), buffers, in_flags, out_flags, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous receive.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously receive data from the sequenced
|
||||||
|
* packet socket. It is an initiating function for an @ref
|
||||||
|
* asynchronous_operation, and always returns immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be received.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param out_flags Once the asynchronous operation completes, contains flags
|
||||||
|
* associated with the received data. For example, if the
|
||||||
|
* socket_base::message_end_of_record bit is set then the received data marks
|
||||||
|
* the end of a record. The caller must guarantee that the referenced
|
||||||
|
* variable remains valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the receive completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes received.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To receive into a single data buffer use the @ref buffer function as
|
||||||
|
* follows:
|
||||||
|
* @code
|
||||||
|
* socket.async_receive(asio::buffer(data, size), out_flags, handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on receiving into
|
||||||
|
* multiple buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* On POSIX or Windows operating systems, this asynchronous operation supports
|
||||||
|
* cancellation for the following asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_receive(const MutableBufferSequence& buffers,
|
||||||
|
socket_base::message_flags& out_flags,
|
||||||
|
ASIO_MOVE_ARG(ReadToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_receive_with_flags>(), token,
|
||||||
|
buffers, socket_base::message_flags(0), &out_flags)))
|
||||||
|
{
|
||||||
|
return async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_receive_with_flags(this), token,
|
||||||
|
buffers, socket_base::message_flags(0), &out_flags);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous receive.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously receive data from the sequenced
|
||||||
|
* data socket. It is an initiating function for an @ref
|
||||||
|
* asynchronous_operation, and always returns immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be received.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param in_flags Flags specifying how the receive call is to be made.
|
||||||
|
*
|
||||||
|
* @param out_flags Once the asynchronous operation completes, contains flags
|
||||||
|
* associated with the received data. For example, if the
|
||||||
|
* socket_base::message_end_of_record bit is set then the received data marks
|
||||||
|
* the end of a record. The caller must guarantee that the referenced
|
||||||
|
* variable remains valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the receive completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes received.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To receive into a single data buffer use the @ref buffer function as
|
||||||
|
* follows:
|
||||||
|
* @code
|
||||||
|
* socket.async_receive(
|
||||||
|
* asio::buffer(data, size),
|
||||||
|
* 0, out_flags, handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on receiving into
|
||||||
|
* multiple buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* On POSIX or Windows operating systems, this asynchronous operation supports
|
||||||
|
* cancellation for the following asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_receive(const MutableBufferSequence& buffers,
|
||||||
|
socket_base::message_flags in_flags,
|
||||||
|
socket_base::message_flags& out_flags,
|
||||||
|
ASIO_MOVE_ARG(ReadToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_receive_with_flags>(),
|
||||||
|
token, buffers, in_flags, &out_flags)))
|
||||||
|
{
|
||||||
|
return async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_receive_with_flags(this),
|
||||||
|
token, buffers, in_flags, &out_flags);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_seq_packet_socket(const basic_seq_packet_socket&) ASIO_DELETED;
|
||||||
|
basic_seq_packet_socket& operator=(
|
||||||
|
const basic_seq_packet_socket&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_send
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_send(basic_seq_packet_socket* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename WriteHandler, typename ConstBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(WriteHandler) handler,
|
||||||
|
const ConstBufferSequence& buffers,
|
||||||
|
socket_base::message_flags flags) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a WriteHandler.
|
||||||
|
ASIO_WRITE_HANDLER_CHECK(WriteHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<WriteHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_send(
|
||||||
|
self_->impl_.get_implementation(), buffers, flags,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_seq_packet_socket* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class initiate_async_receive_with_flags
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_receive_with_flags(basic_seq_packet_socket* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename ReadHandler, typename MutableBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(ReadHandler) handler,
|
||||||
|
const MutableBufferSequence& buffers,
|
||||||
|
socket_base::message_flags in_flags,
|
||||||
|
socket_base::message_flags* out_flags) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a ReadHandler.
|
||||||
|
ASIO_READ_HANDLER_CHECK(ReadHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<ReadHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_receive_with_flags(
|
||||||
|
self_->impl_.get_implementation(), buffers, in_flags,
|
||||||
|
*out_flags, handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_seq_packet_socket* self_;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_SEQ_PACKET_SOCKET_HPP
|
1000
lib/asio-1.26.0/asio/basic_serial_port.hpp
Normal file
1000
lib/asio-1.26.0/asio/basic_serial_port.hpp
Normal file
File diff suppressed because it is too large
Load diff
598
lib/asio-1.26.0/asio/basic_signal_set.hpp
Normal file
598
lib/asio-1.26.0/asio/basic_signal_set.hpp
Normal file
|
@ -0,0 +1,598 @@
|
||||||
|
//
|
||||||
|
// basic_signal_set.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_SIGNAL_SET_HPP
|
||||||
|
#define ASIO_BASIC_SIGNAL_SET_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/io_object_impl.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/signal_set_service.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Provides signal functionality.
|
||||||
|
/**
|
||||||
|
* The basic_signal_set class provides the ability to perform an asynchronous
|
||||||
|
* wait for one or more signals to occur.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* Performing an asynchronous wait:
|
||||||
|
* @code
|
||||||
|
* void handler(
|
||||||
|
* const asio::error_code& error,
|
||||||
|
* int signal_number)
|
||||||
|
* {
|
||||||
|
* if (!error)
|
||||||
|
* {
|
||||||
|
* // A signal occurred.
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* ...
|
||||||
|
*
|
||||||
|
* // Construct a signal set registered for process termination.
|
||||||
|
* asio::signal_set signals(my_context, SIGINT, SIGTERM);
|
||||||
|
*
|
||||||
|
* // Start an asynchronous wait for one of the signals to occur.
|
||||||
|
* signals.async_wait(handler);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Queueing of signal notifications
|
||||||
|
*
|
||||||
|
* If a signal is registered with a signal_set, and the signal occurs when
|
||||||
|
* there are no waiting handlers, then the signal notification is queued. The
|
||||||
|
* next async_wait operation on that signal_set will dequeue the notification.
|
||||||
|
* If multiple notifications are queued, subsequent async_wait operations
|
||||||
|
* dequeue them one at a time. Signal notifications are dequeued in order of
|
||||||
|
* ascending signal number.
|
||||||
|
*
|
||||||
|
* If a signal number is removed from a signal_set (using the @c remove or @c
|
||||||
|
* erase member functions) then any queued notifications for that signal are
|
||||||
|
* discarded.
|
||||||
|
*
|
||||||
|
* @par Multiple registration of signals
|
||||||
|
*
|
||||||
|
* The same signal number may be registered with different signal_set objects.
|
||||||
|
* When the signal occurs, one handler is called for each signal_set object.
|
||||||
|
*
|
||||||
|
* Note that multiple registration only works for signals that are registered
|
||||||
|
* using Asio. The application must not also register a signal handler using
|
||||||
|
* functions such as @c signal() or @c sigaction().
|
||||||
|
*
|
||||||
|
* @par Signal masking on POSIX platforms
|
||||||
|
*
|
||||||
|
* POSIX allows signals to be blocked using functions such as @c sigprocmask()
|
||||||
|
* and @c pthread_sigmask(). For signals to be delivered, programs must ensure
|
||||||
|
* that any signals registered using signal_set objects are unblocked in at
|
||||||
|
* least one thread.
|
||||||
|
*/
|
||||||
|
template <typename Executor = any_io_executor>
|
||||||
|
class basic_signal_set
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_wait;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the signal set type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The signal set type when rebound to the specified executor.
|
||||||
|
typedef basic_signal_set<Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Construct a signal set without adding any signals.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set without registering for any signals.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the signal set will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the
|
||||||
|
* signal set.
|
||||||
|
*/
|
||||||
|
explicit basic_signal_set(const executor_type& ex)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set without adding any signals.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set without registering for any signals.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the signal set will use, by default, to dispatch handlers for any
|
||||||
|
* asynchronous operations performed on the signal set.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_signal_set(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set and add one signal.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set and registers for one signal.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the signal set will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the
|
||||||
|
* signal set.
|
||||||
|
*
|
||||||
|
* @param signal_number_1 The signal number to be added.
|
||||||
|
*
|
||||||
|
* @note This constructor is equivalent to performing:
|
||||||
|
* @code asio::signal_set signals(ex);
|
||||||
|
* signals.add(signal_number_1); @endcode
|
||||||
|
*/
|
||||||
|
basic_signal_set(const executor_type& ex, int signal_number_1)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_1, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set and add one signal.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set and registers for one signal.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the signal set will use, by default, to dispatch handlers for any
|
||||||
|
* asynchronous operations performed on the signal set.
|
||||||
|
*
|
||||||
|
* @param signal_number_1 The signal number to be added.
|
||||||
|
*
|
||||||
|
* @note This constructor is equivalent to performing:
|
||||||
|
* @code asio::signal_set signals(context);
|
||||||
|
* signals.add(signal_number_1); @endcode
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_signal_set(ExecutionContext& context, int signal_number_1,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_1, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set and add two signals.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set and registers for two signals.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the signal set will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the
|
||||||
|
* signal set.
|
||||||
|
*
|
||||||
|
* @param signal_number_1 The first signal number to be added.
|
||||||
|
*
|
||||||
|
* @param signal_number_2 The second signal number to be added.
|
||||||
|
*
|
||||||
|
* @note This constructor is equivalent to performing:
|
||||||
|
* @code asio::signal_set signals(ex);
|
||||||
|
* signals.add(signal_number_1);
|
||||||
|
* signals.add(signal_number_2); @endcode
|
||||||
|
*/
|
||||||
|
basic_signal_set(const executor_type& ex, int signal_number_1,
|
||||||
|
int signal_number_2)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_1, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_2, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set and add two signals.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set and registers for two signals.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the signal set will use, by default, to dispatch handlers for any
|
||||||
|
* asynchronous operations performed on the signal set.
|
||||||
|
*
|
||||||
|
* @param signal_number_1 The first signal number to be added.
|
||||||
|
*
|
||||||
|
* @param signal_number_2 The second signal number to be added.
|
||||||
|
*
|
||||||
|
* @note This constructor is equivalent to performing:
|
||||||
|
* @code asio::signal_set signals(context);
|
||||||
|
* signals.add(signal_number_1);
|
||||||
|
* signals.add(signal_number_2); @endcode
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_signal_set(ExecutionContext& context, int signal_number_1,
|
||||||
|
int signal_number_2,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_1, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_2, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set and add three signals.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set and registers for three signals.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the signal set will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the
|
||||||
|
* signal set.
|
||||||
|
*
|
||||||
|
* @param signal_number_1 The first signal number to be added.
|
||||||
|
*
|
||||||
|
* @param signal_number_2 The second signal number to be added.
|
||||||
|
*
|
||||||
|
* @param signal_number_3 The third signal number to be added.
|
||||||
|
*
|
||||||
|
* @note This constructor is equivalent to performing:
|
||||||
|
* @code asio::signal_set signals(ex);
|
||||||
|
* signals.add(signal_number_1);
|
||||||
|
* signals.add(signal_number_2);
|
||||||
|
* signals.add(signal_number_3); @endcode
|
||||||
|
*/
|
||||||
|
basic_signal_set(const executor_type& ex, int signal_number_1,
|
||||||
|
int signal_number_2, int signal_number_3)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_1, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_2, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_3, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a signal set and add three signals.
|
||||||
|
/**
|
||||||
|
* This constructor creates a signal set and registers for three signals.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the signal set will use, by default, to dispatch handlers for any
|
||||||
|
* asynchronous operations performed on the signal set.
|
||||||
|
*
|
||||||
|
* @param signal_number_1 The first signal number to be added.
|
||||||
|
*
|
||||||
|
* @param signal_number_2 The second signal number to be added.
|
||||||
|
*
|
||||||
|
* @param signal_number_3 The third signal number to be added.
|
||||||
|
*
|
||||||
|
* @note This constructor is equivalent to performing:
|
||||||
|
* @code asio::signal_set signals(context);
|
||||||
|
* signals.add(signal_number_1);
|
||||||
|
* signals.add(signal_number_2);
|
||||||
|
* signals.add(signal_number_3); @endcode
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_signal_set(ExecutionContext& context, int signal_number_1,
|
||||||
|
int signal_number_2, int signal_number_3,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_1, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_2, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number_3, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Destroys the signal set.
|
||||||
|
/**
|
||||||
|
* This function destroys the signal set, cancelling any outstanding
|
||||||
|
* asynchronous wait operations associated with the signal set as if by
|
||||||
|
* calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_signal_set()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
const executor_type& get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Add a signal to a signal_set.
|
||||||
|
/**
|
||||||
|
* This function adds the specified signal to the set. It has no effect if the
|
||||||
|
* signal is already in the set.
|
||||||
|
*
|
||||||
|
* @param signal_number The signal to be added to the set.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void add(int signal_number)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number, ec);
|
||||||
|
asio::detail::throw_error(ec, "add");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Add a signal to a signal_set.
|
||||||
|
/**
|
||||||
|
* This function adds the specified signal to the set. It has no effect if the
|
||||||
|
* signal is already in the set.
|
||||||
|
*
|
||||||
|
* @param signal_number The signal to be added to the set.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID add(int signal_number,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().add(impl_.get_implementation(), signal_number, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove a signal from a signal_set.
|
||||||
|
/**
|
||||||
|
* This function removes the specified signal from the set. It has no effect
|
||||||
|
* if the signal is not in the set.
|
||||||
|
*
|
||||||
|
* @param signal_number The signal to be removed from the set.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note Removes any notifications that have been queued for the specified
|
||||||
|
* signal number.
|
||||||
|
*/
|
||||||
|
void remove(int signal_number)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().remove(impl_.get_implementation(), signal_number, ec);
|
||||||
|
asio::detail::throw_error(ec, "remove");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove a signal from a signal_set.
|
||||||
|
/**
|
||||||
|
* This function removes the specified signal from the set. It has no effect
|
||||||
|
* if the signal is not in the set.
|
||||||
|
*
|
||||||
|
* @param signal_number The signal to be removed from the set.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note Removes any notifications that have been queued for the specified
|
||||||
|
* signal number.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID remove(int signal_number,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().remove(impl_.get_implementation(), signal_number, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove all signals from a signal_set.
|
||||||
|
/**
|
||||||
|
* This function removes all signals from the set. It has no effect if the set
|
||||||
|
* is already empty.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note Removes all queued notifications.
|
||||||
|
*/
|
||||||
|
void clear()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().clear(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "clear");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove all signals from a signal_set.
|
||||||
|
/**
|
||||||
|
* This function removes all signals from the set. It has no effect if the set
|
||||||
|
* is already empty.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note Removes all queued notifications.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID clear(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().clear(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all operations associated with the signal set.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of any pending asynchronous wait
|
||||||
|
* operations against the signal set. The handler for each cancelled
|
||||||
|
* operation will be invoked with the asio::error::operation_aborted
|
||||||
|
* error code.
|
||||||
|
*
|
||||||
|
* Cancellation does not alter the set of registered signals.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If a registered signal occurred before cancel() is called, then the
|
||||||
|
* handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
void cancel()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all operations associated with the signal set.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of any pending asynchronous wait
|
||||||
|
* operations against the signal set. The handler for each cancelled
|
||||||
|
* operation will be invoked with the asio::error::operation_aborted
|
||||||
|
* error code.
|
||||||
|
*
|
||||||
|
* Cancellation does not alter the set of registered signals.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note If a registered signal occurred before cancel() is called, then the
|
||||||
|
* handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID cancel(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous operation to wait for a signal to be delivered.
|
||||||
|
/**
|
||||||
|
* This function may be used to initiate an asynchronous wait against the
|
||||||
|
* signal set. It is an initiating function for an @ref
|
||||||
|
* asynchronous_operation, and always returns immediately.
|
||||||
|
*
|
||||||
|
* For each call to async_wait(), the completion handler will be called
|
||||||
|
* exactly once. The completion handler will be called when:
|
||||||
|
*
|
||||||
|
* @li One of the registered signals in the signal set occurs; or
|
||||||
|
*
|
||||||
|
* @li The signal set was cancelled, in which case the handler is passed the
|
||||||
|
* error code asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the wait completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* int signal_number // Indicates which signal occurred.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, int) @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* This asynchronous operation supports cancellation for the following
|
||||||
|
* asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code, int))
|
||||||
|
SignalToken ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(SignalToken,
|
||||||
|
void (asio::error_code, int))
|
||||||
|
async_wait(
|
||||||
|
ASIO_MOVE_ARG(SignalToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<SignalToken, void (asio::error_code, int)>(
|
||||||
|
declval<initiate_async_wait>(), token)))
|
||||||
|
{
|
||||||
|
return async_initiate<SignalToken, void (asio::error_code, int)>(
|
||||||
|
initiate_async_wait(this), token);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_signal_set(const basic_signal_set&) ASIO_DELETED;
|
||||||
|
basic_signal_set& operator=(const basic_signal_set&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_wait
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_wait(basic_signal_set* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename SignalHandler>
|
||||||
|
void operator()(ASIO_MOVE_ARG(SignalHandler) handler) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a SignalHandler.
|
||||||
|
ASIO_SIGNAL_HANDLER_CHECK(SignalHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<SignalHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_wait(
|
||||||
|
self_->impl_.get_implementation(),
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_signal_set* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
detail::io_object_impl<detail::signal_set_service, Executor> impl_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_SIGNAL_SET_HPP
|
1947
lib/asio-1.26.0/asio/basic_socket.hpp
Normal file
1947
lib/asio-1.26.0/asio/basic_socket.hpp
Normal file
File diff suppressed because it is too large
Load diff
2751
lib/asio-1.26.0/asio/basic_socket_acceptor.hpp
Normal file
2751
lib/asio-1.26.0/asio/basic_socket_acceptor.hpp
Normal file
File diff suppressed because it is too large
Load diff
407
lib/asio-1.26.0/asio/basic_socket_iostream.hpp
Normal file
407
lib/asio-1.26.0/asio/basic_socket_iostream.hpp
Normal file
|
@ -0,0 +1,407 @@
|
||||||
|
//
|
||||||
|
// basic_socket_iostream.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_SOCKET_IOSTREAM_HPP
|
||||||
|
#define ASIO_BASIC_SOCKET_IOSTREAM_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#include <istream>
|
||||||
|
#include <ostream>
|
||||||
|
#include "asio/basic_socket_streambuf.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
# include "asio/detail/variadic_templates.hpp"
|
||||||
|
|
||||||
|
// A macro that should expand to:
|
||||||
|
// template <typename T1, ..., typename Tn>
|
||||||
|
// explicit basic_socket_iostream(T1 x1, ..., Tn xn)
|
||||||
|
// : std::basic_iostream<char>(
|
||||||
|
// &this->detail::socket_iostream_base<
|
||||||
|
// Protocol, Clock, WaitTraits>::streambuf_)
|
||||||
|
// {
|
||||||
|
// if (rdbuf()->connect(x1, ..., xn) == 0)
|
||||||
|
// this->setstate(std::ios_base::failbit);
|
||||||
|
// }
|
||||||
|
// This macro should only persist within this file.
|
||||||
|
|
||||||
|
# define ASIO_PRIVATE_CTR_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
explicit basic_socket_iostream(ASIO_VARIADIC_BYVAL_PARAMS(n)) \
|
||||||
|
: std::basic_iostream<char>( \
|
||||||
|
&this->detail::socket_iostream_base< \
|
||||||
|
Protocol, Clock, WaitTraits>::streambuf_) \
|
||||||
|
{ \
|
||||||
|
this->setf(std::ios_base::unitbuf); \
|
||||||
|
if (rdbuf()->connect(ASIO_VARIADIC_BYVAL_ARGS(n)) == 0) \
|
||||||
|
this->setstate(std::ios_base::failbit); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
|
||||||
|
// A macro that should expand to:
|
||||||
|
// template <typename T1, ..., typename Tn>
|
||||||
|
// void connect(T1 x1, ..., Tn xn)
|
||||||
|
// {
|
||||||
|
// if (rdbuf()->connect(x1, ..., xn) == 0)
|
||||||
|
// this->setstate(std::ios_base::failbit);
|
||||||
|
// }
|
||||||
|
// This macro should only persist within this file.
|
||||||
|
|
||||||
|
# define ASIO_PRIVATE_CONNECT_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void connect(ASIO_VARIADIC_BYVAL_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
if (rdbuf()->connect(ASIO_VARIADIC_BYVAL_ARGS(n)) == 0) \
|
||||||
|
this->setstate(std::ios_base::failbit); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// A separate base class is used to ensure that the streambuf is initialised
|
||||||
|
// prior to the basic_socket_iostream's basic_iostream base class.
|
||||||
|
template <typename Protocol, typename Clock, typename WaitTraits>
|
||||||
|
class socket_iostream_base
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
socket_iostream_base()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
socket_iostream_base(socket_iostream_base&& other)
|
||||||
|
: streambuf_(std::move(other.streambuf_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
socket_iostream_base(basic_stream_socket<Protocol> s)
|
||||||
|
: streambuf_(std::move(s))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
socket_iostream_base& operator=(socket_iostream_base&& other)
|
||||||
|
{
|
||||||
|
streambuf_ = std::move(other.streambuf_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
basic_socket_streambuf<Protocol, Clock, WaitTraits> streambuf_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_SOCKET_IOSTREAM_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_SOCKET_IOSTREAM_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Protocol,
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
&& defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typename Clock = boost::posix_time::ptime,
|
||||||
|
typename WaitTraits = time_traits<Clock> >
|
||||||
|
#else // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typename Clock = chrono::steady_clock,
|
||||||
|
typename WaitTraits = wait_traits<Clock> >
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
class basic_socket_iostream;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_SOCKET_IOSTREAM_FWD_DECL)
|
||||||
|
|
||||||
|
/// Iostream interface for a socket.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Protocol,
|
||||||
|
typename Clock = chrono::steady_clock,
|
||||||
|
typename WaitTraits = wait_traits<Clock> >
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Protocol, typename Clock, typename WaitTraits>
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
class basic_socket_iostream
|
||||||
|
: private detail::socket_iostream_base<Protocol, Clock, WaitTraits>,
|
||||||
|
public std::basic_iostream<char>
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
// These typedefs are intended keep this class's implementation independent
|
||||||
|
// of whether it's using Boost.DateClock, Boost.Chrono or std::chrono.
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
&& defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typedef WaitTraits traits_helper;
|
||||||
|
#else // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typedef detail::chrono_time_traits<Clock, WaitTraits> traits_helper;
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The protocol type.
|
||||||
|
typedef Protocol protocol_type;
|
||||||
|
|
||||||
|
/// The endpoint type.
|
||||||
|
typedef typename Protocol::endpoint endpoint_type;
|
||||||
|
|
||||||
|
/// The clock type.
|
||||||
|
typedef Clock clock_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// (Deprecated: Use time_point.) The time type.
|
||||||
|
typedef typename WaitTraits::time_type time_type;
|
||||||
|
|
||||||
|
/// The time type.
|
||||||
|
typedef typename WaitTraits::time_point time_point;
|
||||||
|
|
||||||
|
/// (Deprecated: Use duration.) The duration type.
|
||||||
|
typedef typename WaitTraits::duration_type duration_type;
|
||||||
|
|
||||||
|
/// The duration type.
|
||||||
|
typedef typename WaitTraits::duration duration;
|
||||||
|
#else
|
||||||
|
# if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
typedef typename traits_helper::time_type time_type;
|
||||||
|
typedef typename traits_helper::duration_type duration_type;
|
||||||
|
# endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
typedef typename traits_helper::time_type time_point;
|
||||||
|
typedef typename traits_helper::duration_type duration;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct a basic_socket_iostream without establishing a connection.
|
||||||
|
basic_socket_iostream()
|
||||||
|
: std::basic_iostream<char>(
|
||||||
|
&this->detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>::streambuf_)
|
||||||
|
{
|
||||||
|
this->setf(std::ios_base::unitbuf);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Construct a basic_socket_iostream from the supplied socket.
|
||||||
|
explicit basic_socket_iostream(basic_stream_socket<protocol_type> s)
|
||||||
|
: detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>(std::move(s)),
|
||||||
|
std::basic_iostream<char>(
|
||||||
|
&this->detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>::streambuf_)
|
||||||
|
{
|
||||||
|
this->setf(std::ios_base::unitbuf);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_IOSTREAM_MOVE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_socket_iostream from another.
|
||||||
|
basic_socket_iostream(basic_socket_iostream&& other)
|
||||||
|
: detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>(std::move(other)),
|
||||||
|
std::basic_iostream<char>(std::move(other))
|
||||||
|
{
|
||||||
|
this->set_rdbuf(&this->detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>::streambuf_);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_socket_iostream from another.
|
||||||
|
basic_socket_iostream& operator=(basic_socket_iostream&& other)
|
||||||
|
{
|
||||||
|
std::basic_iostream<char>::operator=(std::move(other));
|
||||||
|
detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_STD_IOSTREAM_MOVE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Establish a connection to an endpoint corresponding to a resolver query.
|
||||||
|
/**
|
||||||
|
* This constructor automatically establishes a connection based on the
|
||||||
|
* supplied resolver query parameters. The arguments are used to construct
|
||||||
|
* a resolver query object.
|
||||||
|
*/
|
||||||
|
template <typename T1, ..., typename TN>
|
||||||
|
explicit basic_socket_iostream(T1 t1, ..., TN tn);
|
||||||
|
#elif defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
template <typename... T>
|
||||||
|
explicit basic_socket_iostream(T... x)
|
||||||
|
: std::basic_iostream<char>(
|
||||||
|
&this->detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>::streambuf_)
|
||||||
|
{
|
||||||
|
this->setf(std::ios_base::unitbuf);
|
||||||
|
if (rdbuf()->connect(x...) == 0)
|
||||||
|
this->setstate(std::ios_base::failbit);
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_CTR_DEF)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Establish a connection to an endpoint corresponding to a resolver query.
|
||||||
|
/**
|
||||||
|
* This function automatically establishes a connection based on the supplied
|
||||||
|
* resolver query parameters. The arguments are used to construct a resolver
|
||||||
|
* query object.
|
||||||
|
*/
|
||||||
|
template <typename T1, ..., typename TN>
|
||||||
|
void connect(T1 t1, ..., TN tn);
|
||||||
|
#elif defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
template <typename... T>
|
||||||
|
void connect(T... x)
|
||||||
|
{
|
||||||
|
if (rdbuf()->connect(x...) == 0)
|
||||||
|
this->setstate(std::ios_base::failbit);
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_CONNECT_DEF)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Close the connection.
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
if (rdbuf()->close() == 0)
|
||||||
|
this->setstate(std::ios_base::failbit);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Return a pointer to the underlying streambuf.
|
||||||
|
basic_socket_streambuf<Protocol, Clock, WaitTraits>* rdbuf() const
|
||||||
|
{
|
||||||
|
return const_cast<basic_socket_streambuf<Protocol, Clock, WaitTraits>*>(
|
||||||
|
&this->detail::socket_iostream_base<
|
||||||
|
Protocol, Clock, WaitTraits>::streambuf_);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the underlying socket.
|
||||||
|
basic_socket<Protocol>& socket()
|
||||||
|
{
|
||||||
|
return rdbuf()->socket();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the last error associated with the stream.
|
||||||
|
/**
|
||||||
|
* @return An \c error_code corresponding to the last error from the stream.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To print the error associated with a failure to establish a connection:
|
||||||
|
* @code tcp::iostream s("www.boost.org", "http");
|
||||||
|
* if (!s)
|
||||||
|
* {
|
||||||
|
* std::cout << "Error: " << s.error().message() << std::endl;
|
||||||
|
* } @endcode
|
||||||
|
*/
|
||||||
|
const asio::error_code& error() const
|
||||||
|
{
|
||||||
|
return rdbuf()->error();
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use expiry().) Get the stream's expiry time as an absolute
|
||||||
|
/// time.
|
||||||
|
/**
|
||||||
|
* @return An absolute time value representing the stream's expiry time.
|
||||||
|
*/
|
||||||
|
time_point expires_at() const
|
||||||
|
{
|
||||||
|
return rdbuf()->expires_at();
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// Get the stream's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* @return An absolute time value representing the stream's expiry time.
|
||||||
|
*/
|
||||||
|
time_point expiry() const
|
||||||
|
{
|
||||||
|
return rdbuf()->expiry();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the stream's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time associated with the stream. Stream
|
||||||
|
* operations performed after this time (where the operations cannot be
|
||||||
|
* completed using the internal buffers) will fail with the error
|
||||||
|
* asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the stream.
|
||||||
|
*/
|
||||||
|
void expires_at(const time_point& expiry_time)
|
||||||
|
{
|
||||||
|
rdbuf()->expires_at(expiry_time);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the stream's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time associated with the stream. Stream
|
||||||
|
* operations performed after this time (where the operations cannot be
|
||||||
|
* completed using the internal buffers) will fail with the error
|
||||||
|
* asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*/
|
||||||
|
void expires_after(const duration& expiry_time)
|
||||||
|
{
|
||||||
|
rdbuf()->expires_after(expiry_time);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use expiry().) Get the stream's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* @return A relative time value representing the stream's expiry time.
|
||||||
|
*/
|
||||||
|
duration expires_from_now() const
|
||||||
|
{
|
||||||
|
return rdbuf()->expires_from_now();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use expires_after().) Set the stream's expiry time relative
|
||||||
|
/// to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time associated with the stream. Stream
|
||||||
|
* operations performed after this time (where the operations cannot be
|
||||||
|
* completed using the internal buffers) will fail with the error
|
||||||
|
* asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*/
|
||||||
|
void expires_from_now(const duration& expiry_time)
|
||||||
|
{
|
||||||
|
rdbuf()->expires_from_now(expiry_time);
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_socket_iostream(const basic_socket_iostream&) ASIO_DELETED;
|
||||||
|
basic_socket_iostream& operator=(
|
||||||
|
const basic_socket_iostream&) ASIO_DELETED;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
# undef ASIO_PRIVATE_CTR_DEF
|
||||||
|
# undef ASIO_PRIVATE_CONNECT_DEF
|
||||||
|
#endif // !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_SOCKET_IOSTREAM_HPP
|
687
lib/asio-1.26.0/asio/basic_socket_streambuf.hpp
Normal file
687
lib/asio-1.26.0/asio/basic_socket_streambuf.hpp
Normal file
|
@ -0,0 +1,687 @@
|
||||||
|
//
|
||||||
|
// basic_socket_streambuf.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_SOCKET_STREAMBUF_HPP
|
||||||
|
#define ASIO_BASIC_SOCKET_STREAMBUF_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#include <streambuf>
|
||||||
|
#include <vector>
|
||||||
|
#include "asio/basic_socket.hpp"
|
||||||
|
#include "asio/basic_stream_socket.hpp"
|
||||||
|
#include "asio/detail/buffer_sequence_adapter.hpp"
|
||||||
|
#include "asio/detail/memory.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/io_context.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
&& defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
# include "asio/detail/deadline_timer_service.hpp"
|
||||||
|
#else // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
# include "asio/steady_timer.hpp"
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
# include "asio/detail/variadic_templates.hpp"
|
||||||
|
|
||||||
|
// A macro that should expand to:
|
||||||
|
// template <typename T1, ..., typename Tn>
|
||||||
|
// basic_socket_streambuf* connect(T1 x1, ..., Tn xn)
|
||||||
|
// {
|
||||||
|
// init_buffers();
|
||||||
|
// typedef typename Protocol::resolver resolver_type;
|
||||||
|
// resolver_type resolver(socket().get_executor());
|
||||||
|
// connect_to_endpoints(
|
||||||
|
// resolver.resolve(x1, ..., xn, ec_));
|
||||||
|
// return !ec_ ? this : 0;
|
||||||
|
// }
|
||||||
|
// This macro should only persist within this file.
|
||||||
|
|
||||||
|
# define ASIO_PRIVATE_CONNECT_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
basic_socket_streambuf* connect(ASIO_VARIADIC_BYVAL_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
init_buffers(); \
|
||||||
|
typedef typename Protocol::resolver resolver_type; \
|
||||||
|
resolver_type resolver(socket().get_executor()); \
|
||||||
|
connect_to_endpoints( \
|
||||||
|
resolver.resolve(ASIO_VARIADIC_BYVAL_ARGS(n), ec_)); \
|
||||||
|
return !ec_ ? this : 0; \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// A separate base class is used to ensure that the io_context member is
|
||||||
|
// initialised prior to the basic_socket_streambuf's basic_socket base class.
|
||||||
|
class socket_streambuf_io_context
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
socket_streambuf_io_context(io_context* ctx)
|
||||||
|
: default_io_context_(ctx)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
shared_ptr<io_context> default_io_context_;
|
||||||
|
};
|
||||||
|
|
||||||
|
// A separate base class is used to ensure that the dynamically allocated
|
||||||
|
// buffers are constructed prior to the basic_socket_streambuf's basic_socket
|
||||||
|
// base class. This makes moving the socket is the last potentially throwing
|
||||||
|
// step in the streambuf's move constructor, giving the constructor a strong
|
||||||
|
// exception safety guarantee.
|
||||||
|
class socket_streambuf_buffers
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
socket_streambuf_buffers()
|
||||||
|
: get_buffer_(buffer_size),
|
||||||
|
put_buffer_(buffer_size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { buffer_size = 512 };
|
||||||
|
std::vector<char> get_buffer_;
|
||||||
|
std::vector<char> put_buffer_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_SOCKET_STREAMBUF_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_SOCKET_STREAMBUF_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Protocol,
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
&& defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typename Clock = boost::posix_time::ptime,
|
||||||
|
typename WaitTraits = time_traits<Clock> >
|
||||||
|
#else // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typename Clock = chrono::steady_clock,
|
||||||
|
typename WaitTraits = wait_traits<Clock> >
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
class basic_socket_streambuf;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_SOCKET_STREAMBUF_FWD_DECL)
|
||||||
|
|
||||||
|
/// Iostream streambuf for a socket.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Protocol,
|
||||||
|
typename Clock = chrono::steady_clock,
|
||||||
|
typename WaitTraits = wait_traits<Clock> >
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Protocol, typename Clock, typename WaitTraits>
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
class basic_socket_streambuf
|
||||||
|
: public std::streambuf,
|
||||||
|
private detail::socket_streambuf_io_context,
|
||||||
|
private detail::socket_streambuf_buffers,
|
||||||
|
#if defined(ASIO_NO_DEPRECATED) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
private basic_socket<Protocol>
|
||||||
|
#else // defined(ASIO_NO_DEPRECATED) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
public basic_socket<Protocol>
|
||||||
|
#endif // defined(ASIO_NO_DEPRECATED) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
// These typedefs are intended keep this class's implementation independent
|
||||||
|
// of whether it's using Boost.DateClock, Boost.Chrono or std::chrono.
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
&& defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typedef WaitTraits traits_helper;
|
||||||
|
#else // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
typedef detail::chrono_time_traits<Clock, WaitTraits> traits_helper;
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The protocol type.
|
||||||
|
typedef Protocol protocol_type;
|
||||||
|
|
||||||
|
/// The endpoint type.
|
||||||
|
typedef typename Protocol::endpoint endpoint_type;
|
||||||
|
|
||||||
|
/// The clock type.
|
||||||
|
typedef Clock clock_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// (Deprecated: Use time_point.) The time type.
|
||||||
|
typedef typename WaitTraits::time_type time_type;
|
||||||
|
|
||||||
|
/// The time type.
|
||||||
|
typedef typename WaitTraits::time_point time_point;
|
||||||
|
|
||||||
|
/// (Deprecated: Use duration.) The duration type.
|
||||||
|
typedef typename WaitTraits::duration_type duration_type;
|
||||||
|
|
||||||
|
/// The duration type.
|
||||||
|
typedef typename WaitTraits::duration duration;
|
||||||
|
#else
|
||||||
|
# if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
typedef typename traits_helper::time_type time_type;
|
||||||
|
typedef typename traits_helper::duration_type duration_type;
|
||||||
|
# endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
typedef typename traits_helper::time_type time_point;
|
||||||
|
typedef typename traits_helper::duration_type duration;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct a basic_socket_streambuf without establishing a connection.
|
||||||
|
basic_socket_streambuf()
|
||||||
|
: detail::socket_streambuf_io_context(new io_context),
|
||||||
|
basic_socket<Protocol>(*default_io_context_),
|
||||||
|
expiry_time_(max_expiry_time())
|
||||||
|
{
|
||||||
|
init_buffers();
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Construct a basic_socket_streambuf from the supplied socket.
|
||||||
|
explicit basic_socket_streambuf(basic_stream_socket<protocol_type> s)
|
||||||
|
: detail::socket_streambuf_io_context(0),
|
||||||
|
basic_socket<Protocol>(std::move(s)),
|
||||||
|
expiry_time_(max_expiry_time())
|
||||||
|
{
|
||||||
|
init_buffers();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-construct a basic_socket_streambuf from another.
|
||||||
|
basic_socket_streambuf(basic_socket_streambuf&& other)
|
||||||
|
: detail::socket_streambuf_io_context(other),
|
||||||
|
basic_socket<Protocol>(std::move(other.socket())),
|
||||||
|
ec_(other.ec_),
|
||||||
|
expiry_time_(other.expiry_time_)
|
||||||
|
{
|
||||||
|
get_buffer_.swap(other.get_buffer_);
|
||||||
|
put_buffer_.swap(other.put_buffer_);
|
||||||
|
setg(other.eback(), other.gptr(), other.egptr());
|
||||||
|
setp(other.pptr(), other.epptr());
|
||||||
|
other.ec_ = asio::error_code();
|
||||||
|
other.expiry_time_ = max_expiry_time();
|
||||||
|
other.init_buffers();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_socket_streambuf from another.
|
||||||
|
basic_socket_streambuf& operator=(basic_socket_streambuf&& other)
|
||||||
|
{
|
||||||
|
this->close();
|
||||||
|
socket() = std::move(other.socket());
|
||||||
|
detail::socket_streambuf_io_context::operator=(other);
|
||||||
|
ec_ = other.ec_;
|
||||||
|
expiry_time_ = other.expiry_time_;
|
||||||
|
get_buffer_.swap(other.get_buffer_);
|
||||||
|
put_buffer_.swap(other.put_buffer_);
|
||||||
|
setg(other.eback(), other.gptr(), other.egptr());
|
||||||
|
setp(other.pptr(), other.epptr());
|
||||||
|
other.ec_ = asio::error_code();
|
||||||
|
other.expiry_time_ = max_expiry_time();
|
||||||
|
other.put_buffer_.resize(buffer_size);
|
||||||
|
other.init_buffers();
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destructor flushes buffered data.
|
||||||
|
virtual ~basic_socket_streambuf()
|
||||||
|
{
|
||||||
|
if (pptr() != pbase())
|
||||||
|
overflow(traits_type::eof());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Establish a connection.
|
||||||
|
/**
|
||||||
|
* This function establishes a connection to the specified endpoint.
|
||||||
|
*
|
||||||
|
* @return \c this if a connection was successfully established, a null
|
||||||
|
* pointer otherwise.
|
||||||
|
*/
|
||||||
|
basic_socket_streambuf* connect(const endpoint_type& endpoint)
|
||||||
|
{
|
||||||
|
init_buffers();
|
||||||
|
ec_ = asio::error_code();
|
||||||
|
this->connect_to_endpoints(&endpoint, &endpoint + 1);
|
||||||
|
return !ec_ ? this : 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Establish a connection.
|
||||||
|
/**
|
||||||
|
* This function automatically establishes a connection based on the supplied
|
||||||
|
* resolver query parameters. The arguments are used to construct a resolver
|
||||||
|
* query object.
|
||||||
|
*
|
||||||
|
* @return \c this if a connection was successfully established, a null
|
||||||
|
* pointer otherwise.
|
||||||
|
*/
|
||||||
|
template <typename T1, ..., typename TN>
|
||||||
|
basic_socket_streambuf* connect(T1 t1, ..., TN tn);
|
||||||
|
#elif defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
template <typename... T>
|
||||||
|
basic_socket_streambuf* connect(T... x)
|
||||||
|
{
|
||||||
|
init_buffers();
|
||||||
|
typedef typename Protocol::resolver resolver_type;
|
||||||
|
resolver_type resolver(socket().get_executor());
|
||||||
|
connect_to_endpoints(resolver.resolve(x..., ec_));
|
||||||
|
return !ec_ ? this : 0;
|
||||||
|
}
|
||||||
|
#else
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_CONNECT_DEF)
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Close the connection.
|
||||||
|
/**
|
||||||
|
* @return \c this if a connection was successfully established, a null
|
||||||
|
* pointer otherwise.
|
||||||
|
*/
|
||||||
|
basic_socket_streambuf* close()
|
||||||
|
{
|
||||||
|
sync();
|
||||||
|
socket().close(ec_);
|
||||||
|
if (!ec_)
|
||||||
|
init_buffers();
|
||||||
|
return !ec_ ? this : 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the underlying socket.
|
||||||
|
basic_socket<Protocol>& socket()
|
||||||
|
{
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the last error associated with the stream buffer.
|
||||||
|
/**
|
||||||
|
* @return An \c error_code corresponding to the last error from the stream
|
||||||
|
* buffer.
|
||||||
|
*/
|
||||||
|
const asio::error_code& error() const
|
||||||
|
{
|
||||||
|
return ec_;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use error().) Get the last error associated with the stream
|
||||||
|
/// buffer.
|
||||||
|
/**
|
||||||
|
* @return An \c error_code corresponding to the last error from the stream
|
||||||
|
* buffer.
|
||||||
|
*/
|
||||||
|
const asio::error_code& puberror() const
|
||||||
|
{
|
||||||
|
return error();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use expiry().) Get the stream buffer's expiry time as an
|
||||||
|
/// absolute time.
|
||||||
|
/**
|
||||||
|
* @return An absolute time value representing the stream buffer's expiry
|
||||||
|
* time.
|
||||||
|
*/
|
||||||
|
time_point expires_at() const
|
||||||
|
{
|
||||||
|
return expiry_time_;
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// Get the stream buffer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* @return An absolute time value representing the stream buffer's expiry
|
||||||
|
* time.
|
||||||
|
*/
|
||||||
|
time_point expiry() const
|
||||||
|
{
|
||||||
|
return expiry_time_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the stream buffer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time associated with the stream. Stream
|
||||||
|
* operations performed after this time (where the operations cannot be
|
||||||
|
* completed using the internal buffers) will fail with the error
|
||||||
|
* asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the stream.
|
||||||
|
*/
|
||||||
|
void expires_at(const time_point& expiry_time)
|
||||||
|
{
|
||||||
|
expiry_time_ = expiry_time;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the stream buffer's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time associated with the stream. Stream
|
||||||
|
* operations performed after this time (where the operations cannot be
|
||||||
|
* completed using the internal buffers) will fail with the error
|
||||||
|
* asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*/
|
||||||
|
void expires_after(const duration& expiry_time)
|
||||||
|
{
|
||||||
|
expiry_time_ = traits_helper::add(traits_helper::now(), expiry_time);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use expiry().) Get the stream buffer's expiry time relative
|
||||||
|
/// to now.
|
||||||
|
/**
|
||||||
|
* @return A relative time value representing the stream buffer's expiry time.
|
||||||
|
*/
|
||||||
|
duration expires_from_now() const
|
||||||
|
{
|
||||||
|
return traits_helper::subtract(expires_at(), traits_helper::now());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use expires_after().) Set the stream buffer's expiry time
|
||||||
|
/// relative to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time associated with the stream. Stream
|
||||||
|
* operations performed after this time (where the operations cannot be
|
||||||
|
* completed using the internal buffers) will fail with the error
|
||||||
|
* asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*/
|
||||||
|
void expires_from_now(const duration& expiry_time)
|
||||||
|
{
|
||||||
|
expiry_time_ = traits_helper::add(traits_helper::now(), expiry_time);
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
protected:
|
||||||
|
int_type underflow()
|
||||||
|
{
|
||||||
|
#if defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
ec_ = asio::error::operation_not_supported;
|
||||||
|
return traits_type::eof();
|
||||||
|
#else // defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
if (gptr() != egptr())
|
||||||
|
return traits_type::eof();
|
||||||
|
|
||||||
|
for (;;)
|
||||||
|
{
|
||||||
|
// Check if we are past the expiry time.
|
||||||
|
if (traits_helper::less_than(expiry_time_, traits_helper::now()))
|
||||||
|
{
|
||||||
|
ec_ = asio::error::timed_out;
|
||||||
|
return traits_type::eof();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Try to complete the operation without blocking.
|
||||||
|
if (!socket().native_non_blocking())
|
||||||
|
socket().native_non_blocking(true, ec_);
|
||||||
|
detail::buffer_sequence_adapter<mutable_buffer, mutable_buffer>
|
||||||
|
bufs(asio::buffer(get_buffer_) + putback_max);
|
||||||
|
detail::signed_size_type bytes = detail::socket_ops::recv(
|
||||||
|
socket().native_handle(), bufs.buffers(), bufs.count(), 0, ec_);
|
||||||
|
|
||||||
|
// Check if operation succeeded.
|
||||||
|
if (bytes > 0)
|
||||||
|
{
|
||||||
|
setg(&get_buffer_[0], &get_buffer_[0] + putback_max,
|
||||||
|
&get_buffer_[0] + putback_max + bytes);
|
||||||
|
return traits_type::to_int_type(*gptr());
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check for EOF.
|
||||||
|
if (bytes == 0)
|
||||||
|
{
|
||||||
|
ec_ = asio::error::eof;
|
||||||
|
return traits_type::eof();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Operation failed.
|
||||||
|
if (ec_ != asio::error::would_block
|
||||||
|
&& ec_ != asio::error::try_again)
|
||||||
|
return traits_type::eof();
|
||||||
|
|
||||||
|
// Wait for socket to become ready.
|
||||||
|
if (detail::socket_ops::poll_read(
|
||||||
|
socket().native_handle(), 0, timeout(), ec_) < 0)
|
||||||
|
return traits_type::eof();
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
}
|
||||||
|
|
||||||
|
int_type overflow(int_type c)
|
||||||
|
{
|
||||||
|
#if defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
ec_ = asio::error::operation_not_supported;
|
||||||
|
return traits_type::eof();
|
||||||
|
#else // defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
char_type ch = traits_type::to_char_type(c);
|
||||||
|
|
||||||
|
// Determine what needs to be sent.
|
||||||
|
const_buffer output_buffer;
|
||||||
|
if (put_buffer_.empty())
|
||||||
|
{
|
||||||
|
if (traits_type::eq_int_type(c, traits_type::eof()))
|
||||||
|
return traits_type::not_eof(c); // Nothing to do.
|
||||||
|
output_buffer = asio::buffer(&ch, sizeof(char_type));
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
output_buffer = asio::buffer(pbase(),
|
||||||
|
(pptr() - pbase()) * sizeof(char_type));
|
||||||
|
}
|
||||||
|
|
||||||
|
while (output_buffer.size() > 0)
|
||||||
|
{
|
||||||
|
// Check if we are past the expiry time.
|
||||||
|
if (traits_helper::less_than(expiry_time_, traits_helper::now()))
|
||||||
|
{
|
||||||
|
ec_ = asio::error::timed_out;
|
||||||
|
return traits_type::eof();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Try to complete the operation without blocking.
|
||||||
|
if (!socket().native_non_blocking())
|
||||||
|
socket().native_non_blocking(true, ec_);
|
||||||
|
detail::buffer_sequence_adapter<
|
||||||
|
const_buffer, const_buffer> bufs(output_buffer);
|
||||||
|
detail::signed_size_type bytes = detail::socket_ops::send(
|
||||||
|
socket().native_handle(), bufs.buffers(), bufs.count(), 0, ec_);
|
||||||
|
|
||||||
|
// Check if operation succeeded.
|
||||||
|
if (bytes > 0)
|
||||||
|
{
|
||||||
|
output_buffer += static_cast<std::size_t>(bytes);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Operation failed.
|
||||||
|
if (ec_ != asio::error::would_block
|
||||||
|
&& ec_ != asio::error::try_again)
|
||||||
|
return traits_type::eof();
|
||||||
|
|
||||||
|
// Wait for socket to become ready.
|
||||||
|
if (detail::socket_ops::poll_write(
|
||||||
|
socket().native_handle(), 0, timeout(), ec_) < 0)
|
||||||
|
return traits_type::eof();
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!put_buffer_.empty())
|
||||||
|
{
|
||||||
|
setp(&put_buffer_[0], &put_buffer_[0] + put_buffer_.size());
|
||||||
|
|
||||||
|
// If the new character is eof then our work here is done.
|
||||||
|
if (traits_type::eq_int_type(c, traits_type::eof()))
|
||||||
|
return traits_type::not_eof(c);
|
||||||
|
|
||||||
|
// Add the new character to the output buffer.
|
||||||
|
*pptr() = ch;
|
||||||
|
pbump(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
return c;
|
||||||
|
#endif // defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
}
|
||||||
|
|
||||||
|
int sync()
|
||||||
|
{
|
||||||
|
return overflow(traits_type::eof());
|
||||||
|
}
|
||||||
|
|
||||||
|
std::streambuf* setbuf(char_type* s, std::streamsize n)
|
||||||
|
{
|
||||||
|
if (pptr() == pbase() && s == 0 && n == 0)
|
||||||
|
{
|
||||||
|
put_buffer_.clear();
|
||||||
|
setp(0, 0);
|
||||||
|
sync();
|
||||||
|
return this;
|
||||||
|
}
|
||||||
|
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_socket_streambuf(const basic_socket_streambuf&) ASIO_DELETED;
|
||||||
|
basic_socket_streambuf& operator=(
|
||||||
|
const basic_socket_streambuf&) ASIO_DELETED;
|
||||||
|
|
||||||
|
void init_buffers()
|
||||||
|
{
|
||||||
|
setg(&get_buffer_[0],
|
||||||
|
&get_buffer_[0] + putback_max,
|
||||||
|
&get_buffer_[0] + putback_max);
|
||||||
|
|
||||||
|
if (put_buffer_.empty())
|
||||||
|
setp(0, 0);
|
||||||
|
else
|
||||||
|
setp(&put_buffer_[0], &put_buffer_[0] + put_buffer_.size());
|
||||||
|
}
|
||||||
|
|
||||||
|
int timeout() const
|
||||||
|
{
|
||||||
|
int64_t msec = traits_helper::to_posix_duration(
|
||||||
|
traits_helper::subtract(expiry_time_,
|
||||||
|
traits_helper::now())).total_milliseconds();
|
||||||
|
if (msec > (std::numeric_limits<int>::max)())
|
||||||
|
msec = (std::numeric_limits<int>::max)();
|
||||||
|
else if (msec < 0)
|
||||||
|
msec = 0;
|
||||||
|
return static_cast<int>(msec);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename EndpointSequence>
|
||||||
|
void connect_to_endpoints(const EndpointSequence& endpoints)
|
||||||
|
{
|
||||||
|
this->connect_to_endpoints(endpoints.begin(), endpoints.end());
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename EndpointIterator>
|
||||||
|
void connect_to_endpoints(EndpointIterator begin, EndpointIterator end)
|
||||||
|
{
|
||||||
|
#if defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
ec_ = asio::error::operation_not_supported;
|
||||||
|
#else // defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
if (ec_)
|
||||||
|
return;
|
||||||
|
|
||||||
|
ec_ = asio::error::not_found;
|
||||||
|
for (EndpointIterator i = begin; i != end; ++i)
|
||||||
|
{
|
||||||
|
// Check if we are past the expiry time.
|
||||||
|
if (traits_helper::less_than(expiry_time_, traits_helper::now()))
|
||||||
|
{
|
||||||
|
ec_ = asio::error::timed_out;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Close and reopen the socket.
|
||||||
|
typename Protocol::endpoint ep(*i);
|
||||||
|
socket().close(ec_);
|
||||||
|
socket().open(ep.protocol(), ec_);
|
||||||
|
if (ec_)
|
||||||
|
continue;
|
||||||
|
|
||||||
|
// Try to complete the operation without blocking.
|
||||||
|
if (!socket().native_non_blocking())
|
||||||
|
socket().native_non_blocking(true, ec_);
|
||||||
|
detail::socket_ops::connect(socket().native_handle(),
|
||||||
|
ep.data(), ep.size(), ec_);
|
||||||
|
|
||||||
|
// Check if operation succeeded.
|
||||||
|
if (!ec_)
|
||||||
|
return;
|
||||||
|
|
||||||
|
// Operation failed.
|
||||||
|
if (ec_ != asio::error::in_progress
|
||||||
|
&& ec_ != asio::error::would_block)
|
||||||
|
continue;
|
||||||
|
|
||||||
|
// Wait for socket to become ready.
|
||||||
|
if (detail::socket_ops::poll_connect(
|
||||||
|
socket().native_handle(), timeout(), ec_) < 0)
|
||||||
|
continue;
|
||||||
|
|
||||||
|
// Get the error code from the connect operation.
|
||||||
|
int connect_error = 0;
|
||||||
|
size_t connect_error_len = sizeof(connect_error);
|
||||||
|
if (detail::socket_ops::getsockopt(socket().native_handle(), 0,
|
||||||
|
SOL_SOCKET, SO_ERROR, &connect_error, &connect_error_len, ec_)
|
||||||
|
== detail::socket_error_retval)
|
||||||
|
return;
|
||||||
|
|
||||||
|
// Check the result of the connect operation.
|
||||||
|
ec_ = asio::error_code(connect_error,
|
||||||
|
asio::error::get_system_category());
|
||||||
|
if (!ec_)
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Helper function to get the maximum expiry time.
|
||||||
|
static time_point max_expiry_time()
|
||||||
|
{
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
&& defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
return boost::posix_time::pos_infin;
|
||||||
|
#else // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
return (time_point::max)();
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// && defined(ASIO_USE_BOOST_DATE_TIME_FOR_SOCKET_IOSTREAM)
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { putback_max = 8 };
|
||||||
|
asio::error_code ec_;
|
||||||
|
time_point expiry_time_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
# undef ASIO_PRIVATE_CONNECT_DEF
|
||||||
|
#endif // !defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_SOCKET_STREAMBUF_HPP
|
754
lib/asio-1.26.0/asio/basic_stream_file.hpp
Normal file
754
lib/asio-1.26.0/asio/basic_stream_file.hpp
Normal file
|
@ -0,0 +1,754 @@
|
||||||
|
//
|
||||||
|
// basic_stream_file.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_STREAM_FILE_HPP
|
||||||
|
#define ASIO_BASIC_STREAM_FILE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_FILE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/basic_file.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_STREAM_FILE_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_STREAM_FILE_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Executor = any_io_executor>
|
||||||
|
class basic_stream_file;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_STREAM_FILE_FWD_DECL)
|
||||||
|
|
||||||
|
/// Provides stream-oriented file functionality.
|
||||||
|
/**
|
||||||
|
* The basic_stream_file class template provides asynchronous and blocking
|
||||||
|
* stream-oriented file functionality.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Concepts:
|
||||||
|
* AsyncReadStream, AsyncWriteStream, Stream, SyncReadStream, SyncWriteStream.
|
||||||
|
*/
|
||||||
|
template <typename Executor>
|
||||||
|
class basic_stream_file
|
||||||
|
: public basic_file<Executor>
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_write_some;
|
||||||
|
class initiate_async_read_some;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the file type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The file type when rebound to the specified executor.
|
||||||
|
typedef basic_stream_file<Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The native representation of a file.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef implementation_defined native_handle_type;
|
||||||
|
#else
|
||||||
|
typedef typename basic_file<Executor>::native_handle_type native_handle_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct a basic_stream_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file without opening it. The file needs to
|
||||||
|
* be opened before data can be read from or or written to it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*/
|
||||||
|
explicit basic_stream_file(const executor_type& ex)
|
||||||
|
: basic_file<Executor>(ex)
|
||||||
|
{
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_stream_file without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a file without opening it. The file needs to
|
||||||
|
* be opened before data can be read from or or written to it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_stream_file(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context)
|
||||||
|
{
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_stream_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_stream_file(const executor_type& ex,
|
||||||
|
const char* path, file_base::flags open_flags)
|
||||||
|
: basic_file<Executor>(ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
this->impl_.get_service().open(
|
||||||
|
this->impl_.get_implementation(),
|
||||||
|
path, open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_stream_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_stream_file(ExecutionContext& context,
|
||||||
|
const char* path, file_base::flags open_flags,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
this->impl_.get_service().open(
|
||||||
|
this->impl_.get_implementation(),
|
||||||
|
path, open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_stream_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_stream_file(const executor_type& ex,
|
||||||
|
const std::string& path, file_base::flags open_flags)
|
||||||
|
: basic_file<Executor>(ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
this->impl_.get_service().open(
|
||||||
|
this->impl_.get_implementation(),
|
||||||
|
path.c_str(), open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and open a basic_stream_file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises and opens a file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param path The path name identifying the file to be opened.
|
||||||
|
*
|
||||||
|
* @param open_flags A set of flags that determine how the file should be
|
||||||
|
* opened.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_stream_file(ExecutionContext& context,
|
||||||
|
const std::string& path, file_base::flags open_flags,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
this->impl_.get_service().open(
|
||||||
|
this->impl_.get_implementation(),
|
||||||
|
path.c_str(), open_flags, ec);
|
||||||
|
asio::detail::throw_error(ec, "open");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_stream_file on an existing native file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a stream file object to hold an existing
|
||||||
|
* native file.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the file will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param native_file The new underlying file implementation.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_stream_file(const executor_type& ex,
|
||||||
|
const native_handle_type& native_file)
|
||||||
|
: basic_file<Executor>(ex, native_file)
|
||||||
|
{
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_stream_file on an existing native file.
|
||||||
|
/**
|
||||||
|
* This constructor initialises a stream file object to hold an existing
|
||||||
|
* native file.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the file will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the file.
|
||||||
|
*
|
||||||
|
* @param native_file The new underlying file implementation.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_stream_file(ExecutionContext& context,
|
||||||
|
const native_handle_type& native_file,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(context, native_file)
|
||||||
|
{
|
||||||
|
this->impl_.get_service().set_is_stream(
|
||||||
|
this->impl_.get_implementation(), true);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_stream_file from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a stream file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_stream_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_stream_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_stream_file(basic_stream_file&& other) ASIO_NOEXCEPT
|
||||||
|
: basic_file<Executor>(std::move(other))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_stream_file from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a stream file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_stream_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_stream_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_stream_file& operator=(basic_stream_file&& other)
|
||||||
|
{
|
||||||
|
basic_file<Executor>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-construct a basic_stream_file from a file of another executor
|
||||||
|
/// type.
|
||||||
|
/**
|
||||||
|
* This constructor moves a stream file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_stream_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_stream_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
basic_stream_file(basic_stream_file<Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: basic_file<Executor>(std::move(other))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_stream_file from a file of another executor type.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a stream file from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_stream_file object from which the move
|
||||||
|
* will occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_stream_file(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_stream_file&
|
||||||
|
>::type operator=(basic_stream_file<Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_file<Executor>::operator=(std::move(other));
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the file.
|
||||||
|
/**
|
||||||
|
* This function destroys the file, cancelling any outstanding asynchronous
|
||||||
|
* operations associated with the file as if by calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_stream_file()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Seek to a position in the file.
|
||||||
|
/**
|
||||||
|
* This function updates the current position in the file.
|
||||||
|
*
|
||||||
|
* @param offset The requested position in the file, relative to @c whence.
|
||||||
|
*
|
||||||
|
* @param whence One of @c seek_set, @c seek_cur or @c seek_end.
|
||||||
|
*
|
||||||
|
* @returns The new position relative to the beginning of the file.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
uint64_t seek(int64_t offset, file_base::seek_basis whence)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
uint64_t n = this->impl_.get_service().seek(
|
||||||
|
this->impl_.get_implementation(), offset, whence, ec);
|
||||||
|
asio::detail::throw_error(ec, "seek");
|
||||||
|
return n;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Seek to a position in the file.
|
||||||
|
/**
|
||||||
|
* This function updates the current position in the file.
|
||||||
|
*
|
||||||
|
* @param offset The requested position in the file, relative to @c whence.
|
||||||
|
*
|
||||||
|
* @param whence One of @c seek_set, @c seek_cur or @c seek_end.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The new position relative to the beginning of the file.
|
||||||
|
*/
|
||||||
|
uint64_t seek(int64_t offset, file_base::seek_basis whence,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().seek(
|
||||||
|
this->impl_.get_implementation(), offset, whence, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write some data to the file.
|
||||||
|
/**
|
||||||
|
* This function is used to write data to the stream file. The function call
|
||||||
|
* will block until one or more bytes of the data has been written
|
||||||
|
* successfully, or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the file.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes written.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the end of the file was reached.
|
||||||
|
*
|
||||||
|
* @note The write_some operation may not transmit all of the data to the
|
||||||
|
* peer. Consider using the @ref write function if you need to ensure that
|
||||||
|
* all data is written before the blocking operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To write a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* file.write_some(asio::buffer(data, size));
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on writing multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().write_some(
|
||||||
|
this->impl_.get_implementation(), buffers, ec);
|
||||||
|
asio::detail::throw_error(ec, "write_some");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write some data to the file.
|
||||||
|
/**
|
||||||
|
* This function is used to write data to the stream file. The function call
|
||||||
|
* will block until one or more bytes of the data has been written
|
||||||
|
* successfully, or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the file.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes written. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The write_some operation may not transmit all of the data to the
|
||||||
|
* peer. Consider using the @ref write function if you need to ensure that
|
||||||
|
* all data is written before the blocking operation completes.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().write_some(
|
||||||
|
this->impl_.get_implementation(), buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous write.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously write data to the stream file.
|
||||||
|
* It is an initiating function for an @ref asynchronous_operation, and always
|
||||||
|
* returns immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the file.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the write completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes written.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @note The write operation may not transmit all of the data to the peer.
|
||||||
|
* Consider using the @ref async_write function if you need to ensure that all
|
||||||
|
* data is written before the asynchronous operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To write a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* file.async_write_some(asio::buffer(data, size), handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on writing multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* On POSIX or Windows operating systems, this asynchronous operation supports
|
||||||
|
* cancellation for the following asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_write_some(const ConstBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(WriteToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_write_some>(), token, buffers)))
|
||||||
|
{
|
||||||
|
return async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_write_some(this), token, buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the file.
|
||||||
|
/**
|
||||||
|
* This function is used to read data from the stream file. The function
|
||||||
|
* call will block until one or more bytes of data has been read successfully,
|
||||||
|
* or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes read.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the end of the file was reached.
|
||||||
|
*
|
||||||
|
* @note The read_some operation may not read all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the blocking operation
|
||||||
|
* completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To read into a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* file.read_some(asio::buffer(data, size));
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on reading into multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = this->impl_.get_service().read_some(
|
||||||
|
this->impl_.get_implementation(), buffers, ec);
|
||||||
|
asio::detail::throw_error(ec, "read_some");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the file.
|
||||||
|
/**
|
||||||
|
* This function is used to read data from the stream file. The function
|
||||||
|
* call will block until one or more bytes of data has been read successfully,
|
||||||
|
* or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes read. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The read_some operation may not read all of the requested number of
|
||||||
|
* bytes. Consider using the @ref read function if you need to ensure that
|
||||||
|
* the requested amount of data is read before the blocking operation
|
||||||
|
* completes.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return this->impl_.get_service().read_some(
|
||||||
|
this->impl_.get_implementation(), buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous read.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously read data from the stream file.
|
||||||
|
* It is an initiating function for an @ref asynchronous_operation, and always
|
||||||
|
* returns immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more buffers into which the data will be read.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the read completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes read.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @note The read operation may not read all of the requested number of bytes.
|
||||||
|
* Consider using the @ref async_read function if you need to ensure that the
|
||||||
|
* requested amount of data is read before the asynchronous operation
|
||||||
|
* completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To read into a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* file.async_read_some(asio::buffer(data, size), handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on reading into multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* On POSIX or Windows operating systems, this asynchronous operation supports
|
||||||
|
* cancellation for the following asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_read_some(const MutableBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(ReadToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_read_some>(), token, buffers)))
|
||||||
|
{
|
||||||
|
return async_initiate<ReadToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_read_some(this), token, buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_stream_file(const basic_stream_file&) ASIO_DELETED;
|
||||||
|
basic_stream_file& operator=(const basic_stream_file&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_write_some
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_write_some(basic_stream_file* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename WriteHandler, typename ConstBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(WriteHandler) handler,
|
||||||
|
const ConstBufferSequence& buffers) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a WriteHandler.
|
||||||
|
ASIO_WRITE_HANDLER_CHECK(WriteHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<WriteHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_write_some(
|
||||||
|
self_->impl_.get_implementation(), buffers,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_stream_file* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class initiate_async_read_some
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_read_some(basic_stream_file* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename ReadHandler, typename MutableBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(ReadHandler) handler,
|
||||||
|
const MutableBufferSequence& buffers) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a ReadHandler.
|
||||||
|
ASIO_READ_HANDLER_CHECK(ReadHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<ReadHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_read_some(
|
||||||
|
self_->impl_.get_implementation(), buffers,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_stream_file* self_;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_FILE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_STREAM_FILE_HPP
|
1189
lib/asio-1.26.0/asio/basic_stream_socket.hpp
Normal file
1189
lib/asio-1.26.0/asio/basic_stream_socket.hpp
Normal file
File diff suppressed because it is too large
Load diff
452
lib/asio-1.26.0/asio/basic_streambuf.hpp
Normal file
452
lib/asio-1.26.0/asio/basic_streambuf.hpp
Normal file
|
@ -0,0 +1,452 @@
|
||||||
|
//
|
||||||
|
// basic_streambuf.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_STREAMBUF_HPP
|
||||||
|
#define ASIO_BASIC_STREAMBUF_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#include <algorithm>
|
||||||
|
#include <cstring>
|
||||||
|
#include <stdexcept>
|
||||||
|
#include <streambuf>
|
||||||
|
#include <vector>
|
||||||
|
#include "asio/basic_streambuf_fwd.hpp"
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/detail/limits.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/detail/throw_exception.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Automatically resizable buffer class based on std::streambuf.
|
||||||
|
/**
|
||||||
|
* The @c basic_streambuf class is derived from @c std::streambuf to associate
|
||||||
|
* the streambuf's input and output sequences with one or more character
|
||||||
|
* arrays. These character arrays are internal to the @c basic_streambuf
|
||||||
|
* object, but direct access to the array elements is provided to permit them
|
||||||
|
* to be used efficiently with I/O operations. Characters written to the output
|
||||||
|
* sequence of a @c basic_streambuf object are appended to the input sequence
|
||||||
|
* of the same object.
|
||||||
|
*
|
||||||
|
* The @c basic_streambuf class's public interface is intended to permit the
|
||||||
|
* following implementation strategies:
|
||||||
|
*
|
||||||
|
* @li A single contiguous character array, which is reallocated as necessary
|
||||||
|
* to accommodate changes in the size of the character sequence. This is the
|
||||||
|
* implementation approach currently used in Asio.
|
||||||
|
*
|
||||||
|
* @li A sequence of one or more character arrays, where each array is of the
|
||||||
|
* same size. Additional character array objects are appended to the sequence
|
||||||
|
* to accommodate changes in the size of the character sequence.
|
||||||
|
*
|
||||||
|
* @li A sequence of one or more character arrays of varying sizes. Additional
|
||||||
|
* character array objects are appended to the sequence to accommodate changes
|
||||||
|
* in the size of the character sequence.
|
||||||
|
*
|
||||||
|
* The constructor for basic_streambuf accepts a @c size_t argument specifying
|
||||||
|
* the maximum of the sum of the sizes of the input sequence and output
|
||||||
|
* sequence. During the lifetime of the @c basic_streambuf object, the following
|
||||||
|
* invariant holds:
|
||||||
|
* @code size() <= max_size()@endcode
|
||||||
|
* Any member function that would, if successful, cause the invariant to be
|
||||||
|
* violated shall throw an exception of class @c std::length_error.
|
||||||
|
*
|
||||||
|
* The constructor for @c basic_streambuf takes an Allocator argument. A copy
|
||||||
|
* of this argument is used for any memory allocation performed, by the
|
||||||
|
* constructor and by all member functions, during the lifetime of each @c
|
||||||
|
* basic_streambuf object.
|
||||||
|
*
|
||||||
|
* @par Examples
|
||||||
|
* Writing directly from an streambuf to a socket:
|
||||||
|
* @code
|
||||||
|
* asio::streambuf b;
|
||||||
|
* std::ostream os(&b);
|
||||||
|
* os << "Hello, World!\n";
|
||||||
|
*
|
||||||
|
* // try sending some data in input sequence
|
||||||
|
* size_t n = sock.send(b.data());
|
||||||
|
*
|
||||||
|
* b.consume(n); // sent data is removed from input sequence
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* Reading from a socket directly into a streambuf:
|
||||||
|
* @code
|
||||||
|
* asio::streambuf b;
|
||||||
|
*
|
||||||
|
* // reserve 512 bytes in output sequence
|
||||||
|
* asio::streambuf::mutable_buffers_type bufs = b.prepare(512);
|
||||||
|
*
|
||||||
|
* size_t n = sock.receive(bufs);
|
||||||
|
*
|
||||||
|
* // received data is "committed" from output sequence to input sequence
|
||||||
|
* b.commit(n);
|
||||||
|
*
|
||||||
|
* std::istream is(&b);
|
||||||
|
* std::string s;
|
||||||
|
* is >> s;
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Allocator = std::allocator<char> >
|
||||||
|
#else
|
||||||
|
template <typename Allocator>
|
||||||
|
#endif
|
||||||
|
class basic_streambuf
|
||||||
|
: public std::streambuf,
|
||||||
|
private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The type used to represent the input sequence as a list of buffers.
|
||||||
|
typedef implementation_defined const_buffers_type;
|
||||||
|
|
||||||
|
/// The type used to represent the output sequence as a list of buffers.
|
||||||
|
typedef implementation_defined mutable_buffers_type;
|
||||||
|
#else
|
||||||
|
typedef ASIO_CONST_BUFFER const_buffers_type;
|
||||||
|
typedef ASIO_MUTABLE_BUFFER mutable_buffers_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct a basic_streambuf object.
|
||||||
|
/**
|
||||||
|
* Constructs a streambuf with the specified maximum size. The initial size
|
||||||
|
* of the streambuf's input sequence is 0.
|
||||||
|
*/
|
||||||
|
explicit basic_streambuf(
|
||||||
|
std::size_t maximum_size = (std::numeric_limits<std::size_t>::max)(),
|
||||||
|
const Allocator& allocator = Allocator())
|
||||||
|
: max_size_(maximum_size),
|
||||||
|
buffer_(allocator)
|
||||||
|
{
|
||||||
|
std::size_t pend = (std::min<std::size_t>)(max_size_, buffer_delta);
|
||||||
|
buffer_.resize((std::max<std::size_t>)(pend, 1));
|
||||||
|
setg(&buffer_[0], &buffer_[0], &buffer_[0]);
|
||||||
|
setp(&buffer_[0], &buffer_[0] + pend);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the size of the input sequence.
|
||||||
|
/**
|
||||||
|
* @returns The size of the input sequence. The value is equal to that
|
||||||
|
* calculated for @c s in the following code:
|
||||||
|
* @code
|
||||||
|
* size_t s = 0;
|
||||||
|
* const_buffers_type bufs = data();
|
||||||
|
* const_buffers_type::const_iterator i = bufs.begin();
|
||||||
|
* while (i != bufs.end())
|
||||||
|
* {
|
||||||
|
* const_buffer buf(*i++);
|
||||||
|
* s += buf.size();
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
std::size_t size() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return pptr() - gptr();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the maximum size of the basic_streambuf.
|
||||||
|
/**
|
||||||
|
* @returns The allowed maximum of the sum of the sizes of the input sequence
|
||||||
|
* and output sequence.
|
||||||
|
*/
|
||||||
|
std::size_t max_size() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return max_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the current capacity of the basic_streambuf.
|
||||||
|
/**
|
||||||
|
* @returns The current total capacity of the streambuf, i.e. for both the
|
||||||
|
* input sequence and output sequence.
|
||||||
|
*/
|
||||||
|
std::size_t capacity() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffer_.capacity();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a list of buffers that represents the input sequence.
|
||||||
|
/**
|
||||||
|
* @returns An object of type @c const_buffers_type that satisfies
|
||||||
|
* ConstBufferSequence requirements, representing all character arrays in the
|
||||||
|
* input sequence.
|
||||||
|
*
|
||||||
|
* @note The returned object is invalidated by any @c basic_streambuf member
|
||||||
|
* function that modifies the input sequence or output sequence.
|
||||||
|
*/
|
||||||
|
const_buffers_type data() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return asio::buffer(asio::const_buffer(gptr(),
|
||||||
|
(pptr() - gptr()) * sizeof(char_type)));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a list of buffers that represents the output sequence, with the given
|
||||||
|
/// size.
|
||||||
|
/**
|
||||||
|
* Ensures that the output sequence can accommodate @c n characters,
|
||||||
|
* reallocating character array objects as necessary.
|
||||||
|
*
|
||||||
|
* @returns An object of type @c mutable_buffers_type that satisfies
|
||||||
|
* MutableBufferSequence requirements, representing character array objects
|
||||||
|
* at the start of the output sequence such that the sum of the buffer sizes
|
||||||
|
* is @c n.
|
||||||
|
*
|
||||||
|
* @throws std::length_error If <tt>size() + n > max_size()</tt>.
|
||||||
|
*
|
||||||
|
* @note The returned object is invalidated by any @c basic_streambuf member
|
||||||
|
* function that modifies the input sequence or output sequence.
|
||||||
|
*/
|
||||||
|
mutable_buffers_type prepare(std::size_t n)
|
||||||
|
{
|
||||||
|
reserve(n);
|
||||||
|
return asio::buffer(asio::mutable_buffer(
|
||||||
|
pptr(), n * sizeof(char_type)));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move characters from the output sequence to the input sequence.
|
||||||
|
/**
|
||||||
|
* Appends @c n characters from the start of the output sequence to the input
|
||||||
|
* sequence. The beginning of the output sequence is advanced by @c n
|
||||||
|
* characters.
|
||||||
|
*
|
||||||
|
* Requires a preceding call <tt>prepare(x)</tt> where <tt>x >= n</tt>, and
|
||||||
|
* no intervening operations that modify the input or output sequence.
|
||||||
|
*
|
||||||
|
* @note If @c n is greater than the size of the output sequence, the entire
|
||||||
|
* output sequence is moved to the input sequence and no error is issued.
|
||||||
|
*/
|
||||||
|
void commit(std::size_t n)
|
||||||
|
{
|
||||||
|
n = std::min<std::size_t>(n, epptr() - pptr());
|
||||||
|
pbump(static_cast<int>(n));
|
||||||
|
setg(eback(), gptr(), pptr());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove characters from the input sequence.
|
||||||
|
/**
|
||||||
|
* Removes @c n characters from the beginning of the input sequence.
|
||||||
|
*
|
||||||
|
* @note If @c n is greater than the size of the input sequence, the entire
|
||||||
|
* input sequence is consumed and no error is issued.
|
||||||
|
*/
|
||||||
|
void consume(std::size_t n)
|
||||||
|
{
|
||||||
|
if (egptr() < pptr())
|
||||||
|
setg(&buffer_[0], gptr(), pptr());
|
||||||
|
if (gptr() + n > pptr())
|
||||||
|
n = pptr() - gptr();
|
||||||
|
gbump(static_cast<int>(n));
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
enum { buffer_delta = 128 };
|
||||||
|
|
||||||
|
/// Override std::streambuf behaviour.
|
||||||
|
/**
|
||||||
|
* Behaves according to the specification of @c std::streambuf::underflow().
|
||||||
|
*/
|
||||||
|
int_type underflow()
|
||||||
|
{
|
||||||
|
if (gptr() < pptr())
|
||||||
|
{
|
||||||
|
setg(&buffer_[0], gptr(), pptr());
|
||||||
|
return traits_type::to_int_type(*gptr());
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return traits_type::eof();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Override std::streambuf behaviour.
|
||||||
|
/**
|
||||||
|
* Behaves according to the specification of @c std::streambuf::overflow(),
|
||||||
|
* with the specialisation that @c std::length_error is thrown if appending
|
||||||
|
* the character to the input sequence would require the condition
|
||||||
|
* <tt>size() > max_size()</tt> to be true.
|
||||||
|
*/
|
||||||
|
int_type overflow(int_type c)
|
||||||
|
{
|
||||||
|
if (!traits_type::eq_int_type(c, traits_type::eof()))
|
||||||
|
{
|
||||||
|
if (pptr() == epptr())
|
||||||
|
{
|
||||||
|
std::size_t buffer_size = pptr() - gptr();
|
||||||
|
if (buffer_size < max_size_ && max_size_ - buffer_size < buffer_delta)
|
||||||
|
{
|
||||||
|
reserve(max_size_ - buffer_size);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
reserve(buffer_delta);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
*pptr() = traits_type::to_char_type(c);
|
||||||
|
pbump(1);
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
|
||||||
|
return traits_type::not_eof(c);
|
||||||
|
}
|
||||||
|
|
||||||
|
void reserve(std::size_t n)
|
||||||
|
{
|
||||||
|
// Get current stream positions as offsets.
|
||||||
|
std::size_t gnext = gptr() - &buffer_[0];
|
||||||
|
std::size_t pnext = pptr() - &buffer_[0];
|
||||||
|
std::size_t pend = epptr() - &buffer_[0];
|
||||||
|
|
||||||
|
// Check if there is already enough space in the put area.
|
||||||
|
if (n <= pend - pnext)
|
||||||
|
{
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Shift existing contents of get area to start of buffer.
|
||||||
|
if (gnext > 0)
|
||||||
|
{
|
||||||
|
pnext -= gnext;
|
||||||
|
std::memmove(&buffer_[0], &buffer_[0] + gnext, pnext);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Ensure buffer is large enough to hold at least the specified size.
|
||||||
|
if (n > pend - pnext)
|
||||||
|
{
|
||||||
|
if (n <= max_size_ && pnext <= max_size_ - n)
|
||||||
|
{
|
||||||
|
pend = pnext + n;
|
||||||
|
buffer_.resize((std::max<std::size_t>)(pend, 1));
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
std::length_error ex("asio::streambuf too long");
|
||||||
|
asio::detail::throw_exception(ex);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Update stream positions.
|
||||||
|
setg(&buffer_[0], &buffer_[0], &buffer_[0] + pnext);
|
||||||
|
setp(&buffer_[0] + pnext, &buffer_[0] + pend);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
std::size_t max_size_;
|
||||||
|
std::vector<char_type, Allocator> buffer_;
|
||||||
|
|
||||||
|
// Helper function to get the preferred size for reading data.
|
||||||
|
friend std::size_t read_size_helper(
|
||||||
|
basic_streambuf& sb, std::size_t max_size)
|
||||||
|
{
|
||||||
|
return std::min<std::size_t>(
|
||||||
|
std::max<std::size_t>(512, sb.buffer_.capacity() - sb.size()),
|
||||||
|
std::min<std::size_t>(max_size, sb.max_size() - sb.size()));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Adapts basic_streambuf to the dynamic buffer sequence type requirements.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Allocator = std::allocator<char> >
|
||||||
|
#else
|
||||||
|
template <typename Allocator>
|
||||||
|
#endif
|
||||||
|
class basic_streambuf_ref
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type used to represent the input sequence as a list of buffers.
|
||||||
|
typedef typename basic_streambuf<Allocator>::const_buffers_type
|
||||||
|
const_buffers_type;
|
||||||
|
|
||||||
|
/// The type used to represent the output sequence as a list of buffers.
|
||||||
|
typedef typename basic_streambuf<Allocator>::mutable_buffers_type
|
||||||
|
mutable_buffers_type;
|
||||||
|
|
||||||
|
/// Construct a basic_streambuf_ref for the given basic_streambuf object.
|
||||||
|
explicit basic_streambuf_ref(basic_streambuf<Allocator>& sb)
|
||||||
|
: sb_(sb)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Copy construct a basic_streambuf_ref.
|
||||||
|
basic_streambuf_ref(const basic_streambuf_ref& other) ASIO_NOEXCEPT
|
||||||
|
: sb_(other.sb_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move construct a basic_streambuf_ref.
|
||||||
|
basic_streambuf_ref(basic_streambuf_ref&& other) ASIO_NOEXCEPT
|
||||||
|
: sb_(other.sb_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Get the size of the input sequence.
|
||||||
|
std::size_t size() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return sb_.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the maximum size of the dynamic buffer.
|
||||||
|
std::size_t max_size() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return sb_.max_size();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the current capacity of the dynamic buffer.
|
||||||
|
std::size_t capacity() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return sb_.capacity();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a list of buffers that represents the input sequence.
|
||||||
|
const_buffers_type data() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return sb_.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a list of buffers that represents the output sequence, with the given
|
||||||
|
/// size.
|
||||||
|
mutable_buffers_type prepare(std::size_t n)
|
||||||
|
{
|
||||||
|
return sb_.prepare(n);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move bytes from the output sequence to the input sequence.
|
||||||
|
void commit(std::size_t n)
|
||||||
|
{
|
||||||
|
return sb_.commit(n);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Remove characters from the input sequence.
|
||||||
|
void consume(std::size_t n)
|
||||||
|
{
|
||||||
|
return sb_.consume(n);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_streambuf<Allocator>& sb_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_STREAMBUF_HPP
|
36
lib/asio-1.26.0/asio/basic_streambuf_fwd.hpp
Normal file
36
lib/asio-1.26.0/asio/basic_streambuf_fwd.hpp
Normal file
|
@ -0,0 +1,36 @@
|
||||||
|
//
|
||||||
|
// basic_streambuf_fwd.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_STREAMBUF_FWD_HPP
|
||||||
|
#define ASIO_BASIC_STREAMBUF_FWD_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#include <memory>
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename Allocator = std::allocator<char> >
|
||||||
|
class basic_streambuf;
|
||||||
|
|
||||||
|
template <typename Allocator = std::allocator<char> >
|
||||||
|
class basic_streambuf_ref;
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_IOSTREAM)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_STREAMBUF_FWD_HPP
|
833
lib/asio-1.26.0/asio/basic_waitable_timer.hpp
Normal file
833
lib/asio-1.26.0/asio/basic_waitable_timer.hpp
Normal file
|
@ -0,0 +1,833 @@
|
||||||
|
//
|
||||||
|
// basic_waitable_timer.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_WAITABLE_TIMER_HPP
|
||||||
|
#define ASIO_BASIC_WAITABLE_TIMER_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/detail/chrono_time_traits.hpp"
|
||||||
|
#include "asio/detail/deadline_timer_service.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/io_object_impl.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/wait_traits.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
# include <utility>
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
#if !defined(ASIO_BASIC_WAITABLE_TIMER_FWD_DECL)
|
||||||
|
#define ASIO_BASIC_WAITABLE_TIMER_FWD_DECL
|
||||||
|
|
||||||
|
// Forward declaration with defaulted arguments.
|
||||||
|
template <typename Clock,
|
||||||
|
typename WaitTraits = asio::wait_traits<Clock>,
|
||||||
|
typename Executor = any_io_executor>
|
||||||
|
class basic_waitable_timer;
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_BASIC_WAITABLE_TIMER_FWD_DECL)
|
||||||
|
|
||||||
|
/// Provides waitable timer functionality.
|
||||||
|
/**
|
||||||
|
* The basic_waitable_timer class template provides the ability to perform a
|
||||||
|
* blocking or asynchronous wait for a timer to expire.
|
||||||
|
*
|
||||||
|
* A waitable timer is always in one of two states: "expired" or "not expired".
|
||||||
|
* If the wait() or async_wait() function is called on an expired timer, the
|
||||||
|
* wait operation will complete immediately.
|
||||||
|
*
|
||||||
|
* Most applications will use one of the asio::steady_timer,
|
||||||
|
* asio::system_timer or asio::high_resolution_timer typedefs.
|
||||||
|
*
|
||||||
|
* @note This waitable timer functionality is for use with the C++11 standard
|
||||||
|
* library's @c <chrono> facility, or with the Boost.Chrono library.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Examples
|
||||||
|
* Performing a blocking wait (C++11):
|
||||||
|
* @code
|
||||||
|
* // Construct a timer without setting an expiry time.
|
||||||
|
* asio::steady_timer timer(my_context);
|
||||||
|
*
|
||||||
|
* // Set an expiry time relative to now.
|
||||||
|
* timer.expires_after(std::chrono::seconds(5));
|
||||||
|
*
|
||||||
|
* // Wait for the timer to expire.
|
||||||
|
* timer.wait();
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par
|
||||||
|
* Performing an asynchronous wait (C++11):
|
||||||
|
* @code
|
||||||
|
* void handler(const asio::error_code& error)
|
||||||
|
* {
|
||||||
|
* if (!error)
|
||||||
|
* {
|
||||||
|
* // Timer expired.
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* ...
|
||||||
|
*
|
||||||
|
* // Construct a timer with an absolute expiry time.
|
||||||
|
* asio::steady_timer timer(my_context,
|
||||||
|
* std::chrono::steady_clock::now() + std::chrono::seconds(60));
|
||||||
|
*
|
||||||
|
* // Start an asynchronous wait.
|
||||||
|
* timer.async_wait(handler);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Changing an active waitable timer's expiry time
|
||||||
|
*
|
||||||
|
* Changing the expiry time of a timer while there are pending asynchronous
|
||||||
|
* waits causes those wait operations to be cancelled. To ensure that the action
|
||||||
|
* associated with the timer is performed only once, use something like this:
|
||||||
|
* used:
|
||||||
|
*
|
||||||
|
* @code
|
||||||
|
* void on_some_event()
|
||||||
|
* {
|
||||||
|
* if (my_timer.expires_after(seconds(5)) > 0)
|
||||||
|
* {
|
||||||
|
* // We managed to cancel the timer. Start new asynchronous wait.
|
||||||
|
* my_timer.async_wait(on_timeout);
|
||||||
|
* }
|
||||||
|
* else
|
||||||
|
* {
|
||||||
|
* // Too late, timer has already expired!
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* void on_timeout(const asio::error_code& e)
|
||||||
|
* {
|
||||||
|
* if (e != asio::error::operation_aborted)
|
||||||
|
* {
|
||||||
|
* // Timer was not cancelled, take necessary action.
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @li The asio::basic_waitable_timer::expires_after() function
|
||||||
|
* cancels any pending asynchronous waits, and returns the number of
|
||||||
|
* asynchronous waits that were cancelled. If it returns 0 then you were too
|
||||||
|
* late and the wait handler has already been executed, or will soon be
|
||||||
|
* executed. If it returns 1 then the wait handler was successfully cancelled.
|
||||||
|
*
|
||||||
|
* @li If a wait handler is cancelled, the asio::error_code passed to
|
||||||
|
* it contains the value asio::error::operation_aborted.
|
||||||
|
*/
|
||||||
|
template <typename Clock, typename WaitTraits, typename Executor>
|
||||||
|
class basic_waitable_timer
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_wait;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the timer type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The timer type when rebound to the specified executor.
|
||||||
|
typedef basic_waitable_timer<Clock, WaitTraits, Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The clock type.
|
||||||
|
typedef Clock clock_type;
|
||||||
|
|
||||||
|
/// The duration type of the clock.
|
||||||
|
typedef typename clock_type::duration duration;
|
||||||
|
|
||||||
|
/// The time point type of the clock.
|
||||||
|
typedef typename clock_type::time_point time_point;
|
||||||
|
|
||||||
|
/// The wait traits type.
|
||||||
|
typedef WaitTraits traits_type;
|
||||||
|
|
||||||
|
/// Constructor.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer without setting an expiry time. The
|
||||||
|
* expires_at() or expires_after() functions must be called to set an expiry
|
||||||
|
* time before the timer can be waited on.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the timer will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the timer.
|
||||||
|
*/
|
||||||
|
explicit basic_waitable_timer(const executor_type& ex)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer without setting an expiry time. The
|
||||||
|
* expires_at() or expires_after() functions must be called to set an expiry
|
||||||
|
* time before the timer can be waited on.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the timer will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the timer.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_waitable_timer(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor object that the timer will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, expressed
|
||||||
|
* as an absolute time.
|
||||||
|
*/
|
||||||
|
basic_waitable_timer(const executor_type& ex, const time_point& expiry_time)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_at(impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_at");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the timer will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, expressed
|
||||||
|
* as an absolute time.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_waitable_timer(ExecutionContext& context,
|
||||||
|
const time_point& expiry_time,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_at(impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_at");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the timer will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, relative to
|
||||||
|
* now.
|
||||||
|
*/
|
||||||
|
basic_waitable_timer(const executor_type& ex, const duration& expiry_time)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_after(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_after");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Constructor to set a particular expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This constructor creates a timer and sets the expiry time.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the timer will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the timer.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer, relative to
|
||||||
|
* now.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_waitable_timer(ExecutionContext& context,
|
||||||
|
const duration& expiry_time,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().expires_after(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_after");
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_waitable_timer from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a timer from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_waitable_timer object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_waitable_timer(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_waitable_timer(basic_waitable_timer&& other)
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_waitable_timer from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a timer from one object to another. Cancels
|
||||||
|
* any outstanding asynchronous operations associated with the target object.
|
||||||
|
*
|
||||||
|
* @param other The other basic_waitable_timer object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_waitable_timer(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_waitable_timer& operator=(basic_waitable_timer&& other)
|
||||||
|
{
|
||||||
|
impl_ = std::move(other.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
// All timers have access to each other's implementations.
|
||||||
|
template <typename Clock1, typename WaitTraits1, typename Executor1>
|
||||||
|
friend class basic_waitable_timer;
|
||||||
|
|
||||||
|
/// Move-construct a basic_waitable_timer from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a timer from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_waitable_timer object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_waitable_timer(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
basic_waitable_timer(
|
||||||
|
basic_waitable_timer<Clock, WaitTraits, Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_waitable_timer from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a timer from one object to another. Cancels
|
||||||
|
* any outstanding asynchronous operations associated with the target object.
|
||||||
|
*
|
||||||
|
* @param other The other basic_waitable_timer object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_waitable_timer(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_waitable_timer&
|
||||||
|
>::type operator=(basic_waitable_timer<Clock, WaitTraits, Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_waitable_timer tmp(std::move(other));
|
||||||
|
impl_ = std::move(tmp.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the timer.
|
||||||
|
/**
|
||||||
|
* This function destroys the timer, cancelling any outstanding asynchronous
|
||||||
|
* wait operations associated with the timer as if by calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_waitable_timer()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
const executor_type& get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel any asynchronous operations that are waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of any pending asynchronous wait
|
||||||
|
* operations against the timer. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel() is called, then the
|
||||||
|
* handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use non-error_code overload.) Cancel any asynchronous
|
||||||
|
/// operations that are waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of any pending asynchronous wait
|
||||||
|
* operations against the timer. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel() is called, then the
|
||||||
|
* handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// Cancels one asynchronous operation that is waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of one pending asynchronous wait
|
||||||
|
* operation against the timer. Handlers are cancelled in FIFO order. The
|
||||||
|
* handler for the cancelled operation will be invoked with the
|
||||||
|
* asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled. That is,
|
||||||
|
* either 0 or 1.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel_one() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel_one()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().cancel_one(
|
||||||
|
impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel_one");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use non-error_code overload.) Cancels one asynchronous
|
||||||
|
/// operation that is waiting on the timer.
|
||||||
|
/**
|
||||||
|
* This function forces the completion of one pending asynchronous wait
|
||||||
|
* operation against the timer. Handlers are cancelled in FIFO order. The
|
||||||
|
* handler for the cancelled operation will be invoked with the
|
||||||
|
* asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* Cancelling the timer does not change the expiry time.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled. That is,
|
||||||
|
* either 0 or 1.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when cancel_one() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t cancel_one(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().cancel_one(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use expiry().) Get the timer's expiry time as an absolute
|
||||||
|
/// time.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the timer's current expiry time.
|
||||||
|
* Whether the timer has expired or not does not affect this value.
|
||||||
|
*/
|
||||||
|
time_point expires_at() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_at(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// Get the timer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the timer's current expiry time.
|
||||||
|
* Whether the timer has expired or not does not affect this value.
|
||||||
|
*/
|
||||||
|
time_point expiry() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().expiry(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the timer's expiry time as an absolute time.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_at() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_at(const time_point& expiry_time)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().expires_at(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_at");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use non-error_code overload.) Set the timer's expiry time as
|
||||||
|
/// an absolute time.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_at() is called, then
|
||||||
|
* the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_at(const time_point& expiry_time,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_at(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// Set the timer's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_after() is called,
|
||||||
|
* then the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_after(const duration& expiry_time)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().expires_after(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_after");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
/// (Deprecated: Use expiry().) Get the timer's expiry time relative to now.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the timer's current expiry time.
|
||||||
|
* Whether the timer has expired or not does not affect this value.
|
||||||
|
*/
|
||||||
|
duration expires_from_now() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_from_now(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use expires_after().) Set the timer's expiry time relative
|
||||||
|
/// to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_from_now() is called,
|
||||||
|
* then the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_from_now(const duration& expiry_time)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().expires_from_now(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
asio::detail::throw_error(ec, "expires_from_now");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// (Deprecated: Use expires_after().) Set the timer's expiry time relative
|
||||||
|
/// to now.
|
||||||
|
/**
|
||||||
|
* This function sets the expiry time. Any pending asynchronous wait
|
||||||
|
* operations will be cancelled. The handler for each cancelled operation will
|
||||||
|
* be invoked with the asio::error::operation_aborted error code.
|
||||||
|
*
|
||||||
|
* @param expiry_time The expiry time to be used for the timer.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @return The number of asynchronous operations that were cancelled.
|
||||||
|
*
|
||||||
|
* @note If the timer has already expired when expires_from_now() is called,
|
||||||
|
* then the handlers for asynchronous wait operations will:
|
||||||
|
*
|
||||||
|
* @li have already been invoked; or
|
||||||
|
*
|
||||||
|
* @li have been queued for invocation in the near future.
|
||||||
|
*
|
||||||
|
* These handlers can no longer be cancelled, and therefore are passed an
|
||||||
|
* error code that indicates the successful completion of the wait operation.
|
||||||
|
*/
|
||||||
|
std::size_t expires_from_now(const duration& expiry_time,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().expires_from_now(
|
||||||
|
impl_.get_implementation(), expiry_time, ec);
|
||||||
|
}
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
/// Perform a blocking wait on the timer.
|
||||||
|
/**
|
||||||
|
* This function is used to wait for the timer to expire. This function
|
||||||
|
* blocks and does not return until the timer has expired.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void wait()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().wait(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "wait");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Perform a blocking wait on the timer.
|
||||||
|
/**
|
||||||
|
* This function is used to wait for the timer to expire. This function
|
||||||
|
* blocks and does not return until the timer has expired.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
void wait(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().wait(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous wait on the timer.
|
||||||
|
/**
|
||||||
|
* This function may be used to initiate an asynchronous wait against the
|
||||||
|
* timer. It is an initiating function for an @ref asynchronous_operation,
|
||||||
|
* and always returns immediately.
|
||||||
|
*
|
||||||
|
* For each call to async_wait(), the completion handler will be called
|
||||||
|
* exactly once. The completion handler will be called when:
|
||||||
|
*
|
||||||
|
* @li The timer has expired.
|
||||||
|
*
|
||||||
|
* @li The timer was cancelled, in which case the handler is passed the error
|
||||||
|
* code asio::error::operation_aborted.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the timer expires. Potential
|
||||||
|
* completion tokens include @ref use_future, @ref use_awaitable, @ref
|
||||||
|
* yield_context, or a function object with the correct completion signature.
|
||||||
|
* The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error // Result of operation.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code) @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* This asynchronous operation supports cancellation for the following
|
||||||
|
* asio::cancellation_type values:
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::terminal
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::partial
|
||||||
|
*
|
||||||
|
* @li @c cancellation_type::total
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code))
|
||||||
|
WaitToken ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(
|
||||||
|
WaitToken, void (asio::error_code))
|
||||||
|
async_wait(
|
||||||
|
ASIO_MOVE_ARG(WaitToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WaitToken, void (asio::error_code)>(
|
||||||
|
declval<initiate_async_wait>(), token)))
|
||||||
|
{
|
||||||
|
return async_initiate<WaitToken, void (asio::error_code)>(
|
||||||
|
initiate_async_wait(this), token);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_waitable_timer(const basic_waitable_timer&) ASIO_DELETED;
|
||||||
|
basic_waitable_timer& operator=(
|
||||||
|
const basic_waitable_timer&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_wait
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_wait(basic_waitable_timer* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename WaitHandler>
|
||||||
|
void operator()(ASIO_MOVE_ARG(WaitHandler) handler) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a WaitHandler.
|
||||||
|
ASIO_WAIT_HANDLER_CHECK(WaitHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<WaitHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_wait(
|
||||||
|
self_->impl_.get_implementation(),
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_waitable_timer* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
detail::io_object_impl<
|
||||||
|
detail::deadline_timer_service<
|
||||||
|
detail::chrono_time_traits<Clock, WaitTraits> >,
|
||||||
|
executor_type > impl_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_WAITABLE_TIMER_HPP
|
631
lib/asio-1.26.0/asio/basic_writable_pipe.hpp
Normal file
631
lib/asio-1.26.0/asio/basic_writable_pipe.hpp
Normal file
|
@ -0,0 +1,631 @@
|
||||||
|
//
|
||||||
|
// basic_writable_pipe.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BASIC_WRITABLE_PIPE_HPP
|
||||||
|
#define ASIO_BASIC_WRITABLE_PIPE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_PIPE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <string>
|
||||||
|
#include "asio/any_io_executor.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/handler_type_requirements.hpp"
|
||||||
|
#include "asio/detail/io_object_impl.hpp"
|
||||||
|
#include "asio/detail/non_const_lvalue.hpp"
|
||||||
|
#include "asio/detail/throw_error.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
# include "asio/detail/win_iocp_handle_service.hpp"
|
||||||
|
#elif defined(ASIO_HAS_IO_URING_AS_DEFAULT)
|
||||||
|
# include "asio/detail/io_uring_descriptor_service.hpp"
|
||||||
|
#else
|
||||||
|
# include "asio/detail/reactive_descriptor_service.hpp"
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
# include <utility>
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Provides pipe functionality.
|
||||||
|
/**
|
||||||
|
* The basic_writable_pipe class provides a wrapper over pipe
|
||||||
|
* functionality.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*/
|
||||||
|
template <typename Executor = any_io_executor>
|
||||||
|
class basic_writable_pipe
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
class initiate_async_write_some;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
/// Rebinds the pipe type to another executor.
|
||||||
|
template <typename Executor1>
|
||||||
|
struct rebind_executor
|
||||||
|
{
|
||||||
|
/// The pipe type when rebound to the specified executor.
|
||||||
|
typedef basic_writable_pipe<Executor1> other;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// The native representation of a pipe.
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef implementation_defined native_handle_type;
|
||||||
|
#elif defined(ASIO_HAS_IOCP)
|
||||||
|
typedef detail::win_iocp_handle_service::native_handle_type
|
||||||
|
native_handle_type;
|
||||||
|
#elif defined(ASIO_HAS_IO_URING_AS_DEFAULT)
|
||||||
|
typedef detail::io_uring_descriptor_service::native_handle_type
|
||||||
|
native_handle_type;
|
||||||
|
#else
|
||||||
|
typedef detail::reactive_descriptor_service::native_handle_type
|
||||||
|
native_handle_type;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// A basic_writable_pipe is always the lowest layer.
|
||||||
|
typedef basic_writable_pipe lowest_layer_type;
|
||||||
|
|
||||||
|
/// Construct a basic_writable_pipe without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe without opening it.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the pipe will use, by default, to dispatch
|
||||||
|
* handlers for any asynchronous operations performed on the pipe.
|
||||||
|
*/
|
||||||
|
explicit basic_writable_pipe(const executor_type& ex)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_writable_pipe without opening it.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe without opening it.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the pipe will use, by default, to dispatch handlers for any asynchronous
|
||||||
|
* operations performed on the pipe.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
explicit basic_writable_pipe(ExecutionContext& context,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_writable_pipe on an existing native pipe.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe object to hold an existing native
|
||||||
|
* pipe.
|
||||||
|
*
|
||||||
|
* @param ex The I/O executor that the pipe will use, by default, to
|
||||||
|
* dispatch handlers for any asynchronous operations performed on the
|
||||||
|
* pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
basic_writable_pipe(const executor_type& ex,
|
||||||
|
const native_handle_type& native_pipe)
|
||||||
|
: impl_(0, ex)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(),
|
||||||
|
native_pipe, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a basic_writable_pipe on an existing native pipe.
|
||||||
|
/**
|
||||||
|
* This constructor creates a pipe object to hold an existing native
|
||||||
|
* pipe.
|
||||||
|
*
|
||||||
|
* @param context An execution context which provides the I/O executor that
|
||||||
|
* the pipe will use, by default, to dispatch handlers for any
|
||||||
|
* asynchronous operations performed on the pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
basic_writable_pipe(ExecutionContext& context,
|
||||||
|
const native_handle_type& native_pipe,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: impl_(0, 0, context)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(),
|
||||||
|
native_pipe, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move-construct a basic_writable_pipe from another.
|
||||||
|
/**
|
||||||
|
* This constructor moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_writable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_writable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_writable_pipe(basic_writable_pipe&& other)
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_writable_pipe from another.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_writable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_writable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
basic_writable_pipe& operator=(basic_writable_pipe&& other)
|
||||||
|
{
|
||||||
|
impl_ = std::move(other.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
// All pipes have access to each other's implementations.
|
||||||
|
template <typename Executor1>
|
||||||
|
friend class basic_writable_pipe;
|
||||||
|
|
||||||
|
/// Move-construct a basic_writable_pipe from a pipe of another executor type.
|
||||||
|
/**
|
||||||
|
* This constructor moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_writable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_writable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
basic_writable_pipe(basic_writable_pipe<Executor1>&& other,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
defaulted_constraint
|
||||||
|
>::type = defaulted_constraint())
|
||||||
|
: impl_(std::move(other.impl_))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move-assign a basic_writable_pipe from a pipe of another executor type.
|
||||||
|
/**
|
||||||
|
* This assignment operator moves a pipe from one object to another.
|
||||||
|
*
|
||||||
|
* @param other The other basic_writable_pipe object from which the move will
|
||||||
|
* occur.
|
||||||
|
*
|
||||||
|
* @note Following the move, the moved-from object is in the same state as if
|
||||||
|
* constructed using the @c basic_writable_pipe(const executor_type&)
|
||||||
|
* constructor.
|
||||||
|
*/
|
||||||
|
template <typename Executor1>
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<Executor1, Executor>::value,
|
||||||
|
basic_writable_pipe&
|
||||||
|
>::type operator=(basic_writable_pipe<Executor1>&& other)
|
||||||
|
{
|
||||||
|
basic_writable_pipe tmp(std::move(other));
|
||||||
|
impl_ = std::move(tmp.impl_);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destroys the pipe.
|
||||||
|
/**
|
||||||
|
* This function destroys the pipe, cancelling any outstanding
|
||||||
|
* asynchronous wait operations associated with the pipe as if by
|
||||||
|
* calling @c cancel.
|
||||||
|
*/
|
||||||
|
~basic_writable_pipe()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
const executor_type& get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the lowest layer.
|
||||||
|
/**
|
||||||
|
* This function returns a reference to the lowest layer in a stack of
|
||||||
|
* layers. Since a basic_writable_pipe cannot contain any further layers, it
|
||||||
|
* simply returns a reference to itself.
|
||||||
|
*
|
||||||
|
* @return A reference to the lowest layer in the stack of layers. Ownership
|
||||||
|
* is not transferred to the caller.
|
||||||
|
*/
|
||||||
|
lowest_layer_type& lowest_layer()
|
||||||
|
{
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a const reference to the lowest layer.
|
||||||
|
/**
|
||||||
|
* This function returns a const reference to the lowest layer in a stack of
|
||||||
|
* layers. Since a basic_writable_pipe cannot contain any further layers, it
|
||||||
|
* simply returns a reference to itself.
|
||||||
|
*
|
||||||
|
* @return A const reference to the lowest layer in the stack of layers.
|
||||||
|
* Ownership is not transferred to the caller.
|
||||||
|
*/
|
||||||
|
const lowest_layer_type& lowest_layer() const
|
||||||
|
{
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Assign an existing native pipe to the pipe.
|
||||||
|
/*
|
||||||
|
* This function opens the pipe to hold an existing native pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void assign(const native_handle_type& native_pipe)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(), native_pipe, ec);
|
||||||
|
asio::detail::throw_error(ec, "assign");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Assign an existing native pipe to the pipe.
|
||||||
|
/*
|
||||||
|
* This function opens the pipe to hold an existing native pipe.
|
||||||
|
*
|
||||||
|
* @param native_pipe A native pipe.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID assign(const native_handle_type& native_pipe,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().assign(impl_.get_implementation(), native_pipe, ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine whether the pipe is open.
|
||||||
|
bool is_open() const
|
||||||
|
{
|
||||||
|
return impl_.get_service().is_open(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to close the pipe. Any asynchronous write operations
|
||||||
|
* will be cancelled immediately, and will complete with the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "close");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to close the pipe. Any asynchronous write operations
|
||||||
|
* will be cancelled immediately, and will complete with the
|
||||||
|
* asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Release ownership of the underlying native pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous write operations to
|
||||||
|
* finish immediately, and the handlers for cancelled operations will be
|
||||||
|
* passed the asio::error::operation_aborted error. Ownership of the
|
||||||
|
* native pipe is then transferred to the caller.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @note This function is unsupported on Windows versions prior to Windows
|
||||||
|
* 8.1, and will fail with asio::error::operation_not_supported on
|
||||||
|
* these platforms.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0603)
|
||||||
|
__declspec(deprecated("This function always fails with "
|
||||||
|
"operation_not_supported when used on Windows versions "
|
||||||
|
"prior to Windows 8.1."))
|
||||||
|
#endif
|
||||||
|
native_handle_type release()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
native_handle_type s = impl_.get_service().release(
|
||||||
|
impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "release");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Release ownership of the underlying native pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous write operations to
|
||||||
|
* finish immediately, and the handlers for cancelled operations will be
|
||||||
|
* passed the asio::error::operation_aborted error. Ownership of the
|
||||||
|
* native pipe is then transferred to the caller.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @note This function is unsupported on Windows versions prior to Windows
|
||||||
|
* 8.1, and will fail with asio::error::operation_not_supported on
|
||||||
|
* these platforms.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_MSVC) && (ASIO_MSVC >= 1400) \
|
||||||
|
&& (!defined(_WIN32_WINNT) || _WIN32_WINNT < 0x0603)
|
||||||
|
__declspec(deprecated("This function always fails with "
|
||||||
|
"operation_not_supported when used on Windows versions "
|
||||||
|
"prior to Windows 8.1."))
|
||||||
|
#endif
|
||||||
|
native_handle_type release(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().release(impl_.get_implementation(), ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the native pipe representation.
|
||||||
|
/**
|
||||||
|
* This function may be used to obtain the underlying representation of the
|
||||||
|
* pipe. This is intended to allow access to native pipe
|
||||||
|
* functionality that is not otherwise provided.
|
||||||
|
*/
|
||||||
|
native_handle_type native_handle()
|
||||||
|
{
|
||||||
|
return impl_.get_service().native_handle(impl_.get_implementation());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all asynchronous operations associated with the pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous write operations to
|
||||||
|
* finish immediately, and the handlers for cancelled operations will be
|
||||||
|
* passed the asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
void cancel()
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
asio::detail::throw_error(ec, "cancel");
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Cancel all asynchronous operations associated with the pipe.
|
||||||
|
/**
|
||||||
|
* This function causes all outstanding asynchronous write operations to
|
||||||
|
* finish immediately, and the handlers for cancelled operations will be
|
||||||
|
* passed the asio::error::operation_aborted error.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
ASIO_SYNC_OP_VOID cancel(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
impl_.get_service().cancel(impl_.get_implementation(), ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write some data to the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to write data to the pipe. The function call will
|
||||||
|
* block until one or more bytes of the data has been written successfully,
|
||||||
|
* or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the pipe.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes written.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure. An error code of
|
||||||
|
* asio::error::eof indicates that the connection was closed by the
|
||||||
|
* peer.
|
||||||
|
*
|
||||||
|
* @note The write_some operation may not transmit all of the data to the
|
||||||
|
* peer. Consider using the @ref write function if you need to ensure that
|
||||||
|
* all data is written before the blocking operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To write a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* pipe.write_some(asio::buffer(data, size));
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on writing multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
asio::error_code ec;
|
||||||
|
std::size_t s = impl_.get_service().write_some(
|
||||||
|
impl_.get_implementation(), buffers, ec);
|
||||||
|
asio::detail::throw_error(ec, "write_some");
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write some data to the pipe.
|
||||||
|
/**
|
||||||
|
* This function is used to write data to the pipe. The function call will
|
||||||
|
* block until one or more bytes of the data has been written successfully,
|
||||||
|
* or until an error occurs.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the pipe.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*
|
||||||
|
* @returns The number of bytes written. Returns 0 if an error occurred.
|
||||||
|
*
|
||||||
|
* @note The write_some operation may not transmit all of the data to the
|
||||||
|
* peer. Consider using the @ref write function if you need to ensure that
|
||||||
|
* all data is written before the blocking operation completes.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return impl_.get_service().write_some(
|
||||||
|
impl_.get_implementation(), buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous write.
|
||||||
|
/**
|
||||||
|
* This function is used to asynchronously write data to the pipe. It is an
|
||||||
|
* initiating function for an @ref asynchronous_operation, and always returns
|
||||||
|
* immediately.
|
||||||
|
*
|
||||||
|
* @param buffers One or more data buffers to be written to the pipe.
|
||||||
|
* Although the buffers object may be copied as necessary, ownership of the
|
||||||
|
* underlying memory blocks is retained by the caller, which must guarantee
|
||||||
|
* that they remain valid until the completion handler is called.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler, which will be called when the write completes.
|
||||||
|
* Potential completion tokens include @ref use_future, @ref use_awaitable,
|
||||||
|
* @ref yield_context, or a function object with the correct completion
|
||||||
|
* signature. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(
|
||||||
|
* const asio::error_code& error, // Result of operation.
|
||||||
|
* std::size_t bytes_transferred // Number of bytes written.
|
||||||
|
* ); @endcode
|
||||||
|
* Regardless of whether the asynchronous operation completes immediately or
|
||||||
|
* not, the completion handler will not be invoked from within this function.
|
||||||
|
* On immediate completion, invocation of the handler will be performed in a
|
||||||
|
* manner equivalent to using asio::post().
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*
|
||||||
|
* @note The write operation may not transmit all of the data to the peer.
|
||||||
|
* Consider using the @ref async_write function if you need to ensure that all
|
||||||
|
* data is written before the asynchronous operation completes.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* To write a single data buffer use the @ref buffer function as follows:
|
||||||
|
* @code
|
||||||
|
* pipe.async_write_some(asio::buffer(data, size), handler);
|
||||||
|
* @endcode
|
||||||
|
* See the @ref buffer documentation for information on writing multiple
|
||||||
|
* buffers in one go, and how to use it with arrays, boost::array or
|
||||||
|
* std::vector.
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteToken,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_write_some(const ConstBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(WriteToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<initiate_async_write_some>(), token, buffers)))
|
||||||
|
{
|
||||||
|
return async_initiate<WriteToken,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
initiate_async_write_some(this), token, buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
basic_writable_pipe(const basic_writable_pipe&) ASIO_DELETED;
|
||||||
|
basic_writable_pipe& operator=(const basic_writable_pipe&) ASIO_DELETED;
|
||||||
|
|
||||||
|
class initiate_async_write_some
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
explicit initiate_async_write_some(basic_writable_pipe* self)
|
||||||
|
: self_(self)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
const executor_type& get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return self_->get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename WriteHandler, typename ConstBufferSequence>
|
||||||
|
void operator()(ASIO_MOVE_ARG(WriteHandler) handler,
|
||||||
|
const ConstBufferSequence& buffers) const
|
||||||
|
{
|
||||||
|
// If you get an error on the following line it means that your handler
|
||||||
|
// does not meet the documented type requirements for a WriteHandler.
|
||||||
|
ASIO_WRITE_HANDLER_CHECK(WriteHandler, handler) type_check;
|
||||||
|
|
||||||
|
detail::non_const_lvalue<WriteHandler> handler2(handler);
|
||||||
|
self_->impl_.get_service().async_write_some(
|
||||||
|
self_->impl_.get_implementation(), buffers,
|
||||||
|
handler2.value, self_->impl_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
basic_writable_pipe* self_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
detail::io_object_impl<detail::win_iocp_handle_service, Executor> impl_;
|
||||||
|
#elif defined(ASIO_HAS_IO_URING_AS_DEFAULT)
|
||||||
|
detail::io_object_impl<detail::io_uring_descriptor_service, Executor> impl_;
|
||||||
|
#else
|
||||||
|
detail::io_object_impl<detail::reactive_descriptor_service, Executor> impl_;
|
||||||
|
#endif
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_PIPE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_BASIC_WRITABLE_PIPE_HPP
|
732
lib/asio-1.26.0/asio/bind_allocator.hpp
Normal file
732
lib/asio-1.26.0/asio/bind_allocator.hpp
Normal file
|
@ -0,0 +1,732 @@
|
||||||
|
//
|
||||||
|
// bind_allocator.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BIND_ALLOCATOR_HPP
|
||||||
|
#define ASIO_BIND_ALLOCATOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/variadic_templates.hpp"
|
||||||
|
#include "asio/associated_allocator.hpp"
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedef result_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct allocator_binder_result_type
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
typedef void result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct allocator_binder_result_type<T,
|
||||||
|
typename void_type<typename T::result_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::result_type result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R>
|
||||||
|
struct allocator_binder_result_type<R(*)()>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R>
|
||||||
|
struct allocator_binder_result_type<R(&)()>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct allocator_binder_result_type<R(*)(A1)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct allocator_binder_result_type<R(&)(A1)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct allocator_binder_result_type<R(*)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct allocator_binder_result_type<R(&)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedef argument_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct allocator_binder_argument_type {};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct allocator_binder_argument_type<T,
|
||||||
|
typename void_type<typename T::argument_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::argument_type argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct allocator_binder_argument_type<R(*)(A1)>
|
||||||
|
{
|
||||||
|
typedef A1 argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct allocator_binder_argument_type<R(&)(A1)>
|
||||||
|
{
|
||||||
|
typedef A1 argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedefs first_argument_type and
|
||||||
|
// second_argument_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct allocator_binder_argument_types {};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct allocator_binder_argument_types<T,
|
||||||
|
typename void_type<typename T::first_argument_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::first_argument_type first_argument_type;
|
||||||
|
typedef typename T::second_argument_type second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct allocator_binder_argument_type<R(*)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef A1 first_argument_type;
|
||||||
|
typedef A2 second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct allocator_binder_argument_type<R(&)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef A1 first_argument_type;
|
||||||
|
typedef A2 second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to enable SFINAE on zero-argument operator() below.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct allocator_binder_result_of0
|
||||||
|
{
|
||||||
|
typedef void type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct allocator_binder_result_of0<T,
|
||||||
|
typename void_type<typename result_of<T()>::type>::type>
|
||||||
|
{
|
||||||
|
typedef typename result_of<T()>::type type;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// A call wrapper type to bind an allocator of type @c Allocator
|
||||||
|
/// to an object of type @c T.
|
||||||
|
template <typename T, typename Allocator>
|
||||||
|
class allocator_binder
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: public detail::allocator_binder_result_type<T>,
|
||||||
|
public detail::allocator_binder_argument_type<T>,
|
||||||
|
public detail::allocator_binder_argument_types<T>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the target object.
|
||||||
|
typedef T target_type;
|
||||||
|
|
||||||
|
/// The type of the associated allocator.
|
||||||
|
typedef Allocator allocator_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The return type if a function.
|
||||||
|
/**
|
||||||
|
* The type of @c result_type is based on the type @c T of the wrapper's
|
||||||
|
* target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to function type, @c result_type is a synonym for
|
||||||
|
* the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c result_type, then @c
|
||||||
|
* result_type is a synonym for @c T::result_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c result_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below result_type;
|
||||||
|
|
||||||
|
/// The type of the function's argument.
|
||||||
|
/**
|
||||||
|
* The type of @c argument_type is based on the type @c T of the wrapper's
|
||||||
|
* target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting a single argument,
|
||||||
|
* @c argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c argument_type, then @c
|
||||||
|
* argument_type is a synonym for @c T::argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below argument_type;
|
||||||
|
|
||||||
|
/// The type of the function's first argument.
|
||||||
|
/**
|
||||||
|
* The type of @c first_argument_type is based on the type @c T of the
|
||||||
|
* wrapper's target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting two arguments, @c
|
||||||
|
* first_argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c first_argument_type,
|
||||||
|
* then @c first_argument_type is a synonym for @c T::first_argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c first_argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below first_argument_type;
|
||||||
|
|
||||||
|
/// The type of the function's second argument.
|
||||||
|
/**
|
||||||
|
* The type of @c second_argument_type is based on the type @c T of the
|
||||||
|
* wrapper's target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting two arguments, @c
|
||||||
|
* second_argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c first_argument_type,
|
||||||
|
* then @c second_argument_type is a synonym for @c T::second_argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c second_argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below second_argument_type;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct an allocator wrapper for the specified object.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U>
|
||||||
|
allocator_binder(const allocator_type& s,
|
||||||
|
ASIO_MOVE_ARG(U) u)
|
||||||
|
: allocator_(s),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(u))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Copy constructor.
|
||||||
|
allocator_binder(const allocator_binder& other)
|
||||||
|
: allocator_(other.get_allocator()),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy, but specify a different allocator.
|
||||||
|
allocator_binder(const allocator_type& s,
|
||||||
|
const allocator_binder& other)
|
||||||
|
: allocator_(s),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy of a different allocator wrapper type.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the @c Allocator type is
|
||||||
|
* constructible from type @c OtherAllocator, and the type @c T is
|
||||||
|
* constructible from type @c U.
|
||||||
|
*/
|
||||||
|
template <typename U, typename OtherAllocator>
|
||||||
|
allocator_binder(
|
||||||
|
const allocator_binder<U, OtherAllocator>& other)
|
||||||
|
: allocator_(other.get_allocator()),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy of a different allocator wrapper type, but
|
||||||
|
/// specify a different allocator.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U, typename OtherAllocator>
|
||||||
|
allocator_binder(const allocator_type& s,
|
||||||
|
const allocator_binder<U, OtherAllocator>& other)
|
||||||
|
: allocator_(s),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Move constructor.
|
||||||
|
allocator_binder(allocator_binder&& other)
|
||||||
|
: allocator_(ASIO_MOVE_CAST(allocator_type)(
|
||||||
|
other.get_allocator())),
|
||||||
|
target_(ASIO_MOVE_CAST(T)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct the target object, but specify a different allocator.
|
||||||
|
allocator_binder(const allocator_type& s,
|
||||||
|
allocator_binder&& other)
|
||||||
|
: allocator_(s),
|
||||||
|
target_(ASIO_MOVE_CAST(T)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct from a different allocator wrapper type.
|
||||||
|
template <typename U, typename OtherAllocator>
|
||||||
|
allocator_binder(
|
||||||
|
allocator_binder<U, OtherAllocator>&& other)
|
||||||
|
: allocator_(ASIO_MOVE_CAST(OtherAllocator)(
|
||||||
|
other.get_allocator())),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct from a different allocator wrapper type, but
|
||||||
|
/// specify a different allocator.
|
||||||
|
template <typename U, typename OtherAllocator>
|
||||||
|
allocator_binder(const allocator_type& s,
|
||||||
|
allocator_binder<U, OtherAllocator>&& other)
|
||||||
|
: allocator_(s),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destructor.
|
||||||
|
~allocator_binder()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a reference to the target object.
|
||||||
|
target_type& get() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return target_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a reference to the target object.
|
||||||
|
const target_type& get() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return target_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain the associated allocator.
|
||||||
|
allocator_type get_allocator() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return allocator_;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <typename... Args> auto operator()(Args&& ...);
|
||||||
|
template <typename... Args> auto operator()(Args&& ...) const;
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
/// Forwarding function call operator.
|
||||||
|
template <typename... Args>
|
||||||
|
typename result_of<T(Args...)>::type operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return target_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Forwarding function call operator.
|
||||||
|
template <typename... Args>
|
||||||
|
typename result_of<T(Args...)>::type operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const
|
||||||
|
{
|
||||||
|
return target_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
typename detail::allocator_binder_result_of0<T>::type operator()()
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
typename detail::allocator_binder_result_of0<T>::type
|
||||||
|
operator()() const
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_BINDER_CALL_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
typename result_of<T(ASIO_VARIADIC_TARGS(n))>::type operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
typename result_of<T(ASIO_VARIADIC_TARGS(n))>::type operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_BINDER_CALL_DEF)
|
||||||
|
#undef ASIO_PRIVATE_BINDER_CALL_DEF
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
typedef typename detail::allocator_binder_result_type<
|
||||||
|
T>::result_type_or_void result_type_or_void;
|
||||||
|
|
||||||
|
result_type_or_void operator()()
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
result_type_or_void operator()() const
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_BINDER_CALL_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
result_type_or_void operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
result_type_or_void operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_BINDER_CALL_DEF)
|
||||||
|
#undef ASIO_PRIVATE_BINDER_CALL_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
private:
|
||||||
|
Allocator allocator_;
|
||||||
|
T target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Associate an object of type @c T with an allocator of type
|
||||||
|
/// @c Allocator.
|
||||||
|
template <typename Allocator, typename T>
|
||||||
|
ASIO_NODISCARD inline allocator_binder<typename decay<T>::type, Allocator>
|
||||||
|
bind_allocator(const Allocator& s, ASIO_MOVE_ARG(T) t)
|
||||||
|
{
|
||||||
|
return allocator_binder<
|
||||||
|
typename decay<T>::type, Allocator>(
|
||||||
|
s, ASIO_MOVE_CAST(T)(t));
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult,
|
||||||
|
typename Allocator, typename = void>
|
||||||
|
struct allocator_binder_async_result_completion_handler_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename Allocator>
|
||||||
|
struct allocator_binder_async_result_completion_handler_type<
|
||||||
|
TargetAsyncResult, Allocator,
|
||||||
|
typename void_type<
|
||||||
|
typename TargetAsyncResult::completion_handler_type
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef allocator_binder<
|
||||||
|
typename TargetAsyncResult::completion_handler_type, Allocator>
|
||||||
|
completion_handler_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename = void>
|
||||||
|
struct allocator_binder_async_result_return_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult>
|
||||||
|
struct allocator_binder_async_result_return_type<
|
||||||
|
TargetAsyncResult,
|
||||||
|
typename void_type<
|
||||||
|
typename TargetAsyncResult::return_type
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef typename TargetAsyncResult::return_type return_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
template <typename T, typename Allocator, typename Signature>
|
||||||
|
class async_result<allocator_binder<T, Allocator>, Signature> :
|
||||||
|
public detail::allocator_binder_async_result_completion_handler_type<
|
||||||
|
async_result<T, Signature>, Allocator>,
|
||||||
|
public detail::allocator_binder_async_result_return_type<
|
||||||
|
async_result<T, Signature> >
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit async_result(allocator_binder<T, Allocator>& b)
|
||||||
|
: target_(b.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
typename async_result<T, Signature>::return_type get()
|
||||||
|
{
|
||||||
|
return target_.get();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Initiation>
|
||||||
|
struct init_wrapper
|
||||||
|
{
|
||||||
|
template <typename Init>
|
||||||
|
init_wrapper(const Allocator& allocator, ASIO_MOVE_ARG(Init) init)
|
||||||
|
: allocator_(allocator),
|
||||||
|
initiation_(ASIO_MOVE_CAST(Init)(init))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Handler, typename... Args>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)(
|
||||||
|
allocator_binder<
|
||||||
|
typename decay<Handler>::type, Allocator>(
|
||||||
|
allocator_, ASIO_MOVE_CAST(Handler)(handler)),
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler, typename... Args>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const
|
||||||
|
{
|
||||||
|
initiation_(
|
||||||
|
allocator_binder<
|
||||||
|
typename decay<Handler>::type, Allocator>(
|
||||||
|
allocator_, ASIO_MOVE_CAST(Handler)(handler)),
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)(
|
||||||
|
allocator_binder<
|
||||||
|
typename decay<Handler>::type, Allocator>(
|
||||||
|
allocator_, ASIO_MOVE_CAST(Handler)(handler)));
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler) const
|
||||||
|
{
|
||||||
|
initiation_(
|
||||||
|
allocator_binder<
|
||||||
|
typename decay<Handler>::type, Allocator>(
|
||||||
|
allocator_, ASIO_MOVE_CAST(Handler)(handler)));
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_INIT_WRAPPER_DEF(n) \
|
||||||
|
template <typename Handler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()( \
|
||||||
|
ASIO_MOVE_ARG(Handler) handler, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)( \
|
||||||
|
allocator_binder< \
|
||||||
|
typename decay<Handler>::type, Allocator>( \
|
||||||
|
allocator_, ASIO_MOVE_CAST(Handler)(handler)), \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <typename Handler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()( \
|
||||||
|
ASIO_MOVE_ARG(Handler) handler, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
initiation_( \
|
||||||
|
allocator_binder< \
|
||||||
|
typename decay<Handler>::type, Allocator>( \
|
||||||
|
allocator_, ASIO_MOVE_CAST(Handler)(handler)), \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_INIT_WRAPPER_DEF)
|
||||||
|
#undef ASIO_PRIVATE_INIT_WRAPPER_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
Allocator allocator_;
|
||||||
|
Initiation initiation_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature,
|
||||||
|
(async_initiate<T, Signature>(
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(),
|
||||||
|
declval<RawCompletionToken>().get(),
|
||||||
|
declval<ASIO_MOVE_ARG(Args)>()...)))
|
||||||
|
initiate(
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation,
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token,
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return async_initiate<T, Signature>(
|
||||||
|
init_wrapper<typename decay<Initiation>::type>(
|
||||||
|
token.get_allocator(),
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation)),
|
||||||
|
token.get(), ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Initiation, typename RawCompletionToken>
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature,
|
||||||
|
(async_initiate<T, Signature>(
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(),
|
||||||
|
declval<RawCompletionToken>().get())))
|
||||||
|
initiate(
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation,
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token)
|
||||||
|
{
|
||||||
|
return async_initiate<T, Signature>(
|
||||||
|
init_wrapper<typename decay<Initiation>::type>(
|
||||||
|
token.get_allocator(),
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation)),
|
||||||
|
token.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_INITIATE_DEF(n) \
|
||||||
|
template <typename Initiation, typename RawCompletionToken, \
|
||||||
|
ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature, \
|
||||||
|
(async_initiate<T, Signature>( \
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(), \
|
||||||
|
declval<RawCompletionToken>().get(), \
|
||||||
|
ASIO_VARIADIC_MOVE_DECLVAL(n)))) \
|
||||||
|
initiate( \
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation, \
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return async_initiate<T, Signature>( \
|
||||||
|
init_wrapper<typename decay<Initiation>::type>( \
|
||||||
|
token.get_allocator(), \
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation)), \
|
||||||
|
token.get(), ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_INITIATE_DEF)
|
||||||
|
#undef ASIO_PRIVATE_INITIATE_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
private:
|
||||||
|
async_result(const async_result&) ASIO_DELETED;
|
||||||
|
async_result& operator=(const async_result&) ASIO_DELETED;
|
||||||
|
|
||||||
|
async_result<T, Signature> target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <template <typename, typename> class Associator,
|
||||||
|
typename T, typename Allocator, typename DefaultCandidate>
|
||||||
|
struct associator<Associator,
|
||||||
|
allocator_binder<T, Allocator>,
|
||||||
|
DefaultCandidate>
|
||||||
|
{
|
||||||
|
typedef typename Associator<T, DefaultCandidate>::type type;
|
||||||
|
|
||||||
|
static type get(const allocator_binder<T, Allocator>& b) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return Associator<T, DefaultCandidate>::get(b.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const allocator_binder<T, Allocator>& b,
|
||||||
|
const DefaultCandidate& c) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
Associator<T, DefaultCandidate>::get(b.get(), c)))
|
||||||
|
{
|
||||||
|
return Associator<T, DefaultCandidate>::get(b.get(), c);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename Allocator, typename Allocator1>
|
||||||
|
struct associated_allocator<
|
||||||
|
allocator_binder<T, Allocator>,
|
||||||
|
Allocator1>
|
||||||
|
{
|
||||||
|
typedef Allocator type;
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const allocator_binder<T, Allocator>& b,
|
||||||
|
const Allocator1& = Allocator1()) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((b.get_allocator()))
|
||||||
|
{
|
||||||
|
return b.get_allocator();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BIND_ALLOCATOR_HPP
|
735
lib/asio-1.26.0/asio/bind_cancellation_slot.hpp
Normal file
735
lib/asio-1.26.0/asio/bind_cancellation_slot.hpp
Normal file
|
@ -0,0 +1,735 @@
|
||||||
|
//
|
||||||
|
// bind_cancellation_slot.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BIND_CANCELLATION_SLOT_HPP
|
||||||
|
#define ASIO_BIND_CANCELLATION_SLOT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/variadic_templates.hpp"
|
||||||
|
#include "asio/associated_cancellation_slot.hpp"
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedef result_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct cancellation_slot_binder_result_type
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
typedef void result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct cancellation_slot_binder_result_type<T,
|
||||||
|
typename void_type<typename T::result_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::result_type result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R>
|
||||||
|
struct cancellation_slot_binder_result_type<R(*)()>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R>
|
||||||
|
struct cancellation_slot_binder_result_type<R(&)()>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct cancellation_slot_binder_result_type<R(*)(A1)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct cancellation_slot_binder_result_type<R(&)(A1)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct cancellation_slot_binder_result_type<R(*)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct cancellation_slot_binder_result_type<R(&)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedef argument_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct cancellation_slot_binder_argument_type {};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct cancellation_slot_binder_argument_type<T,
|
||||||
|
typename void_type<typename T::argument_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::argument_type argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct cancellation_slot_binder_argument_type<R(*)(A1)>
|
||||||
|
{
|
||||||
|
typedef A1 argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct cancellation_slot_binder_argument_type<R(&)(A1)>
|
||||||
|
{
|
||||||
|
typedef A1 argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedefs first_argument_type and
|
||||||
|
// second_argument_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct cancellation_slot_binder_argument_types {};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct cancellation_slot_binder_argument_types<T,
|
||||||
|
typename void_type<typename T::first_argument_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::first_argument_type first_argument_type;
|
||||||
|
typedef typename T::second_argument_type second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct cancellation_slot_binder_argument_type<R(*)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef A1 first_argument_type;
|
||||||
|
typedef A2 second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct cancellation_slot_binder_argument_type<R(&)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef A1 first_argument_type;
|
||||||
|
typedef A2 second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to enable SFINAE on zero-argument operator() below.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct cancellation_slot_binder_result_of0
|
||||||
|
{
|
||||||
|
typedef void type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct cancellation_slot_binder_result_of0<T,
|
||||||
|
typename void_type<typename result_of<T()>::type>::type>
|
||||||
|
{
|
||||||
|
typedef typename result_of<T()>::type type;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// A call wrapper type to bind a cancellation slot of type @c CancellationSlot
|
||||||
|
/// to an object of type @c T.
|
||||||
|
template <typename T, typename CancellationSlot>
|
||||||
|
class cancellation_slot_binder
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: public detail::cancellation_slot_binder_result_type<T>,
|
||||||
|
public detail::cancellation_slot_binder_argument_type<T>,
|
||||||
|
public detail::cancellation_slot_binder_argument_types<T>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the target object.
|
||||||
|
typedef T target_type;
|
||||||
|
|
||||||
|
/// The type of the associated cancellation slot.
|
||||||
|
typedef CancellationSlot cancellation_slot_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The return type if a function.
|
||||||
|
/**
|
||||||
|
* The type of @c result_type is based on the type @c T of the wrapper's
|
||||||
|
* target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to function type, @c result_type is a synonym for
|
||||||
|
* the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c result_type, then @c
|
||||||
|
* result_type is a synonym for @c T::result_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c result_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below result_type;
|
||||||
|
|
||||||
|
/// The type of the function's argument.
|
||||||
|
/**
|
||||||
|
* The type of @c argument_type is based on the type @c T of the wrapper's
|
||||||
|
* target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting a single argument,
|
||||||
|
* @c argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c argument_type, then @c
|
||||||
|
* argument_type is a synonym for @c T::argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below argument_type;
|
||||||
|
|
||||||
|
/// The type of the function's first argument.
|
||||||
|
/**
|
||||||
|
* The type of @c first_argument_type is based on the type @c T of the
|
||||||
|
* wrapper's target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting two arguments, @c
|
||||||
|
* first_argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c first_argument_type,
|
||||||
|
* then @c first_argument_type is a synonym for @c T::first_argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c first_argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below first_argument_type;
|
||||||
|
|
||||||
|
/// The type of the function's second argument.
|
||||||
|
/**
|
||||||
|
* The type of @c second_argument_type is based on the type @c T of the
|
||||||
|
* wrapper's target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting two arguments, @c
|
||||||
|
* second_argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c first_argument_type,
|
||||||
|
* then @c second_argument_type is a synonym for @c T::second_argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c second_argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below second_argument_type;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct a cancellation slot wrapper for the specified object.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U>
|
||||||
|
cancellation_slot_binder(const cancellation_slot_type& s,
|
||||||
|
ASIO_MOVE_ARG(U) u)
|
||||||
|
: slot_(s),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(u))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Copy constructor.
|
||||||
|
cancellation_slot_binder(const cancellation_slot_binder& other)
|
||||||
|
: slot_(other.get_cancellation_slot()),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy, but specify a different cancellation slot.
|
||||||
|
cancellation_slot_binder(const cancellation_slot_type& s,
|
||||||
|
const cancellation_slot_binder& other)
|
||||||
|
: slot_(s),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy of a different cancellation slot wrapper type.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the @c CancellationSlot type is
|
||||||
|
* constructible from type @c OtherCancellationSlot, and the type @c T is
|
||||||
|
* constructible from type @c U.
|
||||||
|
*/
|
||||||
|
template <typename U, typename OtherCancellationSlot>
|
||||||
|
cancellation_slot_binder(
|
||||||
|
const cancellation_slot_binder<U, OtherCancellationSlot>& other)
|
||||||
|
: slot_(other.get_cancellation_slot()),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy of a different cancellation slot wrapper type, but
|
||||||
|
/// specify a different cancellation slot.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U, typename OtherCancellationSlot>
|
||||||
|
cancellation_slot_binder(const cancellation_slot_type& s,
|
||||||
|
const cancellation_slot_binder<U, OtherCancellationSlot>& other)
|
||||||
|
: slot_(s),
|
||||||
|
target_(other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Move constructor.
|
||||||
|
cancellation_slot_binder(cancellation_slot_binder&& other)
|
||||||
|
: slot_(ASIO_MOVE_CAST(cancellation_slot_type)(
|
||||||
|
other.get_cancellation_slot())),
|
||||||
|
target_(ASIO_MOVE_CAST(T)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct the target object, but specify a different cancellation
|
||||||
|
/// slot.
|
||||||
|
cancellation_slot_binder(const cancellation_slot_type& s,
|
||||||
|
cancellation_slot_binder&& other)
|
||||||
|
: slot_(s),
|
||||||
|
target_(ASIO_MOVE_CAST(T)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct from a different cancellation slot wrapper type.
|
||||||
|
template <typename U, typename OtherCancellationSlot>
|
||||||
|
cancellation_slot_binder(
|
||||||
|
cancellation_slot_binder<U, OtherCancellationSlot>&& other)
|
||||||
|
: slot_(ASIO_MOVE_CAST(OtherCancellationSlot)(
|
||||||
|
other.get_cancellation_slot())),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct from a different cancellation slot wrapper type, but
|
||||||
|
/// specify a different cancellation slot.
|
||||||
|
template <typename U, typename OtherCancellationSlot>
|
||||||
|
cancellation_slot_binder(const cancellation_slot_type& s,
|
||||||
|
cancellation_slot_binder<U, OtherCancellationSlot>&& other)
|
||||||
|
: slot_(s),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destructor.
|
||||||
|
~cancellation_slot_binder()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a reference to the target object.
|
||||||
|
target_type& get() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return target_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a reference to the target object.
|
||||||
|
const target_type& get() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return target_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain the associated cancellation slot.
|
||||||
|
cancellation_slot_type get_cancellation_slot() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return slot_;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <typename... Args> auto operator()(Args&& ...);
|
||||||
|
template <typename... Args> auto operator()(Args&& ...) const;
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
/// Forwarding function call operator.
|
||||||
|
template <typename... Args>
|
||||||
|
typename result_of<T(Args...)>::type operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return target_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Forwarding function call operator.
|
||||||
|
template <typename... Args>
|
||||||
|
typename result_of<T(Args...)>::type operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const
|
||||||
|
{
|
||||||
|
return target_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
typename detail::cancellation_slot_binder_result_of0<T>::type operator()()
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
typename detail::cancellation_slot_binder_result_of0<T>::type
|
||||||
|
operator()() const
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_BINDER_CALL_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
typename result_of<T(ASIO_VARIADIC_TARGS(n))>::type operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
typename result_of<T(ASIO_VARIADIC_TARGS(n))>::type operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_BINDER_CALL_DEF)
|
||||||
|
#undef ASIO_PRIVATE_BINDER_CALL_DEF
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
typedef typename detail::cancellation_slot_binder_result_type<
|
||||||
|
T>::result_type_or_void result_type_or_void;
|
||||||
|
|
||||||
|
result_type_or_void operator()()
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
result_type_or_void operator()() const
|
||||||
|
{
|
||||||
|
return target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_BINDER_CALL_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
result_type_or_void operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
result_type_or_void operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
return target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_BINDER_CALL_DEF)
|
||||||
|
#undef ASIO_PRIVATE_BINDER_CALL_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
private:
|
||||||
|
CancellationSlot slot_;
|
||||||
|
T target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Associate an object of type @c T with a cancellation slot of type
|
||||||
|
/// @c CancellationSlot.
|
||||||
|
template <typename CancellationSlot, typename T>
|
||||||
|
ASIO_NODISCARD inline
|
||||||
|
cancellation_slot_binder<typename decay<T>::type, CancellationSlot>
|
||||||
|
bind_cancellation_slot(const CancellationSlot& s, ASIO_MOVE_ARG(T) t)
|
||||||
|
{
|
||||||
|
return cancellation_slot_binder<
|
||||||
|
typename decay<T>::type, CancellationSlot>(
|
||||||
|
s, ASIO_MOVE_CAST(T)(t));
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult,
|
||||||
|
typename CancellationSlot, typename = void>
|
||||||
|
struct cancellation_slot_binder_async_result_completion_handler_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename CancellationSlot>
|
||||||
|
struct cancellation_slot_binder_async_result_completion_handler_type<
|
||||||
|
TargetAsyncResult, CancellationSlot,
|
||||||
|
typename void_type<
|
||||||
|
typename TargetAsyncResult::completion_handler_type
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef cancellation_slot_binder<
|
||||||
|
typename TargetAsyncResult::completion_handler_type, CancellationSlot>
|
||||||
|
completion_handler_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename = void>
|
||||||
|
struct cancellation_slot_binder_async_result_return_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult>
|
||||||
|
struct cancellation_slot_binder_async_result_return_type<
|
||||||
|
TargetAsyncResult,
|
||||||
|
typename void_type<
|
||||||
|
typename TargetAsyncResult::return_type
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef typename TargetAsyncResult::return_type return_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
template <typename T, typename CancellationSlot, typename Signature>
|
||||||
|
class async_result<cancellation_slot_binder<T, CancellationSlot>, Signature> :
|
||||||
|
public detail::cancellation_slot_binder_async_result_completion_handler_type<
|
||||||
|
async_result<T, Signature>, CancellationSlot>,
|
||||||
|
public detail::cancellation_slot_binder_async_result_return_type<
|
||||||
|
async_result<T, Signature> >
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit async_result(cancellation_slot_binder<T, CancellationSlot>& b)
|
||||||
|
: target_(b.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
typename async_result<T, Signature>::return_type get()
|
||||||
|
{
|
||||||
|
return target_.get();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Initiation>
|
||||||
|
struct init_wrapper
|
||||||
|
{
|
||||||
|
template <typename Init>
|
||||||
|
init_wrapper(const CancellationSlot& slot, ASIO_MOVE_ARG(Init) init)
|
||||||
|
: slot_(slot),
|
||||||
|
initiation_(ASIO_MOVE_CAST(Init)(init))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Handler, typename... Args>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)(
|
||||||
|
cancellation_slot_binder<
|
||||||
|
typename decay<Handler>::type, CancellationSlot>(
|
||||||
|
slot_, ASIO_MOVE_CAST(Handler)(handler)),
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler, typename... Args>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const
|
||||||
|
{
|
||||||
|
initiation_(
|
||||||
|
cancellation_slot_binder<
|
||||||
|
typename decay<Handler>::type, CancellationSlot>(
|
||||||
|
slot_, ASIO_MOVE_CAST(Handler)(handler)),
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)(
|
||||||
|
cancellation_slot_binder<
|
||||||
|
typename decay<Handler>::type, CancellationSlot>(
|
||||||
|
slot_, ASIO_MOVE_CAST(Handler)(handler)));
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler) const
|
||||||
|
{
|
||||||
|
initiation_(
|
||||||
|
cancellation_slot_binder<
|
||||||
|
typename decay<Handler>::type, CancellationSlot>(
|
||||||
|
slot_, ASIO_MOVE_CAST(Handler)(handler)));
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_INIT_WRAPPER_DEF(n) \
|
||||||
|
template <typename Handler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()( \
|
||||||
|
ASIO_MOVE_ARG(Handler) handler, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)( \
|
||||||
|
cancellation_slot_binder< \
|
||||||
|
typename decay<Handler>::type, CancellationSlot>( \
|
||||||
|
slot_, ASIO_MOVE_CAST(Handler)(handler)), \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <typename Handler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()( \
|
||||||
|
ASIO_MOVE_ARG(Handler) handler, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
initiation_( \
|
||||||
|
cancellation_slot_binder< \
|
||||||
|
typename decay<Handler>::type, CancellationSlot>( \
|
||||||
|
slot_, ASIO_MOVE_CAST(Handler)(handler)), \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_INIT_WRAPPER_DEF)
|
||||||
|
#undef ASIO_PRIVATE_INIT_WRAPPER_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
CancellationSlot slot_;
|
||||||
|
Initiation initiation_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature,
|
||||||
|
(async_initiate<T, Signature>(
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(),
|
||||||
|
declval<RawCompletionToken>().get(),
|
||||||
|
declval<ASIO_MOVE_ARG(Args)>()...)))
|
||||||
|
initiate(
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation,
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token,
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return async_initiate<T, Signature>(
|
||||||
|
init_wrapper<typename decay<Initiation>::type>(
|
||||||
|
token.get_cancellation_slot(),
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation)),
|
||||||
|
token.get(), ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Initiation, typename RawCompletionToken>
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature,
|
||||||
|
(async_initiate<T, Signature>(
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(),
|
||||||
|
declval<RawCompletionToken>().get())))
|
||||||
|
initiate(
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation,
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token)
|
||||||
|
{
|
||||||
|
return async_initiate<T, Signature>(
|
||||||
|
init_wrapper<typename decay<Initiation>::type>(
|
||||||
|
token.get_cancellation_slot(),
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation)),
|
||||||
|
token.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_INITIATE_DEF(n) \
|
||||||
|
template <typename Initiation, typename RawCompletionToken, \
|
||||||
|
ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature, \
|
||||||
|
(async_initiate<T, Signature>( \
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(), \
|
||||||
|
declval<RawCompletionToken>().get(), \
|
||||||
|
ASIO_VARIADIC_MOVE_DECLVAL(n)))) \
|
||||||
|
initiate( \
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation, \
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return async_initiate<T, Signature>( \
|
||||||
|
init_wrapper<typename decay<Initiation>::type>( \
|
||||||
|
token.get_cancellation_slot(), \
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation)), \
|
||||||
|
token.get(), ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_INITIATE_DEF)
|
||||||
|
#undef ASIO_PRIVATE_INITIATE_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
private:
|
||||||
|
async_result(const async_result&) ASIO_DELETED;
|
||||||
|
async_result& operator=(const async_result&) ASIO_DELETED;
|
||||||
|
|
||||||
|
async_result<T, Signature> target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <template <typename, typename> class Associator,
|
||||||
|
typename T, typename CancellationSlot, typename DefaultCandidate>
|
||||||
|
struct associator<Associator,
|
||||||
|
cancellation_slot_binder<T, CancellationSlot>,
|
||||||
|
DefaultCandidate>
|
||||||
|
{
|
||||||
|
typedef typename Associator<T, DefaultCandidate>::type type;
|
||||||
|
|
||||||
|
static type get(const cancellation_slot_binder<T, CancellationSlot>& b)
|
||||||
|
ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return Associator<T, DefaultCandidate>::get(b.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const cancellation_slot_binder<T, CancellationSlot>& b,
|
||||||
|
const DefaultCandidate& c) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
Associator<T, DefaultCandidate>::get(b.get(), c)))
|
||||||
|
{
|
||||||
|
return Associator<T, DefaultCandidate>::get(b.get(), c);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename CancellationSlot, typename CancellationSlot1>
|
||||||
|
struct associated_cancellation_slot<
|
||||||
|
cancellation_slot_binder<T, CancellationSlot>,
|
||||||
|
CancellationSlot1>
|
||||||
|
{
|
||||||
|
typedef CancellationSlot type;
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const cancellation_slot_binder<T, CancellationSlot>& b,
|
||||||
|
const CancellationSlot1& = CancellationSlot1()) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((b.get_cancellation_slot()))
|
||||||
|
{
|
||||||
|
return b.get_cancellation_slot();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BIND_CANCELLATION_SLOT_HPP
|
780
lib/asio-1.26.0/asio/bind_executor.hpp
Normal file
780
lib/asio-1.26.0/asio/bind_executor.hpp
Normal file
|
@ -0,0 +1,780 @@
|
||||||
|
//
|
||||||
|
// bind_executor.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BIND_EXECUTOR_HPP
|
||||||
|
#define ASIO_BIND_EXECUTOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/variadic_templates.hpp"
|
||||||
|
#include "asio/associated_executor.hpp"
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
#include "asio/uses_executor.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedef result_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct executor_binder_result_type
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
typedef void result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct executor_binder_result_type<T,
|
||||||
|
typename void_type<typename T::result_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::result_type result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R>
|
||||||
|
struct executor_binder_result_type<R(*)()>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R>
|
||||||
|
struct executor_binder_result_type<R(&)()>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct executor_binder_result_type<R(*)(A1)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct executor_binder_result_type<R(&)(A1)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct executor_binder_result_type<R(*)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct executor_binder_result_type<R(&)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef R result_type;
|
||||||
|
protected:
|
||||||
|
typedef result_type result_type_or_void;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedef argument_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct executor_binder_argument_type {};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct executor_binder_argument_type<T,
|
||||||
|
typename void_type<typename T::argument_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::argument_type argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct executor_binder_argument_type<R(*)(A1)>
|
||||||
|
{
|
||||||
|
typedef A1 argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1>
|
||||||
|
struct executor_binder_argument_type<R(&)(A1)>
|
||||||
|
{
|
||||||
|
typedef A1 argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to automatically define nested typedefs first_argument_type and
|
||||||
|
// second_argument_type.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct executor_binder_argument_types {};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct executor_binder_argument_types<T,
|
||||||
|
typename void_type<typename T::first_argument_type>::type>
|
||||||
|
{
|
||||||
|
typedef typename T::first_argument_type first_argument_type;
|
||||||
|
typedef typename T::second_argument_type second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct executor_binder_argument_type<R(*)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef A1 first_argument_type;
|
||||||
|
typedef A2 second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename R, typename A1, typename A2>
|
||||||
|
struct executor_binder_argument_type<R(&)(A1, A2)>
|
||||||
|
{
|
||||||
|
typedef A1 first_argument_type;
|
||||||
|
typedef A2 second_argument_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to perform uses_executor construction of the target type, if
|
||||||
|
// required.
|
||||||
|
|
||||||
|
template <typename T, typename Executor, bool UsesExecutor>
|
||||||
|
class executor_binder_base;
|
||||||
|
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
class executor_binder_base<T, Executor, true>
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
template <typename E, typename U>
|
||||||
|
executor_binder_base(ASIO_MOVE_ARG(E) e, ASIO_MOVE_ARG(U) u)
|
||||||
|
: executor_(ASIO_MOVE_CAST(E)(e)),
|
||||||
|
target_(executor_arg_t(), executor_, ASIO_MOVE_CAST(U)(u))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
Executor executor_;
|
||||||
|
T target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
class executor_binder_base<T, Executor, false>
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
template <typename E, typename U>
|
||||||
|
executor_binder_base(ASIO_MOVE_ARG(E) e, ASIO_MOVE_ARG(U) u)
|
||||||
|
: executor_(ASIO_MOVE_CAST(E)(e)),
|
||||||
|
target_(ASIO_MOVE_CAST(U)(u))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
Executor executor_;
|
||||||
|
T target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper to enable SFINAE on zero-argument operator() below.
|
||||||
|
|
||||||
|
template <typename T, typename = void>
|
||||||
|
struct executor_binder_result_of0
|
||||||
|
{
|
||||||
|
typedef void type;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct executor_binder_result_of0<T,
|
||||||
|
typename void_type<typename result_of<T()>::type>::type>
|
||||||
|
{
|
||||||
|
typedef typename result_of<T()>::type type;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// A call wrapper type to bind an executor of type @c Executor to an object of
|
||||||
|
/// type @c T.
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
class executor_binder
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
: public detail::executor_binder_result_type<T>,
|
||||||
|
public detail::executor_binder_argument_type<T>,
|
||||||
|
public detail::executor_binder_argument_types<T>,
|
||||||
|
private detail::executor_binder_base<
|
||||||
|
T, Executor, uses_executor<T, Executor>::value>
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the target object.
|
||||||
|
typedef T target_type;
|
||||||
|
|
||||||
|
/// The type of the associated executor.
|
||||||
|
typedef Executor executor_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The return type if a function.
|
||||||
|
/**
|
||||||
|
* The type of @c result_type is based on the type @c T of the wrapper's
|
||||||
|
* target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to function type, @c result_type is a synonym for
|
||||||
|
* the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c result_type, then @c
|
||||||
|
* result_type is a synonym for @c T::result_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c result_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below result_type;
|
||||||
|
|
||||||
|
/// The type of the function's argument.
|
||||||
|
/**
|
||||||
|
* The type of @c argument_type is based on the type @c T of the wrapper's
|
||||||
|
* target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting a single argument,
|
||||||
|
* @c argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c argument_type, then @c
|
||||||
|
* argument_type is a synonym for @c T::argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below argument_type;
|
||||||
|
|
||||||
|
/// The type of the function's first argument.
|
||||||
|
/**
|
||||||
|
* The type of @c first_argument_type is based on the type @c T of the
|
||||||
|
* wrapper's target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting two arguments, @c
|
||||||
|
* first_argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c first_argument_type,
|
||||||
|
* then @c first_argument_type is a synonym for @c T::first_argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c first_argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below first_argument_type;
|
||||||
|
|
||||||
|
/// The type of the function's second argument.
|
||||||
|
/**
|
||||||
|
* The type of @c second_argument_type is based on the type @c T of the
|
||||||
|
* wrapper's target object:
|
||||||
|
*
|
||||||
|
* @li if @c T is a pointer to a function type accepting two arguments, @c
|
||||||
|
* second_argument_type is a synonym for the return type of @c T;
|
||||||
|
*
|
||||||
|
* @li if @c T is a class type with a member type @c first_argument_type,
|
||||||
|
* then @c second_argument_type is a synonym for @c T::second_argument_type;
|
||||||
|
*
|
||||||
|
* @li otherwise @c second_argument_type is not defined.
|
||||||
|
*/
|
||||||
|
typedef see_below second_argument_type;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Construct an executor wrapper for the specified object.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U>
|
||||||
|
executor_binder(executor_arg_t, const executor_type& e,
|
||||||
|
ASIO_MOVE_ARG(U) u)
|
||||||
|
: base_type(e, ASIO_MOVE_CAST(U)(u))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Copy constructor.
|
||||||
|
executor_binder(const executor_binder& other)
|
||||||
|
: base_type(other.get_executor(), other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy, but specify a different executor.
|
||||||
|
executor_binder(executor_arg_t, const executor_type& e,
|
||||||
|
const executor_binder& other)
|
||||||
|
: base_type(e, other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy of a different executor wrapper type.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the @c Executor type is constructible
|
||||||
|
* from type @c OtherExecutor, and the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U, typename OtherExecutor>
|
||||||
|
executor_binder(const executor_binder<U, OtherExecutor>& other)
|
||||||
|
: base_type(other.get_executor(), other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct a copy of a different executor wrapper type, but specify a
|
||||||
|
/// different executor.
|
||||||
|
/**
|
||||||
|
* This constructor is only valid if the type @c T is constructible from type
|
||||||
|
* @c U.
|
||||||
|
*/
|
||||||
|
template <typename U, typename OtherExecutor>
|
||||||
|
executor_binder(executor_arg_t, const executor_type& e,
|
||||||
|
const executor_binder<U, OtherExecutor>& other)
|
||||||
|
: base_type(e, other.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Move constructor.
|
||||||
|
executor_binder(executor_binder&& other)
|
||||||
|
: base_type(ASIO_MOVE_CAST(executor_type)(other.get_executor()),
|
||||||
|
ASIO_MOVE_CAST(T)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct the target object, but specify a different executor.
|
||||||
|
executor_binder(executor_arg_t, const executor_type& e,
|
||||||
|
executor_binder&& other)
|
||||||
|
: base_type(e, ASIO_MOVE_CAST(T)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct from a different executor wrapper type.
|
||||||
|
template <typename U, typename OtherExecutor>
|
||||||
|
executor_binder(executor_binder<U, OtherExecutor>&& other)
|
||||||
|
: base_type(ASIO_MOVE_CAST(OtherExecutor)(other.get_executor()),
|
||||||
|
ASIO_MOVE_CAST(U)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Move construct from a different executor wrapper type, but specify a
|
||||||
|
/// different executor.
|
||||||
|
template <typename U, typename OtherExecutor>
|
||||||
|
executor_binder(executor_arg_t, const executor_type& e,
|
||||||
|
executor_binder<U, OtherExecutor>&& other)
|
||||||
|
: base_type(e, ASIO_MOVE_CAST(U)(other.get()))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Destructor.
|
||||||
|
~executor_binder()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a reference to the target object.
|
||||||
|
target_type& get() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return this->target_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain a reference to the target object.
|
||||||
|
const target_type& get() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return this->target_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Obtain the associated executor.
|
||||||
|
executor_type get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return this->executor_;
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <typename... Args> auto operator()(Args&& ...);
|
||||||
|
template <typename... Args> auto operator()(Args&& ...) const;
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
/// Forwarding function call operator.
|
||||||
|
template <typename... Args>
|
||||||
|
typename result_of<T(Args...)>::type operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return this->target_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Forwarding function call operator.
|
||||||
|
template <typename... Args>
|
||||||
|
typename result_of<T(Args...)>::type operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const
|
||||||
|
{
|
||||||
|
return this->target_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
typename detail::executor_binder_result_of0<T>::type operator()()
|
||||||
|
{
|
||||||
|
return this->target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
typename detail::executor_binder_result_of0<T>::type operator()() const
|
||||||
|
{
|
||||||
|
return this->target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_BIND_EXECUTOR_CALL_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
typename result_of<T(ASIO_VARIADIC_TARGS(n))>::type operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return this->target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
typename result_of<T(ASIO_VARIADIC_TARGS(n))>::type operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
return this->target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_BIND_EXECUTOR_CALL_DEF)
|
||||||
|
#undef ASIO_PRIVATE_BIND_EXECUTOR_CALL_DEF
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
typedef typename detail::executor_binder_result_type<T>::result_type_or_void
|
||||||
|
result_type_or_void;
|
||||||
|
|
||||||
|
result_type_or_void operator()()
|
||||||
|
{
|
||||||
|
return this->target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
result_type_or_void operator()() const
|
||||||
|
{
|
||||||
|
return this->target_();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_BIND_EXECUTOR_CALL_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
result_type_or_void operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return this->target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
result_type_or_void operator()( \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
return this->target_(ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_BIND_EXECUTOR_CALL_DEF)
|
||||||
|
#undef ASIO_PRIVATE_BIND_EXECUTOR_CALL_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_TYPE_TRAITS) && !defined(_MSC_VER)
|
||||||
|
|
||||||
|
private:
|
||||||
|
typedef detail::executor_binder_base<T, Executor,
|
||||||
|
uses_executor<T, Executor>::value> base_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Associate an object of type @c T with an executor of type @c Executor.
|
||||||
|
template <typename Executor, typename T>
|
||||||
|
ASIO_NODISCARD inline executor_binder<typename decay<T>::type, Executor>
|
||||||
|
bind_executor(const Executor& ex, ASIO_MOVE_ARG(T) t,
|
||||||
|
typename constraint<
|
||||||
|
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
{
|
||||||
|
return executor_binder<typename decay<T>::type, Executor>(
|
||||||
|
executor_arg_t(), ex, ASIO_MOVE_CAST(T)(t));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Associate an object of type @c T with an execution context's executor.
|
||||||
|
template <typename ExecutionContext, typename T>
|
||||||
|
ASIO_NODISCARD inline executor_binder<typename decay<T>::type,
|
||||||
|
typename ExecutionContext::executor_type>
|
||||||
|
bind_executor(ExecutionContext& ctx, ASIO_MOVE_ARG(T) t,
|
||||||
|
typename constraint<is_convertible<
|
||||||
|
ExecutionContext&, execution_context&>::value>::type = 0)
|
||||||
|
{
|
||||||
|
return executor_binder<typename decay<T>::type,
|
||||||
|
typename ExecutionContext::executor_type>(
|
||||||
|
executor_arg_t(), ctx.get_executor(), ASIO_MOVE_CAST(T)(t));
|
||||||
|
}
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
struct uses_executor<executor_binder<T, Executor>, Executor>
|
||||||
|
: true_type {};
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename Executor, typename = void>
|
||||||
|
class executor_binder_completion_handler_async_result
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename T>
|
||||||
|
explicit executor_binder_completion_handler_async_result(T&)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename Executor>
|
||||||
|
class executor_binder_completion_handler_async_result<
|
||||||
|
TargetAsyncResult, Executor,
|
||||||
|
typename void_type<
|
||||||
|
typename TargetAsyncResult::completion_handler_type
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef executor_binder<
|
||||||
|
typename TargetAsyncResult::completion_handler_type, Executor>
|
||||||
|
completion_handler_type;
|
||||||
|
|
||||||
|
explicit executor_binder_completion_handler_async_result(
|
||||||
|
typename TargetAsyncResult::completion_handler_type& handler)
|
||||||
|
: target_(handler)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
typename TargetAsyncResult::return_type get()
|
||||||
|
{
|
||||||
|
return target_.get();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
TargetAsyncResult target_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult, typename = void>
|
||||||
|
struct executor_binder_async_result_return_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename TargetAsyncResult>
|
||||||
|
struct executor_binder_async_result_return_type<
|
||||||
|
TargetAsyncResult,
|
||||||
|
typename void_type<
|
||||||
|
typename TargetAsyncResult::return_type
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
typedef typename TargetAsyncResult::return_type return_type;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
template <typename T, typename Executor, typename Signature>
|
||||||
|
class async_result<executor_binder<T, Executor>, Signature> :
|
||||||
|
public detail::executor_binder_completion_handler_async_result<
|
||||||
|
async_result<T, Signature>, Executor>,
|
||||||
|
public detail::executor_binder_async_result_return_type<
|
||||||
|
async_result<T, Signature> >
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit async_result(executor_binder<T, Executor>& b)
|
||||||
|
: detail::executor_binder_completion_handler_async_result<
|
||||||
|
async_result<T, Signature>, Executor>(b.get())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Initiation>
|
||||||
|
struct init_wrapper
|
||||||
|
{
|
||||||
|
template <typename Init>
|
||||||
|
init_wrapper(const Executor& ex, ASIO_MOVE_ARG(Init) init)
|
||||||
|
: ex_(ex),
|
||||||
|
initiation_(ASIO_MOVE_CAST(Init)(init))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Handler, typename... Args>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)(
|
||||||
|
executor_binder<typename decay<Handler>::type, Executor>(
|
||||||
|
executor_arg_t(), ex_, ASIO_MOVE_CAST(Handler)(handler)),
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler, typename... Args>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const
|
||||||
|
{
|
||||||
|
initiation_(
|
||||||
|
executor_binder<typename decay<Handler>::type, Executor>(
|
||||||
|
executor_arg_t(), ex_, ASIO_MOVE_CAST(Handler)(handler)),
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)(
|
||||||
|
executor_binder<typename decay<Handler>::type, Executor>(
|
||||||
|
executor_arg_t(), ex_, ASIO_MOVE_CAST(Handler)(handler)));
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(
|
||||||
|
ASIO_MOVE_ARG(Handler) handler) const
|
||||||
|
{
|
||||||
|
initiation_(
|
||||||
|
executor_binder<typename decay<Handler>::type, Executor>(
|
||||||
|
executor_arg_t(), ex_, ASIO_MOVE_CAST(Handler)(handler)));
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_INIT_WRAPPER_DEF(n) \
|
||||||
|
template <typename Handler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()( \
|
||||||
|
ASIO_MOVE_ARG(Handler) handler, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
ASIO_MOVE_CAST(Initiation)(initiation_)( \
|
||||||
|
executor_binder<typename decay<Handler>::type, Executor>( \
|
||||||
|
executor_arg_t(), ex_, ASIO_MOVE_CAST(Handler)(handler)), \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template <typename Handler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()( \
|
||||||
|
ASIO_MOVE_ARG(Handler) handler, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) const \
|
||||||
|
{ \
|
||||||
|
initiation_( \
|
||||||
|
executor_binder<typename decay<Handler>::type, Executor>( \
|
||||||
|
executor_arg_t(), ex_, ASIO_MOVE_CAST(Handler)(handler)), \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_INIT_WRAPPER_DEF)
|
||||||
|
#undef ASIO_PRIVATE_INIT_WRAPPER_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
Executor ex_;
|
||||||
|
Initiation initiation_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature,
|
||||||
|
(async_initiate<T, Signature>(
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(),
|
||||||
|
declval<RawCompletionToken>().get(),
|
||||||
|
declval<ASIO_MOVE_ARG(Args)>()...)))
|
||||||
|
initiate(
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation,
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token,
|
||||||
|
ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return async_initiate<T, Signature>(
|
||||||
|
init_wrapper<typename decay<Initiation>::type>(
|
||||||
|
token.get_executor(), ASIO_MOVE_CAST(Initiation)(initiation)),
|
||||||
|
token.get(), ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Initiation, typename RawCompletionToken>
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature,
|
||||||
|
(async_initiate<T, Signature>(
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(),
|
||||||
|
declval<RawCompletionToken>().get())))
|
||||||
|
initiate(
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation,
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token)
|
||||||
|
{
|
||||||
|
return async_initiate<T, Signature>(
|
||||||
|
init_wrapper<typename decay<Initiation>::type>(
|
||||||
|
token.get_executor(), ASIO_MOVE_CAST(Initiation)(initiation)),
|
||||||
|
token.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_INITIATE_DEF(n) \
|
||||||
|
template <typename Initiation, typename RawCompletionToken, \
|
||||||
|
ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
static ASIO_INITFN_DEDUCED_RESULT_TYPE(T, Signature, \
|
||||||
|
(async_initiate<T, Signature>( \
|
||||||
|
declval<init_wrapper<typename decay<Initiation>::type> >(), \
|
||||||
|
declval<RawCompletionToken>().get(), \
|
||||||
|
ASIO_VARIADIC_MOVE_DECLVAL(n)))) \
|
||||||
|
initiate( \
|
||||||
|
ASIO_MOVE_ARG(Initiation) initiation, \
|
||||||
|
ASIO_MOVE_ARG(RawCompletionToken) token, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return async_initiate<T, Signature>( \
|
||||||
|
init_wrapper<typename decay<Initiation>::type>( \
|
||||||
|
token.get_executor(), ASIO_MOVE_CAST(Initiation)(initiation)), \
|
||||||
|
token.get(), ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_INITIATE_DEF)
|
||||||
|
#undef ASIO_PRIVATE_INITIATE_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
private:
|
||||||
|
async_result(const async_result&) ASIO_DELETED;
|
||||||
|
async_result& operator=(const async_result&) ASIO_DELETED;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <template <typename, typename> class Associator,
|
||||||
|
typename T, typename Executor, typename DefaultCandidate>
|
||||||
|
struct associator<Associator, executor_binder<T, Executor>, DefaultCandidate>
|
||||||
|
{
|
||||||
|
typedef typename Associator<T, DefaultCandidate>::type type;
|
||||||
|
|
||||||
|
static type get(const executor_binder<T, Executor>& b) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return Associator<T, DefaultCandidate>::get(b.get());
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const executor_binder<T, Executor>& b,
|
||||||
|
const DefaultCandidate& c) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
Associator<T, DefaultCandidate>::get(b.get(), c)))
|
||||||
|
{
|
||||||
|
return Associator<T, DefaultCandidate>::get(b.get(), c);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename T, typename Executor, typename Executor1>
|
||||||
|
struct associated_executor<executor_binder<T, Executor>, Executor1>
|
||||||
|
{
|
||||||
|
typedef Executor type;
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX(type) get(
|
||||||
|
const executor_binder<T, Executor>& b,
|
||||||
|
const Executor1& = Executor1()) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((b.get_executor()))
|
||||||
|
{
|
||||||
|
return b.get_executor();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BIND_EXECUTOR_HPP
|
2676
lib/asio-1.26.0/asio/buffer.hpp
Normal file
2676
lib/asio-1.26.0/asio/buffer.hpp
Normal file
File diff suppressed because it is too large
Load diff
328
lib/asio-1.26.0/asio/buffer_registration.hpp
Normal file
328
lib/asio-1.26.0/asio/buffer_registration.hpp
Normal file
|
@ -0,0 +1,328 @@
|
||||||
|
//
|
||||||
|
// buffer_registration.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFER_REGISTRATION_HPP
|
||||||
|
#define ASIO_BUFFER_REGISTRATION_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <iterator>
|
||||||
|
#include <vector>
|
||||||
|
#include "asio/detail/memory.hpp"
|
||||||
|
#include "asio/execution/context.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
#include "asio/query.hpp"
|
||||||
|
#include "asio/registered_buffer.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
# include "asio/detail/scheduler.hpp"
|
||||||
|
# include "asio/detail/io_uring_service.hpp"
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
# include <utility>
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class buffer_registration_base
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
static mutable_registered_buffer make_buffer(const mutable_buffer& b,
|
||||||
|
const void* scope, int index) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return mutable_registered_buffer(b, registered_buffer_id(scope, index));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Automatically registers and unregistered buffers with an execution context.
|
||||||
|
/**
|
||||||
|
* For portability, applications should assume that only one registration is
|
||||||
|
* permitted per execution context.
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
typename Allocator = std::allocator<void> >
|
||||||
|
class buffer_registration
|
||||||
|
: detail::buffer_registration_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The allocator type used for allocating storage for the buffers container.
|
||||||
|
typedef Allocator allocator_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The type of an iterator over the registered buffers.
|
||||||
|
typedef unspecified iterator;
|
||||||
|
|
||||||
|
/// The type of a const iterator over the registered buffers.
|
||||||
|
typedef unspecified const_iterator;
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef std::vector<mutable_registered_buffer>::const_iterator iterator;
|
||||||
|
typedef std::vector<mutable_registered_buffer>::const_iterator const_iterator;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Register buffers with an executor's execution context.
|
||||||
|
template <typename Executor>
|
||||||
|
buffer_registration(const Executor& ex,
|
||||||
|
const MutableBufferSequence& buffer_sequence,
|
||||||
|
const allocator_type& alloc = allocator_type(),
|
||||||
|
typename constraint<
|
||||||
|
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
: buffer_sequence_(buffer_sequence),
|
||||||
|
buffers_(
|
||||||
|
ASIO_REBIND_ALLOC(allocator_type,
|
||||||
|
mutable_registered_buffer)(alloc))
|
||||||
|
{
|
||||||
|
init_buffers(buffer_registration::get_context(ex),
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence_),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence_));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Register buffers with an execution context.
|
||||||
|
template <typename ExecutionContext>
|
||||||
|
buffer_registration(ExecutionContext& ctx,
|
||||||
|
const MutableBufferSequence& buffer_sequence,
|
||||||
|
const allocator_type& alloc = allocator_type(),
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
: buffer_sequence_(buffer_sequence),
|
||||||
|
buffers_(
|
||||||
|
ASIO_REBIND_ALLOC(allocator_type,
|
||||||
|
mutable_registered_buffer)(alloc))
|
||||||
|
{
|
||||||
|
init_buffers(ctx,
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence_),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence_));
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move constructor.
|
||||||
|
buffer_registration(buffer_registration&& other) ASIO_NOEXCEPT
|
||||||
|
: buffer_sequence_(std::move(other.buffer_sequence_)),
|
||||||
|
buffers_(std::move(other.buffers_))
|
||||||
|
{
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
service_ = other.service_;
|
||||||
|
other.service_ = 0;
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Unregisters the buffers.
|
||||||
|
~buffer_registration()
|
||||||
|
{
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
if (service_)
|
||||||
|
service_->unregister_buffers();
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Move assignment.
|
||||||
|
buffer_registration& operator=(
|
||||||
|
buffer_registration&& other) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
if (this != &other)
|
||||||
|
{
|
||||||
|
buffer_sequence_ = std::move(other.buffer_sequence_);
|
||||||
|
buffers_ = std::move(other.buffers_);
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
if (service_)
|
||||||
|
service_->unregister_buffers();
|
||||||
|
service_ = other.service_;
|
||||||
|
other.service_ = 0;
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
}
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Get the number of registered buffers.
|
||||||
|
std::size_t size() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the begin iterator for the sequence of registered buffers.
|
||||||
|
const_iterator begin() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_.begin();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the begin iterator for the sequence of registered buffers.
|
||||||
|
const_iterator cbegin() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_.cbegin();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the end iterator for the sequence of registered buffers.
|
||||||
|
const_iterator end() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_.end();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the end iterator for the sequence of registered buffers.
|
||||||
|
const_iterator cend() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_.cend();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the buffer at the specified index.
|
||||||
|
const mutable_registered_buffer& operator[](std::size_t i) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_[i];
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the buffer at the specified index.
|
||||||
|
const mutable_registered_buffer& at(std::size_t i) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return buffers_.at(i);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Disallow copying and assignment.
|
||||||
|
buffer_registration(const buffer_registration&) ASIO_DELETED;
|
||||||
|
buffer_registration& operator=(const buffer_registration&) ASIO_DELETED;
|
||||||
|
|
||||||
|
// Helper function to get an executor's context.
|
||||||
|
template <typename T>
|
||||||
|
static execution_context& get_context(const T& t,
|
||||||
|
typename enable_if<execution::is_executor<T>::value>::type* = 0)
|
||||||
|
{
|
||||||
|
return asio::query(t, execution::context);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Helper function to get an executor's context.
|
||||||
|
template <typename T>
|
||||||
|
static execution_context& get_context(const T& t,
|
||||||
|
typename enable_if<!execution::is_executor<T>::value>::type* = 0)
|
||||||
|
{
|
||||||
|
return t.context();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Helper function to initialise the container of buffers.
|
||||||
|
template <typename Iterator>
|
||||||
|
void init_buffers(execution_context& ctx, Iterator begin, Iterator end)
|
||||||
|
{
|
||||||
|
std::size_t n = std::distance(begin, end);
|
||||||
|
buffers_.resize(n);
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
service_ = &use_service<detail::io_uring_service>(ctx);
|
||||||
|
std::vector<iovec,
|
||||||
|
ASIO_REBIND_ALLOC(allocator_type, iovec)> iovecs(n,
|
||||||
|
ASIO_REBIND_ALLOC(allocator_type, iovec)(
|
||||||
|
buffers_.get_allocator()));
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
|
||||||
|
Iterator iter = begin;
|
||||||
|
for (int index = 0; iter != end; ++index, ++iter)
|
||||||
|
{
|
||||||
|
mutable_buffer b(*iter);
|
||||||
|
std::size_t i = static_cast<std::size_t>(index);
|
||||||
|
buffers_[i] = this->make_buffer(b, &ctx, index);
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
iovecs[i].iov_base = buffers_[i].data();
|
||||||
|
iovecs[i].iov_len = buffers_[i].size();
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
if (n > 0)
|
||||||
|
{
|
||||||
|
service_->register_buffers(&iovecs[0],
|
||||||
|
static_cast<unsigned>(iovecs.size()));
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
}
|
||||||
|
|
||||||
|
MutableBufferSequence buffer_sequence_;
|
||||||
|
std::vector<mutable_registered_buffer,
|
||||||
|
ASIO_REBIND_ALLOC(allocator_type,
|
||||||
|
mutable_registered_buffer)> buffers_;
|
||||||
|
#if defined(ASIO_HAS_IO_URING)
|
||||||
|
detail::io_uring_service* service_;
|
||||||
|
#endif // defined(ASIO_HAS_IO_URING)
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Register buffers with an execution context.
|
||||||
|
template <typename Executor, typename MutableBufferSequence>
|
||||||
|
ASIO_NODISCARD inline
|
||||||
|
buffer_registration<MutableBufferSequence>
|
||||||
|
register_buffers(const Executor& ex,
|
||||||
|
const MutableBufferSequence& buffer_sequence,
|
||||||
|
typename constraint<
|
||||||
|
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
{
|
||||||
|
return buffer_registration<MutableBufferSequence>(ex, buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Register buffers with an execution context.
|
||||||
|
template <typename Executor, typename MutableBufferSequence, typename Allocator>
|
||||||
|
ASIO_NODISCARD inline
|
||||||
|
buffer_registration<MutableBufferSequence, Allocator>
|
||||||
|
register_buffers(const Executor& ex,
|
||||||
|
const MutableBufferSequence& buffer_sequence, const Allocator& alloc,
|
||||||
|
typename constraint<
|
||||||
|
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
{
|
||||||
|
return buffer_registration<MutableBufferSequence, Allocator>(
|
||||||
|
ex, buffer_sequence, alloc);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Register buffers with an execution context.
|
||||||
|
template <typename ExecutionContext, typename MutableBufferSequence>
|
||||||
|
ASIO_NODISCARD inline
|
||||||
|
buffer_registration<MutableBufferSequence>
|
||||||
|
register_buffers(ExecutionContext& ctx,
|
||||||
|
const MutableBufferSequence& buffer_sequence,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
{
|
||||||
|
return buffer_registration<MutableBufferSequence>(ctx, buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Register buffers with an execution context.
|
||||||
|
template <typename ExecutionContext,
|
||||||
|
typename MutableBufferSequence, typename Allocator>
|
||||||
|
ASIO_NODISCARD inline
|
||||||
|
buffer_registration<MutableBufferSequence, Allocator>
|
||||||
|
register_buffers(ExecutionContext& ctx,
|
||||||
|
const MutableBufferSequence& buffer_sequence, const Allocator& alloc,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0)
|
||||||
|
{
|
||||||
|
return buffer_registration<MutableBufferSequence, Allocator>(
|
||||||
|
ctx, buffer_sequence, alloc);
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFER_REGISTRATION_HPP
|
285
lib/asio-1.26.0/asio/buffered_read_stream.hpp
Normal file
285
lib/asio-1.26.0/asio/buffered_read_stream.hpp
Normal file
|
@ -0,0 +1,285 @@
|
||||||
|
//
|
||||||
|
// buffered_read_stream.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERED_READ_STREAM_HPP
|
||||||
|
#define ASIO_BUFFERED_READ_STREAM_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/buffered_read_stream_fwd.hpp"
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/detail/bind_handler.hpp"
|
||||||
|
#include "asio/detail/buffer_resize_guard.hpp"
|
||||||
|
#include "asio/detail/buffered_stream_storage.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename> class initiate_async_buffered_fill;
|
||||||
|
template <typename> class initiate_async_buffered_read_some;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Adds buffering to the read-related operations of a stream.
|
||||||
|
/**
|
||||||
|
* The buffered_read_stream class template can be used to add buffering to the
|
||||||
|
* synchronous and asynchronous read operations of a stream.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Concepts:
|
||||||
|
* AsyncReadStream, AsyncWriteStream, Stream, SyncReadStream, SyncWriteStream.
|
||||||
|
*/
|
||||||
|
template <typename Stream>
|
||||||
|
class buffered_read_stream
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the next layer.
|
||||||
|
typedef typename remove_reference<Stream>::type next_layer_type;
|
||||||
|
|
||||||
|
/// The type of the lowest layer.
|
||||||
|
typedef typename next_layer_type::lowest_layer_type lowest_layer_type;
|
||||||
|
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef typename lowest_layer_type::executor_type executor_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The default buffer size.
|
||||||
|
static const std::size_t default_buffer_size = implementation_defined;
|
||||||
|
#else
|
||||||
|
ASIO_STATIC_CONSTANT(std::size_t, default_buffer_size = 1024);
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct, passing the specified argument to initialise the next layer.
|
||||||
|
template <typename Arg>
|
||||||
|
explicit buffered_read_stream(Arg& a)
|
||||||
|
: next_layer_(a),
|
||||||
|
storage_(default_buffer_size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct, passing the specified argument to initialise the next layer.
|
||||||
|
template <typename Arg>
|
||||||
|
buffered_read_stream(Arg& a, std::size_t buffer_size)
|
||||||
|
: next_layer_(a),
|
||||||
|
storage_(buffer_size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the next layer.
|
||||||
|
next_layer_type& next_layer()
|
||||||
|
{
|
||||||
|
return next_layer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the lowest layer.
|
||||||
|
lowest_layer_type& lowest_layer()
|
||||||
|
{
|
||||||
|
return next_layer_.lowest_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a const reference to the lowest layer.
|
||||||
|
const lowest_layer_type& lowest_layer() const
|
||||||
|
{
|
||||||
|
return next_layer_.lowest_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
executor_type get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return next_layer_.lowest_layer().get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the stream.
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
next_layer_.close();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the stream.
|
||||||
|
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
next_layer_.close(ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write the given data to the stream. Returns the number of bytes written.
|
||||||
|
/// Throws an exception on failure.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return next_layer_.write_some(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write the given data to the stream. Returns the number of bytes written,
|
||||||
|
/// or 0 if an error occurred.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return next_layer_.write_some(buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous write. The data being written must be valid for the
|
||||||
|
/// lifetime of the asynchronous operation.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_write_some(const ConstBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(WriteHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
declval<typename conditional<true, Stream&, WriteHandler>::type>()
|
||||||
|
.async_write_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(WriteHandler)(handler))))
|
||||||
|
{
|
||||||
|
return next_layer_.async_write_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(WriteHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Fill the buffer with some data. Returns the number of bytes placed in the
|
||||||
|
/// buffer as a result of the operation. Throws an exception on failure.
|
||||||
|
std::size_t fill();
|
||||||
|
|
||||||
|
/// Fill the buffer with some data. Returns the number of bytes placed in the
|
||||||
|
/// buffer as a result of the operation, or 0 if an error occurred.
|
||||||
|
std::size_t fill(asio::error_code& ec);
|
||||||
|
|
||||||
|
/// Start an asynchronous fill.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_fill(
|
||||||
|
ASIO_MOVE_ARG(ReadHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<detail::initiate_async_buffered_fill<Stream> >(),
|
||||||
|
handler, declval<detail::buffered_stream_storage*>())));
|
||||||
|
|
||||||
|
/// Read some data from the stream. Returns the number of bytes read. Throws
|
||||||
|
/// an exception on failure.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers);
|
||||||
|
|
||||||
|
/// Read some data from the stream. Returns the number of bytes read or 0 if
|
||||||
|
/// an error occurred.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec);
|
||||||
|
|
||||||
|
/// Start an asynchronous read. The buffer into which the data will be read
|
||||||
|
/// must be valid for the lifetime of the asynchronous operation.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_read_some(const MutableBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(ReadHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<detail::initiate_async_buffered_read_some<Stream> >(),
|
||||||
|
handler, declval<detail::buffered_stream_storage*>(), buffers)));
|
||||||
|
|
||||||
|
/// Peek at the incoming data on the stream. Returns the number of bytes read.
|
||||||
|
/// Throws an exception on failure.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek(const MutableBufferSequence& buffers);
|
||||||
|
|
||||||
|
/// Peek at the incoming data on the stream. Returns the number of bytes read,
|
||||||
|
/// or 0 if an error occurred.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec);
|
||||||
|
|
||||||
|
/// Determine the amount of data that may be read without blocking.
|
||||||
|
std::size_t in_avail()
|
||||||
|
{
|
||||||
|
return storage_.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine the amount of data that may be read without blocking.
|
||||||
|
std::size_t in_avail(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
ec = asio::error_code();
|
||||||
|
return storage_.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
/// Copy data out of the internal buffer to the specified target buffer.
|
||||||
|
/// Returns the number of bytes copied.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t copy(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
std::size_t bytes_copied = asio::buffer_copy(
|
||||||
|
buffers, storage_.data(), storage_.size());
|
||||||
|
storage_.consume(bytes_copied);
|
||||||
|
return bytes_copied;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Copy data from the internal buffer to the specified target buffer, without
|
||||||
|
/// removing the data from the internal buffer. Returns the number of bytes
|
||||||
|
/// copied.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek_copy(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return asio::buffer_copy(buffers, storage_.data(), storage_.size());
|
||||||
|
}
|
||||||
|
|
||||||
|
/// The next layer.
|
||||||
|
Stream next_layer_;
|
||||||
|
|
||||||
|
// The data in the buffer.
|
||||||
|
detail::buffered_stream_storage storage_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/buffered_read_stream.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERED_READ_STREAM_HPP
|
25
lib/asio-1.26.0/asio/buffered_read_stream_fwd.hpp
Normal file
25
lib/asio-1.26.0/asio/buffered_read_stream_fwd.hpp
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
//
|
||||||
|
// buffered_read_stream_fwd.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERED_READ_STREAM_FWD_HPP
|
||||||
|
#define ASIO_BUFFERED_READ_STREAM_FWD_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename Stream>
|
||||||
|
class buffered_read_stream;
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERED_READ_STREAM_FWD_HPP
|
308
lib/asio-1.26.0/asio/buffered_stream.hpp
Normal file
308
lib/asio-1.26.0/asio/buffered_stream.hpp
Normal file
|
@ -0,0 +1,308 @@
|
||||||
|
//
|
||||||
|
// buffered_stream.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERED_STREAM_HPP
|
||||||
|
#define ASIO_BUFFERED_STREAM_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/buffered_read_stream.hpp"
|
||||||
|
#include "asio/buffered_write_stream.hpp"
|
||||||
|
#include "asio/buffered_stream_fwd.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Adds buffering to the read- and write-related operations of a stream.
|
||||||
|
/**
|
||||||
|
* The buffered_stream class template can be used to add buffering to the
|
||||||
|
* synchronous and asynchronous read and write operations of a stream.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Concepts:
|
||||||
|
* AsyncReadStream, AsyncWriteStream, Stream, SyncReadStream, SyncWriteStream.
|
||||||
|
*/
|
||||||
|
template <typename Stream>
|
||||||
|
class buffered_stream
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the next layer.
|
||||||
|
typedef typename remove_reference<Stream>::type next_layer_type;
|
||||||
|
|
||||||
|
/// The type of the lowest layer.
|
||||||
|
typedef typename next_layer_type::lowest_layer_type lowest_layer_type;
|
||||||
|
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef typename lowest_layer_type::executor_type executor_type;
|
||||||
|
|
||||||
|
/// Construct, passing the specified argument to initialise the next layer.
|
||||||
|
template <typename Arg>
|
||||||
|
explicit buffered_stream(Arg& a)
|
||||||
|
: inner_stream_impl_(a),
|
||||||
|
stream_impl_(inner_stream_impl_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct, passing the specified argument to initialise the next layer.
|
||||||
|
template <typename Arg>
|
||||||
|
explicit buffered_stream(Arg& a, std::size_t read_buffer_size,
|
||||||
|
std::size_t write_buffer_size)
|
||||||
|
: inner_stream_impl_(a, write_buffer_size),
|
||||||
|
stream_impl_(inner_stream_impl_, read_buffer_size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the next layer.
|
||||||
|
next_layer_type& next_layer()
|
||||||
|
{
|
||||||
|
return stream_impl_.next_layer().next_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the lowest layer.
|
||||||
|
lowest_layer_type& lowest_layer()
|
||||||
|
{
|
||||||
|
return stream_impl_.lowest_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a const reference to the lowest layer.
|
||||||
|
const lowest_layer_type& lowest_layer() const
|
||||||
|
{
|
||||||
|
return stream_impl_.lowest_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
executor_type get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return stream_impl_.lowest_layer().get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the stream.
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
stream_impl_.close();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the stream.
|
||||||
|
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
stream_impl_.close(ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Flush all data from the buffer to the next layer. Returns the number of
|
||||||
|
/// bytes written to the next layer on the last write operation. Throws an
|
||||||
|
/// exception on failure.
|
||||||
|
std::size_t flush()
|
||||||
|
{
|
||||||
|
return stream_impl_.next_layer().flush();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Flush all data from the buffer to the next layer. Returns the number of
|
||||||
|
/// bytes written to the next layer on the last write operation, or 0 if an
|
||||||
|
/// error occurred.
|
||||||
|
std::size_t flush(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return stream_impl_.next_layer().flush(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous flush.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_flush(
|
||||||
|
ASIO_MOVE_ARG(WriteHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
declval<buffered_write_stream<Stream>&>().async_flush(
|
||||||
|
ASIO_MOVE_CAST(WriteHandler)(handler))))
|
||||||
|
{
|
||||||
|
return stream_impl_.next_layer().async_flush(
|
||||||
|
ASIO_MOVE_CAST(WriteHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write the given data to the stream. Returns the number of bytes written.
|
||||||
|
/// Throws an exception on failure.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return stream_impl_.write_some(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Write the given data to the stream. Returns the number of bytes written,
|
||||||
|
/// or 0 if an error occurred.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return stream_impl_.write_some(buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous write. The data being written must be valid for the
|
||||||
|
/// lifetime of the asynchronous operation.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_write_some(const ConstBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(WriteHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
declval<Stream&>().async_write_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(WriteHandler)(handler))))
|
||||||
|
{
|
||||||
|
return stream_impl_.async_write_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(WriteHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Fill the buffer with some data. Returns the number of bytes placed in the
|
||||||
|
/// buffer as a result of the operation. Throws an exception on failure.
|
||||||
|
std::size_t fill()
|
||||||
|
{
|
||||||
|
return stream_impl_.fill();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Fill the buffer with some data. Returns the number of bytes placed in the
|
||||||
|
/// buffer as a result of the operation, or 0 if an error occurred.
|
||||||
|
std::size_t fill(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return stream_impl_.fill(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous fill.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_fill(
|
||||||
|
ASIO_MOVE_ARG(ReadHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
declval<buffered_read_stream<
|
||||||
|
buffered_write_stream<Stream> >&>().async_fill(
|
||||||
|
ASIO_MOVE_CAST(ReadHandler)(handler))))
|
||||||
|
{
|
||||||
|
return stream_impl_.async_fill(ASIO_MOVE_CAST(ReadHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the stream. Returns the number of bytes read. Throws
|
||||||
|
/// an exception on failure.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return stream_impl_.read_some(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the stream. Returns the number of bytes read or 0 if
|
||||||
|
/// an error occurred.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return stream_impl_.read_some(buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous read. The buffer into which the data will be read
|
||||||
|
/// must be valid for the lifetime of the asynchronous operation.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_read_some(const MutableBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(ReadHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
declval<Stream&>().async_read_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(ReadHandler)(handler))))
|
||||||
|
{
|
||||||
|
return stream_impl_.async_read_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(ReadHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Peek at the incoming data on the stream. Returns the number of bytes read.
|
||||||
|
/// Throws an exception on failure.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return stream_impl_.peek(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Peek at the incoming data on the stream. Returns the number of bytes read,
|
||||||
|
/// or 0 if an error occurred.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return stream_impl_.peek(buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine the amount of data that may be read without blocking.
|
||||||
|
std::size_t in_avail()
|
||||||
|
{
|
||||||
|
return stream_impl_.in_avail();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine the amount of data that may be read without blocking.
|
||||||
|
std::size_t in_avail(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return stream_impl_.in_avail(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// The buffered write stream.
|
||||||
|
typedef buffered_write_stream<Stream> write_stream_type;
|
||||||
|
write_stream_type inner_stream_impl_;
|
||||||
|
|
||||||
|
// The buffered read stream.
|
||||||
|
typedef buffered_read_stream<write_stream_type&> read_stream_type;
|
||||||
|
read_stream_type stream_impl_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERED_STREAM_HPP
|
25
lib/asio-1.26.0/asio/buffered_stream_fwd.hpp
Normal file
25
lib/asio-1.26.0/asio/buffered_stream_fwd.hpp
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
//
|
||||||
|
// buffered_stream_fwd.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERED_STREAM_FWD_HPP
|
||||||
|
#define ASIO_BUFFERED_STREAM_FWD_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename Stream>
|
||||||
|
class buffered_stream;
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERED_STREAM_FWD_HPP
|
277
lib/asio-1.26.0/asio/buffered_write_stream.hpp
Normal file
277
lib/asio-1.26.0/asio/buffered_write_stream.hpp
Normal file
|
@ -0,0 +1,277 @@
|
||||||
|
//
|
||||||
|
// buffered_write_stream.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERED_WRITE_STREAM_HPP
|
||||||
|
#define ASIO_BUFFERED_WRITE_STREAM_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/buffered_write_stream_fwd.hpp"
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/completion_condition.hpp"
|
||||||
|
#include "asio/detail/bind_handler.hpp"
|
||||||
|
#include "asio/detail/buffered_stream_storage.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
#include "asio/write.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename> class initiate_async_buffered_flush;
|
||||||
|
template <typename> class initiate_async_buffered_write_some;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Adds buffering to the write-related operations of a stream.
|
||||||
|
/**
|
||||||
|
* The buffered_write_stream class template can be used to add buffering to the
|
||||||
|
* synchronous and asynchronous write operations of a stream.
|
||||||
|
*
|
||||||
|
* @par Thread Safety
|
||||||
|
* @e Distinct @e objects: Safe.@n
|
||||||
|
* @e Shared @e objects: Unsafe.
|
||||||
|
*
|
||||||
|
* @par Concepts:
|
||||||
|
* AsyncReadStream, AsyncWriteStream, Stream, SyncReadStream, SyncWriteStream.
|
||||||
|
*/
|
||||||
|
template <typename Stream>
|
||||||
|
class buffered_write_stream
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// The type of the next layer.
|
||||||
|
typedef typename remove_reference<Stream>::type next_layer_type;
|
||||||
|
|
||||||
|
/// The type of the lowest layer.
|
||||||
|
typedef typename next_layer_type::lowest_layer_type lowest_layer_type;
|
||||||
|
|
||||||
|
/// The type of the executor associated with the object.
|
||||||
|
typedef typename lowest_layer_type::executor_type executor_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The default buffer size.
|
||||||
|
static const std::size_t default_buffer_size = implementation_defined;
|
||||||
|
#else
|
||||||
|
ASIO_STATIC_CONSTANT(std::size_t, default_buffer_size = 1024);
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Construct, passing the specified argument to initialise the next layer.
|
||||||
|
template <typename Arg>
|
||||||
|
explicit buffered_write_stream(Arg& a)
|
||||||
|
: next_layer_(a),
|
||||||
|
storage_(default_buffer_size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct, passing the specified argument to initialise the next layer.
|
||||||
|
template <typename Arg>
|
||||||
|
buffered_write_stream(Arg& a, std::size_t buffer_size)
|
||||||
|
: next_layer_(a),
|
||||||
|
storage_(buffer_size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the next layer.
|
||||||
|
next_layer_type& next_layer()
|
||||||
|
{
|
||||||
|
return next_layer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a reference to the lowest layer.
|
||||||
|
lowest_layer_type& lowest_layer()
|
||||||
|
{
|
||||||
|
return next_layer_.lowest_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get a const reference to the lowest layer.
|
||||||
|
const lowest_layer_type& lowest_layer() const
|
||||||
|
{
|
||||||
|
return next_layer_.lowest_layer();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Get the executor associated with the object.
|
||||||
|
executor_type get_executor() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return next_layer_.lowest_layer().get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the stream.
|
||||||
|
void close()
|
||||||
|
{
|
||||||
|
next_layer_.close();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Close the stream.
|
||||||
|
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
next_layer_.close(ec);
|
||||||
|
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Flush all data from the buffer to the next layer. Returns the number of
|
||||||
|
/// bytes written to the next layer on the last write operation. Throws an
|
||||||
|
/// exception on failure.
|
||||||
|
std::size_t flush();
|
||||||
|
|
||||||
|
/// Flush all data from the buffer to the next layer. Returns the number of
|
||||||
|
/// bytes written to the next layer on the last write operation, or 0 if an
|
||||||
|
/// error occurred.
|
||||||
|
std::size_t flush(asio::error_code& ec);
|
||||||
|
|
||||||
|
/// Start an asynchronous flush.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_flush(
|
||||||
|
ASIO_MOVE_ARG(WriteHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<detail::initiate_async_buffered_flush<Stream> >(),
|
||||||
|
handler, declval<detail::buffered_stream_storage*>())));
|
||||||
|
|
||||||
|
/// Write the given data to the stream. Returns the number of bytes written.
|
||||||
|
/// Throws an exception on failure.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers);
|
||||||
|
|
||||||
|
/// Write the given data to the stream. Returns the number of bytes written,
|
||||||
|
/// or 0 if an error occurred and the error handler did not throw.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t write_some(const ConstBufferSequence& buffers,
|
||||||
|
asio::error_code& ec);
|
||||||
|
|
||||||
|
/// Start an asynchronous write. The data being written must be valid for the
|
||||||
|
/// lifetime of the asynchronous operation.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <typename ConstBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) WriteHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_write_some(const ConstBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(WriteHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<WriteHandler,
|
||||||
|
void (asio::error_code, std::size_t)>(
|
||||||
|
declval<detail::initiate_async_buffered_write_some<Stream> >(),
|
||||||
|
handler, declval<detail::buffered_stream_storage*>(), buffers)));
|
||||||
|
|
||||||
|
/// Read some data from the stream. Returns the number of bytes read. Throws
|
||||||
|
/// an exception on failure.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return next_layer_.read_some(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Read some data from the stream. Returns the number of bytes read or 0 if
|
||||||
|
/// an error occurred.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t read_some(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return next_layer_.read_some(buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Start an asynchronous read. The buffer into which the data will be read
|
||||||
|
/// must be valid for the lifetime of the asynchronous operation.
|
||||||
|
/**
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(asio::error_code, std::size_t) @endcode
|
||||||
|
*/
|
||||||
|
template <typename MutableBufferSequence,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code,
|
||||||
|
std::size_t)) ReadHandler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ReadHandler,
|
||||||
|
void (asio::error_code, std::size_t))
|
||||||
|
async_read_some(const MutableBufferSequence& buffers,
|
||||||
|
ASIO_MOVE_ARG(ReadHandler) handler
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(executor_type))
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
declval<typename conditional<true, Stream&, ReadHandler>::type>()
|
||||||
|
.async_read_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(ReadHandler)(handler))))
|
||||||
|
{
|
||||||
|
return next_layer_.async_read_some(buffers,
|
||||||
|
ASIO_MOVE_CAST(ReadHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Peek at the incoming data on the stream. Returns the number of bytes read.
|
||||||
|
/// Throws an exception on failure.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek(const MutableBufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return next_layer_.peek(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Peek at the incoming data on the stream. Returns the number of bytes read,
|
||||||
|
/// or 0 if an error occurred.
|
||||||
|
template <typename MutableBufferSequence>
|
||||||
|
std::size_t peek(const MutableBufferSequence& buffers,
|
||||||
|
asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return next_layer_.peek(buffers, ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine the amount of data that may be read without blocking.
|
||||||
|
std::size_t in_avail()
|
||||||
|
{
|
||||||
|
return next_layer_.in_avail();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Determine the amount of data that may be read without blocking.
|
||||||
|
std::size_t in_avail(asio::error_code& ec)
|
||||||
|
{
|
||||||
|
return next_layer_.in_avail(ec);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
/// Copy data into the internal buffer from the specified source buffer.
|
||||||
|
/// Returns the number of bytes copied.
|
||||||
|
template <typename ConstBufferSequence>
|
||||||
|
std::size_t copy(const ConstBufferSequence& buffers);
|
||||||
|
|
||||||
|
/// The next layer.
|
||||||
|
Stream next_layer_;
|
||||||
|
|
||||||
|
// The data in the buffer.
|
||||||
|
detail::buffered_stream_storage storage_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/buffered_write_stream.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERED_WRITE_STREAM_HPP
|
25
lib/asio-1.26.0/asio/buffered_write_stream_fwd.hpp
Normal file
25
lib/asio-1.26.0/asio/buffered_write_stream_fwd.hpp
Normal file
|
@ -0,0 +1,25 @@
|
||||||
|
//
|
||||||
|
// buffered_write_stream_fwd.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERED_WRITE_STREAM_FWD_HPP
|
||||||
|
#define ASIO_BUFFERED_WRITE_STREAM_FWD_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
template <typename Stream>
|
||||||
|
class buffered_write_stream;
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERED_WRITE_STREAM_FWD_HPP
|
521
lib/asio-1.26.0/asio/buffers_iterator.hpp
Normal file
521
lib/asio-1.26.0/asio/buffers_iterator.hpp
Normal file
|
@ -0,0 +1,521 @@
|
||||||
|
//
|
||||||
|
// buffers_iterator.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_BUFFERS_ITERATOR_HPP
|
||||||
|
#define ASIO_BUFFERS_ITERATOR_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include <iterator>
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/detail/assert.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
namespace detail
|
||||||
|
{
|
||||||
|
template <bool IsMutable>
|
||||||
|
struct buffers_iterator_types_helper;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct buffers_iterator_types_helper<false>
|
||||||
|
{
|
||||||
|
typedef const_buffer buffer_type;
|
||||||
|
template <typename ByteType>
|
||||||
|
struct byte_type
|
||||||
|
{
|
||||||
|
typedef typename add_const<ByteType>::type type;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct buffers_iterator_types_helper<true>
|
||||||
|
{
|
||||||
|
typedef mutable_buffer buffer_type;
|
||||||
|
template <typename ByteType>
|
||||||
|
struct byte_type
|
||||||
|
{
|
||||||
|
typedef ByteType type;
|
||||||
|
};
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename BufferSequence, typename ByteType>
|
||||||
|
struct buffers_iterator_types
|
||||||
|
{
|
||||||
|
enum
|
||||||
|
{
|
||||||
|
is_mutable = is_convertible<
|
||||||
|
typename BufferSequence::value_type,
|
||||||
|
mutable_buffer>::value
|
||||||
|
};
|
||||||
|
typedef buffers_iterator_types_helper<is_mutable> helper;
|
||||||
|
typedef typename helper::buffer_type buffer_type;
|
||||||
|
typedef typename helper::template byte_type<ByteType>::type byte_type;
|
||||||
|
typedef typename BufferSequence::const_iterator const_iterator;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename ByteType>
|
||||||
|
struct buffers_iterator_types<mutable_buffer, ByteType>
|
||||||
|
{
|
||||||
|
typedef mutable_buffer buffer_type;
|
||||||
|
typedef ByteType byte_type;
|
||||||
|
typedef const mutable_buffer* const_iterator;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename ByteType>
|
||||||
|
struct buffers_iterator_types<const_buffer, ByteType>
|
||||||
|
{
|
||||||
|
typedef const_buffer buffer_type;
|
||||||
|
typedef typename add_const<ByteType>::type byte_type;
|
||||||
|
typedef const const_buffer* const_iterator;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
template <typename ByteType>
|
||||||
|
struct buffers_iterator_types<mutable_buffers_1, ByteType>
|
||||||
|
{
|
||||||
|
typedef mutable_buffer buffer_type;
|
||||||
|
typedef ByteType byte_type;
|
||||||
|
typedef const mutable_buffer* const_iterator;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename ByteType>
|
||||||
|
struct buffers_iterator_types<const_buffers_1, ByteType>
|
||||||
|
{
|
||||||
|
typedef const_buffer buffer_type;
|
||||||
|
typedef typename add_const<ByteType>::type byte_type;
|
||||||
|
typedef const const_buffer* const_iterator;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A random access iterator over the bytes in a buffer sequence.
|
||||||
|
template <typename BufferSequence, typename ByteType = char>
|
||||||
|
class buffers_iterator
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
typedef typename detail::buffers_iterator_types<
|
||||||
|
BufferSequence, ByteType>::buffer_type buffer_type;
|
||||||
|
|
||||||
|
typedef typename detail::buffers_iterator_types<BufferSequence,
|
||||||
|
ByteType>::const_iterator buffer_sequence_iterator_type;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// The type used for the distance between two iterators.
|
||||||
|
typedef std::ptrdiff_t difference_type;
|
||||||
|
|
||||||
|
/// The type of the value pointed to by the iterator.
|
||||||
|
typedef ByteType value_type;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The type of the result of applying operator->() to the iterator.
|
||||||
|
/**
|
||||||
|
* If the buffer sequence stores buffer objects that are convertible to
|
||||||
|
* mutable_buffer, this is a pointer to a non-const ByteType. Otherwise, a
|
||||||
|
* pointer to a const ByteType.
|
||||||
|
*/
|
||||||
|
typedef const_or_non_const_ByteType* pointer;
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef typename detail::buffers_iterator_types<
|
||||||
|
BufferSequence, ByteType>::byte_type* pointer;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// The type of the result of applying operator*() to the iterator.
|
||||||
|
/**
|
||||||
|
* If the buffer sequence stores buffer objects that are convertible to
|
||||||
|
* mutable_buffer, this is a reference to a non-const ByteType. Otherwise, a
|
||||||
|
* reference to a const ByteType.
|
||||||
|
*/
|
||||||
|
typedef const_or_non_const_ByteType& reference;
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
typedef typename detail::buffers_iterator_types<
|
||||||
|
BufferSequence, ByteType>::byte_type& reference;
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// The iterator category.
|
||||||
|
typedef std::random_access_iterator_tag iterator_category;
|
||||||
|
|
||||||
|
/// Default constructor. Creates an iterator in an undefined state.
|
||||||
|
buffers_iterator()
|
||||||
|
: current_buffer_(),
|
||||||
|
current_buffer_position_(0),
|
||||||
|
begin_(),
|
||||||
|
current_(),
|
||||||
|
end_(),
|
||||||
|
position_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct an iterator representing the beginning of the buffers' data.
|
||||||
|
static buffers_iterator begin(const BufferSequence& buffers)
|
||||||
|
#if defined(__GNUC__) && (__GNUC__ == 4) && (__GNUC_MINOR__ == 3)
|
||||||
|
__attribute__ ((__noinline__))
|
||||||
|
#endif // defined(__GNUC__) && (__GNUC__ == 4) && (__GNUC_MINOR__ == 3)
|
||||||
|
{
|
||||||
|
buffers_iterator new_iter;
|
||||||
|
new_iter.begin_ = asio::buffer_sequence_begin(buffers);
|
||||||
|
new_iter.current_ = asio::buffer_sequence_begin(buffers);
|
||||||
|
new_iter.end_ = asio::buffer_sequence_end(buffers);
|
||||||
|
while (new_iter.current_ != new_iter.end_)
|
||||||
|
{
|
||||||
|
new_iter.current_buffer_ = *new_iter.current_;
|
||||||
|
if (new_iter.current_buffer_.size() > 0)
|
||||||
|
break;
|
||||||
|
++new_iter.current_;
|
||||||
|
}
|
||||||
|
return new_iter;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct an iterator representing the end of the buffers' data.
|
||||||
|
static buffers_iterator end(const BufferSequence& buffers)
|
||||||
|
#if defined(__GNUC__) && (__GNUC__ == 4) && (__GNUC_MINOR__ == 3)
|
||||||
|
__attribute__ ((__noinline__))
|
||||||
|
#endif // defined(__GNUC__) && (__GNUC__ == 4) && (__GNUC_MINOR__ == 3)
|
||||||
|
{
|
||||||
|
buffers_iterator new_iter;
|
||||||
|
new_iter.begin_ = asio::buffer_sequence_begin(buffers);
|
||||||
|
new_iter.current_ = asio::buffer_sequence_begin(buffers);
|
||||||
|
new_iter.end_ = asio::buffer_sequence_end(buffers);
|
||||||
|
while (new_iter.current_ != new_iter.end_)
|
||||||
|
{
|
||||||
|
buffer_type buffer = *new_iter.current_;
|
||||||
|
new_iter.position_ += buffer.size();
|
||||||
|
++new_iter.current_;
|
||||||
|
}
|
||||||
|
return new_iter;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Dereference an iterator.
|
||||||
|
reference operator*() const
|
||||||
|
{
|
||||||
|
return dereference();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Dereference an iterator.
|
||||||
|
pointer operator->() const
|
||||||
|
{
|
||||||
|
return &dereference();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Access an individual element.
|
||||||
|
reference operator[](std::ptrdiff_t difference) const
|
||||||
|
{
|
||||||
|
buffers_iterator tmp(*this);
|
||||||
|
tmp.advance(difference);
|
||||||
|
return *tmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Increment operator (prefix).
|
||||||
|
buffers_iterator& operator++()
|
||||||
|
{
|
||||||
|
increment();
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Increment operator (postfix).
|
||||||
|
buffers_iterator operator++(int)
|
||||||
|
{
|
||||||
|
buffers_iterator tmp(*this);
|
||||||
|
++*this;
|
||||||
|
return tmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Decrement operator (prefix).
|
||||||
|
buffers_iterator& operator--()
|
||||||
|
{
|
||||||
|
decrement();
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Decrement operator (postfix).
|
||||||
|
buffers_iterator operator--(int)
|
||||||
|
{
|
||||||
|
buffers_iterator tmp(*this);
|
||||||
|
--*this;
|
||||||
|
return tmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Addition operator.
|
||||||
|
buffers_iterator& operator+=(std::ptrdiff_t difference)
|
||||||
|
{
|
||||||
|
advance(difference);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Subtraction operator.
|
||||||
|
buffers_iterator& operator-=(std::ptrdiff_t difference)
|
||||||
|
{
|
||||||
|
advance(-difference);
|
||||||
|
return *this;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Addition operator.
|
||||||
|
friend buffers_iterator operator+(const buffers_iterator& iter,
|
||||||
|
std::ptrdiff_t difference)
|
||||||
|
{
|
||||||
|
buffers_iterator tmp(iter);
|
||||||
|
tmp.advance(difference);
|
||||||
|
return tmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Addition operator.
|
||||||
|
friend buffers_iterator operator+(std::ptrdiff_t difference,
|
||||||
|
const buffers_iterator& iter)
|
||||||
|
{
|
||||||
|
buffers_iterator tmp(iter);
|
||||||
|
tmp.advance(difference);
|
||||||
|
return tmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Subtraction operator.
|
||||||
|
friend buffers_iterator operator-(const buffers_iterator& iter,
|
||||||
|
std::ptrdiff_t difference)
|
||||||
|
{
|
||||||
|
buffers_iterator tmp(iter);
|
||||||
|
tmp.advance(-difference);
|
||||||
|
return tmp;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Subtraction operator.
|
||||||
|
friend std::ptrdiff_t operator-(const buffers_iterator& a,
|
||||||
|
const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return b.distance_to(a);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Test two iterators for equality.
|
||||||
|
friend bool operator==(const buffers_iterator& a, const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return a.equal(b);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Test two iterators for inequality.
|
||||||
|
friend bool operator!=(const buffers_iterator& a, const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return !a.equal(b);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare two iterators.
|
||||||
|
friend bool operator<(const buffers_iterator& a, const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return a.distance_to(b) > 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare two iterators.
|
||||||
|
friend bool operator<=(const buffers_iterator& a, const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return !(b < a);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare two iterators.
|
||||||
|
friend bool operator>(const buffers_iterator& a, const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return b < a;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare two iterators.
|
||||||
|
friend bool operator>=(const buffers_iterator& a, const buffers_iterator& b)
|
||||||
|
{
|
||||||
|
return !(a < b);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// Dereference the iterator.
|
||||||
|
reference dereference() const
|
||||||
|
{
|
||||||
|
return static_cast<pointer>(
|
||||||
|
current_buffer_.data())[current_buffer_position_];
|
||||||
|
}
|
||||||
|
|
||||||
|
// Compare two iterators for equality.
|
||||||
|
bool equal(const buffers_iterator& other) const
|
||||||
|
{
|
||||||
|
return position_ == other.position_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Increment the iterator.
|
||||||
|
void increment()
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(current_ != end_ && "iterator out of bounds");
|
||||||
|
++position_;
|
||||||
|
|
||||||
|
// Check if the increment can be satisfied by the current buffer.
|
||||||
|
++current_buffer_position_;
|
||||||
|
if (current_buffer_position_ != current_buffer_.size())
|
||||||
|
return;
|
||||||
|
|
||||||
|
// Find the next non-empty buffer.
|
||||||
|
++current_;
|
||||||
|
current_buffer_position_ = 0;
|
||||||
|
while (current_ != end_)
|
||||||
|
{
|
||||||
|
current_buffer_ = *current_;
|
||||||
|
if (current_buffer_.size() > 0)
|
||||||
|
return;
|
||||||
|
++current_;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Decrement the iterator.
|
||||||
|
void decrement()
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(position_ > 0 && "iterator out of bounds");
|
||||||
|
--position_;
|
||||||
|
|
||||||
|
// Check if the decrement can be satisfied by the current buffer.
|
||||||
|
if (current_buffer_position_ != 0)
|
||||||
|
{
|
||||||
|
--current_buffer_position_;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find the previous non-empty buffer.
|
||||||
|
buffer_sequence_iterator_type iter = current_;
|
||||||
|
while (iter != begin_)
|
||||||
|
{
|
||||||
|
--iter;
|
||||||
|
buffer_type buffer = *iter;
|
||||||
|
std::size_t buffer_size = buffer.size();
|
||||||
|
if (buffer_size > 0)
|
||||||
|
{
|
||||||
|
current_ = iter;
|
||||||
|
current_buffer_ = buffer;
|
||||||
|
current_buffer_position_ = buffer_size - 1;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Advance the iterator by the specified distance.
|
||||||
|
void advance(std::ptrdiff_t n)
|
||||||
|
{
|
||||||
|
if (n > 0)
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(current_ != end_ && "iterator out of bounds");
|
||||||
|
for (;;)
|
||||||
|
{
|
||||||
|
std::ptrdiff_t current_buffer_balance
|
||||||
|
= current_buffer_.size() - current_buffer_position_;
|
||||||
|
|
||||||
|
// Check if the advance can be satisfied by the current buffer.
|
||||||
|
if (current_buffer_balance > n)
|
||||||
|
{
|
||||||
|
position_ += n;
|
||||||
|
current_buffer_position_ += n;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Update position.
|
||||||
|
n -= current_buffer_balance;
|
||||||
|
position_ += current_buffer_balance;
|
||||||
|
|
||||||
|
// Move to next buffer. If it is empty then it will be skipped on the
|
||||||
|
// next iteration of this loop.
|
||||||
|
if (++current_ == end_)
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(n == 0 && "iterator out of bounds");
|
||||||
|
current_buffer_ = buffer_type();
|
||||||
|
current_buffer_position_ = 0;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
current_buffer_ = *current_;
|
||||||
|
current_buffer_position_ = 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (n < 0)
|
||||||
|
{
|
||||||
|
std::size_t abs_n = -n;
|
||||||
|
ASIO_ASSERT(position_ >= abs_n && "iterator out of bounds");
|
||||||
|
for (;;)
|
||||||
|
{
|
||||||
|
// Check if the advance can be satisfied by the current buffer.
|
||||||
|
if (current_buffer_position_ >= abs_n)
|
||||||
|
{
|
||||||
|
position_ -= abs_n;
|
||||||
|
current_buffer_position_ -= abs_n;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Update position.
|
||||||
|
abs_n -= current_buffer_position_;
|
||||||
|
position_ -= current_buffer_position_;
|
||||||
|
|
||||||
|
// Check if we've reached the beginning of the buffers.
|
||||||
|
if (current_ == begin_)
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(abs_n == 0 && "iterator out of bounds");
|
||||||
|
current_buffer_position_ = 0;
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find the previous non-empty buffer.
|
||||||
|
buffer_sequence_iterator_type iter = current_;
|
||||||
|
while (iter != begin_)
|
||||||
|
{
|
||||||
|
--iter;
|
||||||
|
buffer_type buffer = *iter;
|
||||||
|
std::size_t buffer_size = buffer.size();
|
||||||
|
if (buffer_size > 0)
|
||||||
|
{
|
||||||
|
current_ = iter;
|
||||||
|
current_buffer_ = buffer;
|
||||||
|
current_buffer_position_ = buffer_size;
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Determine the distance between two iterators.
|
||||||
|
std::ptrdiff_t distance_to(const buffers_iterator& other) const
|
||||||
|
{
|
||||||
|
return other.position_ - position_;
|
||||||
|
}
|
||||||
|
|
||||||
|
buffer_type current_buffer_;
|
||||||
|
std::size_t current_buffer_position_;
|
||||||
|
buffer_sequence_iterator_type begin_;
|
||||||
|
buffer_sequence_iterator_type current_;
|
||||||
|
buffer_sequence_iterator_type end_;
|
||||||
|
std::size_t position_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Construct an iterator representing the beginning of the buffers' data.
|
||||||
|
template <typename BufferSequence>
|
||||||
|
inline buffers_iterator<BufferSequence> buffers_begin(
|
||||||
|
const BufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return buffers_iterator<BufferSequence>::begin(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct an iterator representing the end of the buffers' data.
|
||||||
|
template <typename BufferSequence>
|
||||||
|
inline buffers_iterator<BufferSequence> buffers_end(
|
||||||
|
const BufferSequence& buffers)
|
||||||
|
{
|
||||||
|
return buffers_iterator<BufferSequence>::end(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_BUFFERS_ITERATOR_HPP
|
305
lib/asio-1.26.0/asio/cancellation_signal.hpp
Normal file
305
lib/asio-1.26.0/asio/cancellation_signal.hpp
Normal file
|
@ -0,0 +1,305 @@
|
||||||
|
//
|
||||||
|
// cancellation_signal.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_CANCELLATION_SIGNAL_HPP
|
||||||
|
#define ASIO_CANCELLATION_SIGNAL_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cassert>
|
||||||
|
#include <new>
|
||||||
|
#include <utility>
|
||||||
|
#include "asio/cancellation_type.hpp"
|
||||||
|
#include "asio/detail/cstddef.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/variadic_templates.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class cancellation_handler_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
virtual void call(cancellation_type_t) = 0;
|
||||||
|
virtual std::pair<void*, std::size_t> destroy() ASIO_NOEXCEPT = 0;
|
||||||
|
|
||||||
|
protected:
|
||||||
|
~cancellation_handler_base() {}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
class cancellation_handler
|
||||||
|
: public cancellation_handler_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
template <typename... Args>
|
||||||
|
cancellation_handler(std::size_t size, ASIO_MOVE_ARG(Args)... args)
|
||||||
|
: handler_(ASIO_MOVE_CAST(Args)(args)...),
|
||||||
|
size_(size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
cancellation_handler(std::size_t size)
|
||||||
|
: handler_(),
|
||||||
|
size_(size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_HANDLER_CTOR_DEF(n) \
|
||||||
|
template <ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
cancellation_handler(std::size_t size, ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
: handler_(ASIO_VARIADIC_MOVE_ARGS(n)), \
|
||||||
|
size_(size) \
|
||||||
|
{ \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_HANDLER_CTOR_DEF)
|
||||||
|
#undef ASIO_PRIVATE_HANDLER_CTOR_DEF
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
void call(cancellation_type_t type)
|
||||||
|
{
|
||||||
|
handler_(type);
|
||||||
|
}
|
||||||
|
|
||||||
|
std::pair<void*, std::size_t> destroy() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
std::pair<void*, std::size_t> mem(this, size_);
|
||||||
|
this->cancellation_handler::~cancellation_handler();
|
||||||
|
return mem;
|
||||||
|
}
|
||||||
|
|
||||||
|
Handler& handler() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return handler_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
~cancellation_handler()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
Handler handler_;
|
||||||
|
std::size_t size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
class cancellation_slot;
|
||||||
|
|
||||||
|
/// A cancellation signal with a single slot.
|
||||||
|
class cancellation_signal
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
ASIO_CONSTEXPR cancellation_signal()
|
||||||
|
: handler_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
ASIO_DECL ~cancellation_signal();
|
||||||
|
|
||||||
|
/// Emits the signal and causes invocation of the slot's handler, if any.
|
||||||
|
void emit(cancellation_type_t type)
|
||||||
|
{
|
||||||
|
if (handler_)
|
||||||
|
handler_->call(type);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the single slot associated with the signal.
|
||||||
|
/**
|
||||||
|
* The signal object must remain valid for as long the slot may be used.
|
||||||
|
* Destruction of the signal invalidates the slot.
|
||||||
|
*/
|
||||||
|
cancellation_slot slot() ASIO_NOEXCEPT;
|
||||||
|
|
||||||
|
private:
|
||||||
|
cancellation_signal(const cancellation_signal&) ASIO_DELETED;
|
||||||
|
cancellation_signal& operator=(const cancellation_signal&) ASIO_DELETED;
|
||||||
|
|
||||||
|
detail::cancellation_handler_base* handler_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// A slot associated with a cancellation signal.
|
||||||
|
class cancellation_slot
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Creates a slot that is not connected to any cancellation signal.
|
||||||
|
ASIO_CONSTEXPR cancellation_slot()
|
||||||
|
: handler_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
/// Installs a handler into the slot, constructing the new object directly.
|
||||||
|
/**
|
||||||
|
* Destroys any existing handler in the slot, then installs the new handler,
|
||||||
|
* constructing it with the supplied @c args.
|
||||||
|
*
|
||||||
|
* The handler is a function object to be called when the signal is emitted.
|
||||||
|
* The signature of the handler must be
|
||||||
|
* @code void handler(asio::cancellation_type_t); @endcode
|
||||||
|
*
|
||||||
|
* @param args Arguments to be passed to the @c CancellationHandler object's
|
||||||
|
* constructor.
|
||||||
|
*
|
||||||
|
* @returns A reference to the newly installed handler.
|
||||||
|
*
|
||||||
|
* @note Handlers installed into the slot via @c emplace are not required to
|
||||||
|
* be copy constructible or move constructible.
|
||||||
|
*/
|
||||||
|
template <typename CancellationHandler, typename... Args>
|
||||||
|
CancellationHandler& emplace(ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
typedef detail::cancellation_handler<CancellationHandler>
|
||||||
|
cancellation_handler_type;
|
||||||
|
auto_delete_helper del = { prepare_memory(
|
||||||
|
sizeof(cancellation_handler_type),
|
||||||
|
ASIO_ALIGNOF(CancellationHandler)) };
|
||||||
|
cancellation_handler_type* handler_obj =
|
||||||
|
new (del.mem.first) cancellation_handler_type(
|
||||||
|
del.mem.second, ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
del.mem.first = 0;
|
||||||
|
*handler_ = handler_obj;
|
||||||
|
return handler_obj->handler();
|
||||||
|
}
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename CancellationHandler>
|
||||||
|
CancellationHandler& emplace()
|
||||||
|
{
|
||||||
|
typedef detail::cancellation_handler<CancellationHandler>
|
||||||
|
cancellation_handler_type;
|
||||||
|
auto_delete_helper del = { prepare_memory(
|
||||||
|
sizeof(cancellation_handler_type),
|
||||||
|
ASIO_ALIGNOF(CancellationHandler)) };
|
||||||
|
cancellation_handler_type* handler_obj =
|
||||||
|
new (del.mem.first) cancellation_handler_type(del.mem.second);
|
||||||
|
del.mem.first = 0;
|
||||||
|
*handler_ = handler_obj;
|
||||||
|
return handler_obj->handler();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_HANDLER_EMPLACE_DEF(n) \
|
||||||
|
template <typename CancellationHandler, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
CancellationHandler& emplace(ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
typedef detail::cancellation_handler<CancellationHandler> \
|
||||||
|
cancellation_handler_type; \
|
||||||
|
auto_delete_helper del = { prepare_memory( \
|
||||||
|
sizeof(cancellation_handler_type), \
|
||||||
|
ASIO_ALIGNOF(CancellationHandler)) }; \
|
||||||
|
cancellation_handler_type* handler_obj = \
|
||||||
|
new (del.mem.first) cancellation_handler_type( \
|
||||||
|
del.mem.second, ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
del.mem.first = 0; \
|
||||||
|
*handler_ = handler_obj; \
|
||||||
|
return handler_obj->handler(); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_HANDLER_EMPLACE_DEF)
|
||||||
|
#undef ASIO_PRIVATE_HANDLER_EMPLACE_DEF
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
/// Installs a handler into the slot.
|
||||||
|
/**
|
||||||
|
* Destroys any existing handler in the slot, then installs the new handler,
|
||||||
|
* constructing it as a decay-copy of the supplied handler.
|
||||||
|
*
|
||||||
|
* The handler is a function object to be called when the signal is emitted.
|
||||||
|
* The signature of the handler must be
|
||||||
|
* @code void handler(asio::cancellation_type_t); @endcode
|
||||||
|
*
|
||||||
|
* @param handler The handler to be installed.
|
||||||
|
*
|
||||||
|
* @returns A reference to the newly installed handler.
|
||||||
|
*/
|
||||||
|
template <typename CancellationHandler>
|
||||||
|
typename decay<CancellationHandler>::type& assign(
|
||||||
|
ASIO_MOVE_ARG(CancellationHandler) handler)
|
||||||
|
{
|
||||||
|
return this->emplace<typename decay<CancellationHandler>::type>(
|
||||||
|
ASIO_MOVE_CAST(CancellationHandler)(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Clears the slot.
|
||||||
|
/**
|
||||||
|
* Destroys any existing handler in the slot.
|
||||||
|
*/
|
||||||
|
ASIO_DECL void clear();
|
||||||
|
|
||||||
|
/// Returns whether the slot is connected to a signal.
|
||||||
|
ASIO_CONSTEXPR bool is_connected() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return handler_ != 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns whether the slot is connected and has an installed handler.
|
||||||
|
ASIO_CONSTEXPR bool has_handler() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return handler_ != 0 && *handler_ != 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare two slots for equality.
|
||||||
|
friend ASIO_CONSTEXPR bool operator==(const cancellation_slot& lhs,
|
||||||
|
const cancellation_slot& rhs) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return lhs.handler_ == rhs.handler_;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Compare two slots for inequality.
|
||||||
|
friend ASIO_CONSTEXPR bool operator!=(const cancellation_slot& lhs,
|
||||||
|
const cancellation_slot& rhs) ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return lhs.handler_ != rhs.handler_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
friend class cancellation_signal;
|
||||||
|
|
||||||
|
ASIO_CONSTEXPR cancellation_slot(int,
|
||||||
|
detail::cancellation_handler_base** handler)
|
||||||
|
: handler_(handler)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
ASIO_DECL std::pair<void*, std::size_t> prepare_memory(
|
||||||
|
std::size_t size, std::size_t align);
|
||||||
|
|
||||||
|
struct auto_delete_helper
|
||||||
|
{
|
||||||
|
std::pair<void*, std::size_t> mem;
|
||||||
|
|
||||||
|
ASIO_DECL ~auto_delete_helper();
|
||||||
|
};
|
||||||
|
|
||||||
|
detail::cancellation_handler_base** handler_;
|
||||||
|
};
|
||||||
|
|
||||||
|
inline cancellation_slot cancellation_signal::slot() ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancellation_slot(0, &handler_);
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HEADER_ONLY)
|
||||||
|
# include "asio/impl/cancellation_signal.ipp"
|
||||||
|
#endif // defined(ASIO_HEADER_ONLY)
|
||||||
|
|
||||||
|
#endif // ASIO_CANCELLATION_SIGNAL_HPP
|
235
lib/asio-1.26.0/asio/cancellation_state.hpp
Normal file
235
lib/asio-1.26.0/asio/cancellation_state.hpp
Normal file
|
@ -0,0 +1,235 @@
|
||||||
|
//
|
||||||
|
// cancellation_state.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_CANCELLATION_STATE_HPP
|
||||||
|
#define ASIO_CANCELLATION_STATE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cassert>
|
||||||
|
#include <new>
|
||||||
|
#include <utility>
|
||||||
|
#include "asio/cancellation_signal.hpp"
|
||||||
|
#include "asio/detail/cstddef.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// A simple cancellation signal propagation filter.
|
||||||
|
template <cancellation_type_t Mask>
|
||||||
|
struct cancellation_filter
|
||||||
|
{
|
||||||
|
/// Returns <tt>type & Mask</tt>.
|
||||||
|
cancellation_type_t operator()(
|
||||||
|
cancellation_type_t type) const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return type & Mask;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// A cancellation filter that disables cancellation.
|
||||||
|
typedef cancellation_filter<cancellation_type::none>
|
||||||
|
disable_cancellation;
|
||||||
|
|
||||||
|
/// A cancellation filter that enables terminal cancellation only.
|
||||||
|
typedef cancellation_filter<cancellation_type::terminal>
|
||||||
|
enable_terminal_cancellation;
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// A cancellation filter that enables terminal and partial cancellation.
|
||||||
|
typedef cancellation_filter<
|
||||||
|
cancellation_type::terminal | cancellation_type::partial>
|
||||||
|
enable_partial_cancellation;
|
||||||
|
|
||||||
|
/// A cancellation filter that enables terminal, partial and total cancellation.
|
||||||
|
typedef cancellation_filter<cancellation_type::terminal
|
||||||
|
| cancellation_type::partial | cancellation_type::total>
|
||||||
|
enable_total_cancellation;
|
||||||
|
|
||||||
|
#else // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
typedef cancellation_filter<
|
||||||
|
static_cast<cancellation_type_t>(
|
||||||
|
static_cast<unsigned int>(cancellation_type::terminal)
|
||||||
|
| static_cast<unsigned int>(cancellation_type::partial))>
|
||||||
|
enable_partial_cancellation;
|
||||||
|
|
||||||
|
typedef cancellation_filter<
|
||||||
|
static_cast<cancellation_type_t>(
|
||||||
|
static_cast<unsigned int>(cancellation_type::terminal)
|
||||||
|
| static_cast<unsigned int>(cancellation_type::partial)
|
||||||
|
| static_cast<unsigned int>(cancellation_type::total))>
|
||||||
|
enable_total_cancellation;
|
||||||
|
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// A cancellation state is used for chaining signals and slots in compositions.
|
||||||
|
class cancellation_state
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Construct a disconnected cancellation state.
|
||||||
|
ASIO_CONSTEXPR cancellation_state() ASIO_NOEXCEPT
|
||||||
|
: impl_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and attach to a parent slot to create a new child slot.
|
||||||
|
/**
|
||||||
|
* Initialises the cancellation state so that it allows terminal cancellation
|
||||||
|
* only. Equivalent to <tt>cancellation_state(slot,
|
||||||
|
* enable_terminal_cancellation())</tt>.
|
||||||
|
*
|
||||||
|
* @param slot The parent cancellation slot to which the state will be
|
||||||
|
* attached.
|
||||||
|
*/
|
||||||
|
template <typename CancellationSlot>
|
||||||
|
ASIO_CONSTEXPR explicit cancellation_state(CancellationSlot slot)
|
||||||
|
: impl_(slot.is_connected() ? &slot.template emplace<impl<> >() : 0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and attach to a parent slot to create a new child slot.
|
||||||
|
/**
|
||||||
|
* @param slot The parent cancellation slot to which the state will be
|
||||||
|
* attached.
|
||||||
|
*
|
||||||
|
* @param filter A function object that is used to transform incoming
|
||||||
|
* cancellation signals as they are received from the parent slot. This
|
||||||
|
* function object must have the signature:
|
||||||
|
* @code asio::cancellation_type_t filter(
|
||||||
|
* asio::cancellation_type_t); @endcode
|
||||||
|
*
|
||||||
|
* The library provides the following pre-defined cancellation filters:
|
||||||
|
*
|
||||||
|
* @li asio::disable_cancellation
|
||||||
|
* @li asio::enable_terminal_cancellation
|
||||||
|
* @li asio::enable_partial_cancellation
|
||||||
|
* @li asio::enable_total_cancellation
|
||||||
|
*/
|
||||||
|
template <typename CancellationSlot, typename Filter>
|
||||||
|
ASIO_CONSTEXPR cancellation_state(CancellationSlot slot, Filter filter)
|
||||||
|
: impl_(slot.is_connected()
|
||||||
|
? &slot.template emplace<impl<Filter, Filter> >(filter, filter)
|
||||||
|
: 0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Construct and attach to a parent slot to create a new child slot.
|
||||||
|
/**
|
||||||
|
* @param slot The parent cancellation slot to which the state will be
|
||||||
|
* attached.
|
||||||
|
*
|
||||||
|
* @param in_filter A function object that is used to transform incoming
|
||||||
|
* cancellation signals as they are received from the parent slot. This
|
||||||
|
* function object must have the signature:
|
||||||
|
* @code asio::cancellation_type_t in_filter(
|
||||||
|
* asio::cancellation_type_t); @endcode
|
||||||
|
*
|
||||||
|
* @param out_filter A function object that is used to transform outcoming
|
||||||
|
* cancellation signals as they are relayed to the child slot. This function
|
||||||
|
* object must have the signature:
|
||||||
|
* @code asio::cancellation_type_t out_filter(
|
||||||
|
* asio::cancellation_type_t); @endcode
|
||||||
|
*
|
||||||
|
* The library provides the following pre-defined cancellation filters:
|
||||||
|
*
|
||||||
|
* @li asio::disable_cancellation
|
||||||
|
* @li asio::enable_terminal_cancellation
|
||||||
|
* @li asio::enable_partial_cancellation
|
||||||
|
* @li asio::enable_total_cancellation
|
||||||
|
*/
|
||||||
|
template <typename CancellationSlot, typename InFilter, typename OutFilter>
|
||||||
|
ASIO_CONSTEXPR cancellation_state(CancellationSlot slot,
|
||||||
|
InFilter in_filter, OutFilter out_filter)
|
||||||
|
: impl_(slot.is_connected()
|
||||||
|
? &slot.template emplace<impl<InFilter, OutFilter> >(
|
||||||
|
ASIO_MOVE_CAST(InFilter)(in_filter),
|
||||||
|
ASIO_MOVE_CAST(OutFilter)(out_filter))
|
||||||
|
: 0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the single child slot associated with the state.
|
||||||
|
/**
|
||||||
|
* This sub-slot is used with the operations that are being composed.
|
||||||
|
*/
|
||||||
|
ASIO_CONSTEXPR cancellation_slot slot() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_ ? impl_->signal_.slot() : cancellation_slot();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns the cancellation types that have been triggered.
|
||||||
|
cancellation_type_t cancelled() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return impl_ ? impl_->cancelled_ : cancellation_type_t();
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Clears the specified cancellation types, if they have been triggered.
|
||||||
|
void clear(cancellation_type_t mask = cancellation_type::all)
|
||||||
|
ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
if (impl_)
|
||||||
|
impl_->cancelled_ &= ~mask;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
struct impl_base
|
||||||
|
{
|
||||||
|
impl_base()
|
||||||
|
: cancelled_()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
cancellation_signal signal_;
|
||||||
|
cancellation_type_t cancelled_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <
|
||||||
|
typename InFilter = enable_terminal_cancellation,
|
||||||
|
typename OutFilter = InFilter>
|
||||||
|
struct impl : impl_base
|
||||||
|
{
|
||||||
|
impl()
|
||||||
|
: in_filter_(),
|
||||||
|
out_filter_()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
impl(InFilter in_filter, OutFilter out_filter)
|
||||||
|
: in_filter_(ASIO_MOVE_CAST(InFilter)(in_filter)),
|
||||||
|
out_filter_(ASIO_MOVE_CAST(OutFilter)(out_filter))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void operator()(cancellation_type_t in)
|
||||||
|
{
|
||||||
|
this->cancelled_ = in_filter_(in);
|
||||||
|
cancellation_type_t out = out_filter_(this->cancelled_);
|
||||||
|
if (out != cancellation_type::none)
|
||||||
|
this->signal_.emit(out);
|
||||||
|
}
|
||||||
|
|
||||||
|
InFilter in_filter_;
|
||||||
|
OutFilter out_filter_;
|
||||||
|
};
|
||||||
|
|
||||||
|
impl_base* impl_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_CANCELLATION_STATE_HPP
|
174
lib/asio-1.26.0/asio/cancellation_type.hpp
Normal file
174
lib/asio-1.26.0/asio/cancellation_type.hpp
Normal file
|
@ -0,0 +1,174 @@
|
||||||
|
//
|
||||||
|
// cancellation_type.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_CANCELLATION_TYPE_HPP
|
||||||
|
#define ASIO_CANCELLATION_TYPE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
# if defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Enumeration representing the different types of cancellation that may
|
||||||
|
/// be requested from or implemented by an asynchronous operation.
|
||||||
|
enum cancellation_type
|
||||||
|
{
|
||||||
|
/// Bitmask representing no types of cancellation.
|
||||||
|
none = 0,
|
||||||
|
|
||||||
|
/// Requests cancellation where, following a successful cancellation, the only
|
||||||
|
/// safe operations on the I/O object are closure or destruction.
|
||||||
|
terminal = 1,
|
||||||
|
|
||||||
|
/// Requests cancellation where a successful cancellation may result in
|
||||||
|
/// partial side effects or no side effects. Following cancellation, the I/O
|
||||||
|
/// object is in a well-known state, and may be used for further operations.
|
||||||
|
partial = 2,
|
||||||
|
|
||||||
|
/// Requests cancellation where a successful cancellation results in no
|
||||||
|
/// apparent side effects. Following cancellation, the I/O object is in the
|
||||||
|
/// same observable state as it was prior to the operation.
|
||||||
|
total = 4,
|
||||||
|
|
||||||
|
/// Bitmask representing all types of cancellation.
|
||||||
|
all = 0xFFFFFFFF
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Portability typedef.
|
||||||
|
typedef cancellation_type cancellation_type_t;
|
||||||
|
|
||||||
|
#elif defined(ASIO_HAS_ENUM_CLASS)
|
||||||
|
|
||||||
|
enum class cancellation_type : unsigned int
|
||||||
|
{
|
||||||
|
none = 0,
|
||||||
|
terminal = 1,
|
||||||
|
partial = 2,
|
||||||
|
total = 4,
|
||||||
|
all = 0xFFFFFFFF
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef cancellation_type cancellation_type_t;
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_ENUM_CLASS)
|
||||||
|
|
||||||
|
namespace cancellation_type {
|
||||||
|
|
||||||
|
enum cancellation_type_t
|
||||||
|
{
|
||||||
|
none = 0,
|
||||||
|
terminal = 1,
|
||||||
|
partial = 2,
|
||||||
|
total = 4,
|
||||||
|
all = 0xFFFFFFFF
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace cancellation_type
|
||||||
|
|
||||||
|
typedef cancellation_type::cancellation_type_t cancellation_type_t;
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_ENUM_CLASS)
|
||||||
|
|
||||||
|
/// Negation operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline ASIO_CONSTEXPR bool operator!(cancellation_type_t x)
|
||||||
|
{
|
||||||
|
return static_cast<unsigned int>(x) == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise and operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline ASIO_CONSTEXPR cancellation_type_t operator&(
|
||||||
|
cancellation_type_t x, cancellation_type_t y)
|
||||||
|
{
|
||||||
|
return static_cast<cancellation_type_t>(
|
||||||
|
static_cast<unsigned int>(x) & static_cast<unsigned int>(y));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise or operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline ASIO_CONSTEXPR cancellation_type_t operator|(
|
||||||
|
cancellation_type_t x, cancellation_type_t y)
|
||||||
|
{
|
||||||
|
return static_cast<cancellation_type_t>(
|
||||||
|
static_cast<unsigned int>(x) | static_cast<unsigned int>(y));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise xor operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline ASIO_CONSTEXPR cancellation_type_t operator^(
|
||||||
|
cancellation_type_t x, cancellation_type_t y)
|
||||||
|
{
|
||||||
|
return static_cast<cancellation_type_t>(
|
||||||
|
static_cast<unsigned int>(x) ^ static_cast<unsigned int>(y));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise negation operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline ASIO_CONSTEXPR cancellation_type_t operator~(cancellation_type_t x)
|
||||||
|
{
|
||||||
|
return static_cast<cancellation_type_t>(~static_cast<unsigned int>(x));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise and-assignment operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline cancellation_type_t& operator&=(
|
||||||
|
cancellation_type_t& x, cancellation_type_t y)
|
||||||
|
{
|
||||||
|
x = x & y;
|
||||||
|
return x;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise or-assignment operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline cancellation_type_t& operator|=(
|
||||||
|
cancellation_type_t& x, cancellation_type_t y)
|
||||||
|
{
|
||||||
|
x = x | y;
|
||||||
|
return x;
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Bitwise xor-assignment operator.
|
||||||
|
/**
|
||||||
|
* @relates cancellation_type
|
||||||
|
*/
|
||||||
|
inline cancellation_type_t& operator^=(
|
||||||
|
cancellation_type_t& x, cancellation_type_t y)
|
||||||
|
{
|
||||||
|
x = x ^ y;
|
||||||
|
return x;
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_CANCELLATION_TYPE_HPP
|
523
lib/asio-1.26.0/asio/co_spawn.hpp
Normal file
523
lib/asio-1.26.0/asio/co_spawn.hpp
Normal file
|
@ -0,0 +1,523 @@
|
||||||
|
//
|
||||||
|
// co_spawn.hpp
|
||||||
|
// ~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_CO_SPAWN_HPP
|
||||||
|
#define ASIO_CO_SPAWN_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_CO_AWAIT) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include "asio/awaitable.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
struct awaitable_signature;
|
||||||
|
|
||||||
|
template <typename T, typename Executor>
|
||||||
|
struct awaitable_signature<awaitable<T, Executor>>
|
||||||
|
{
|
||||||
|
typedef void type(std::exception_ptr, T);
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Executor>
|
||||||
|
struct awaitable_signature<awaitable<void, Executor>>
|
||||||
|
{
|
||||||
|
typedef void type(std::exception_ptr);
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Spawn a new coroutined-based thread of execution.
|
||||||
|
/**
|
||||||
|
* @param ex The executor that will be used to schedule the new thread of
|
||||||
|
* execution.
|
||||||
|
*
|
||||||
|
* @param a The asio::awaitable object that is the result of calling the
|
||||||
|
* coroutine's entry point function.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will handle the notification that
|
||||||
|
* the thread of execution has completed. The function signature of the
|
||||||
|
* completion handler must be:
|
||||||
|
* @code void handler(std::exception_ptr, T); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(std::exception_ptr, T) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::awaitable<std::size_t> echo(tcp::socket socket)
|
||||||
|
* {
|
||||||
|
* std::size_t bytes_transferred = 0;
|
||||||
|
*
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* bytes_transferred += n;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception&)
|
||||||
|
* {
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* co_return bytes_transferred;
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // ...
|
||||||
|
*
|
||||||
|
* asio::co_spawn(my_executor,
|
||||||
|
* echo(std::move(my_tcp_socket)),
|
||||||
|
* [](std::exception_ptr e, std::size_t n)
|
||||||
|
* {
|
||||||
|
* std::cout << "transferred " << n << "\n";
|
||||||
|
* });
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* The new thread of execution is created with a cancellation state that
|
||||||
|
* supports @c cancellation_type::terminal values only. To change the
|
||||||
|
* cancellation state, call asio::this_coro::reset_cancellation_state.
|
||||||
|
*/
|
||||||
|
template <typename Executor, typename T, typename AwaitableExecutor,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(
|
||||||
|
void(std::exception_ptr, T)) CompletionToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(Executor)>
|
||||||
|
inline ASIO_INITFN_AUTO_RESULT_TYPE(
|
||||||
|
CompletionToken, void(std::exception_ptr, T))
|
||||||
|
co_spawn(const Executor& ex, awaitable<T, AwaitableExecutor> a,
|
||||||
|
CompletionToken&& token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(Executor),
|
||||||
|
typename constraint<
|
||||||
|
(is_executor<Executor>::value || execution::is_executor<Executor>::value)
|
||||||
|
&& is_convertible<Executor, AwaitableExecutor>::value
|
||||||
|
>::type = 0);
|
||||||
|
|
||||||
|
/// Spawn a new coroutined-based thread of execution.
|
||||||
|
/**
|
||||||
|
* @param ex The executor that will be used to schedule the new thread of
|
||||||
|
* execution.
|
||||||
|
*
|
||||||
|
* @param a The asio::awaitable object that is the result of calling the
|
||||||
|
* coroutine's entry point function.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will handle the notification that
|
||||||
|
* the thread of execution has completed. The function signature of the
|
||||||
|
* completion handler must be:
|
||||||
|
* @code void handler(std::exception_ptr); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(std::exception_ptr) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::awaitable<void> echo(tcp::socket socket)
|
||||||
|
* {
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception& e)
|
||||||
|
* {
|
||||||
|
* std::cerr << "Exception: " << e.what() << "\n";
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // ...
|
||||||
|
*
|
||||||
|
* asio::co_spawn(my_executor,
|
||||||
|
* echo(std::move(my_tcp_socket)),
|
||||||
|
* asio::detached);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* The new thread of execution is created with a cancellation state that
|
||||||
|
* supports @c cancellation_type::terminal values only. To change the
|
||||||
|
* cancellation state, call asio::this_coro::reset_cancellation_state.
|
||||||
|
*/
|
||||||
|
template <typename Executor, typename AwaitableExecutor,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(
|
||||||
|
void(std::exception_ptr)) CompletionToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(Executor)>
|
||||||
|
inline ASIO_INITFN_AUTO_RESULT_TYPE(
|
||||||
|
CompletionToken, void(std::exception_ptr))
|
||||||
|
co_spawn(const Executor& ex, awaitable<void, AwaitableExecutor> a,
|
||||||
|
CompletionToken&& token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(Executor),
|
||||||
|
typename constraint<
|
||||||
|
(is_executor<Executor>::value || execution::is_executor<Executor>::value)
|
||||||
|
&& is_convertible<Executor, AwaitableExecutor>::value
|
||||||
|
>::type = 0);
|
||||||
|
|
||||||
|
/// Spawn a new coroutined-based thread of execution.
|
||||||
|
/**
|
||||||
|
* @param ctx An execution context that will provide the executor to be used to
|
||||||
|
* schedule the new thread of execution.
|
||||||
|
*
|
||||||
|
* @param a The asio::awaitable object that is the result of calling the
|
||||||
|
* coroutine's entry point function.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will handle the notification that
|
||||||
|
* the thread of execution has completed. The function signature of the
|
||||||
|
* completion handler must be:
|
||||||
|
* @code void handler(std::exception_ptr); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(std::exception_ptr, T) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::awaitable<std::size_t> echo(tcp::socket socket)
|
||||||
|
* {
|
||||||
|
* std::size_t bytes_transferred = 0;
|
||||||
|
*
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* bytes_transferred += n;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception&)
|
||||||
|
* {
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* co_return bytes_transferred;
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // ...
|
||||||
|
*
|
||||||
|
* asio::co_spawn(my_io_context,
|
||||||
|
* echo(std::move(my_tcp_socket)),
|
||||||
|
* [](std::exception_ptr e, std::size_t n)
|
||||||
|
* {
|
||||||
|
* std::cout << "transferred " << n << "\n";
|
||||||
|
* });
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* The new thread of execution is created with a cancellation state that
|
||||||
|
* supports @c cancellation_type::terminal values only. To change the
|
||||||
|
* cancellation state, call asio::this_coro::reset_cancellation_state.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext, typename T, typename AwaitableExecutor,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(
|
||||||
|
void(std::exception_ptr, T)) CompletionToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(
|
||||||
|
typename ExecutionContext::executor_type)>
|
||||||
|
inline ASIO_INITFN_AUTO_RESULT_TYPE(
|
||||||
|
CompletionToken, void(std::exception_ptr, T))
|
||||||
|
co_spawn(ExecutionContext& ctx, awaitable<T, AwaitableExecutor> a,
|
||||||
|
CompletionToken&& token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(
|
||||||
|
typename ExecutionContext::executor_type),
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
&& is_convertible<typename ExecutionContext::executor_type,
|
||||||
|
AwaitableExecutor>::value
|
||||||
|
>::type = 0);
|
||||||
|
|
||||||
|
/// Spawn a new coroutined-based thread of execution.
|
||||||
|
/**
|
||||||
|
* @param ctx An execution context that will provide the executor to be used to
|
||||||
|
* schedule the new thread of execution.
|
||||||
|
*
|
||||||
|
* @param a The asio::awaitable object that is the result of calling the
|
||||||
|
* coroutine's entry point function.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will handle the notification that
|
||||||
|
* the thread of execution has completed. The function signature of the
|
||||||
|
* completion handler must be:
|
||||||
|
* @code void handler(std::exception_ptr); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(std::exception_ptr) @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::awaitable<void> echo(tcp::socket socket)
|
||||||
|
* {
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception& e)
|
||||||
|
* {
|
||||||
|
* std::cerr << "Exception: " << e.what() << "\n";
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // ...
|
||||||
|
*
|
||||||
|
* asio::co_spawn(my_io_context,
|
||||||
|
* echo(std::move(my_tcp_socket)),
|
||||||
|
* asio::detached);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* The new thread of execution is created with a cancellation state that
|
||||||
|
* supports @c cancellation_type::terminal values only. To change the
|
||||||
|
* cancellation state, call asio::this_coro::reset_cancellation_state.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext, typename AwaitableExecutor,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(
|
||||||
|
void(std::exception_ptr)) CompletionToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(
|
||||||
|
typename ExecutionContext::executor_type)>
|
||||||
|
inline ASIO_INITFN_AUTO_RESULT_TYPE(
|
||||||
|
CompletionToken, void(std::exception_ptr))
|
||||||
|
co_spawn(ExecutionContext& ctx, awaitable<void, AwaitableExecutor> a,
|
||||||
|
CompletionToken&& token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(
|
||||||
|
typename ExecutionContext::executor_type),
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
&& is_convertible<typename ExecutionContext::executor_type,
|
||||||
|
AwaitableExecutor>::value
|
||||||
|
>::type = 0);
|
||||||
|
|
||||||
|
/// Spawn a new coroutined-based thread of execution.
|
||||||
|
/**
|
||||||
|
* @param ex The executor that will be used to schedule the new thread of
|
||||||
|
* execution.
|
||||||
|
*
|
||||||
|
* @param f A nullary function object with a return type of the form
|
||||||
|
* @c asio::awaitable<R,E> that will be used as the coroutine's entry
|
||||||
|
* point.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will handle the notification
|
||||||
|
* that the thread of execution has completed. If @c R is @c void, the function
|
||||||
|
* signature of the completion handler must be:
|
||||||
|
*
|
||||||
|
* @code void handler(std::exception_ptr); @endcode
|
||||||
|
* Otherwise, the function signature of the completion handler must be:
|
||||||
|
* @code void handler(std::exception_ptr, R); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(std::exception_ptr, R) @endcode
|
||||||
|
* where @c R is the first template argument to the @c awaitable returned by the
|
||||||
|
* supplied function object @c F:
|
||||||
|
* @code asio::awaitable<R, AwaitableExecutor> F() @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::awaitable<std::size_t> echo(tcp::socket socket)
|
||||||
|
* {
|
||||||
|
* std::size_t bytes_transferred = 0;
|
||||||
|
*
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* bytes_transferred += n;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception&)
|
||||||
|
* {
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* co_return bytes_transferred;
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // ...
|
||||||
|
*
|
||||||
|
* asio::co_spawn(my_executor,
|
||||||
|
* [socket = std::move(my_tcp_socket)]() mutable
|
||||||
|
* -> asio::awaitable<void>
|
||||||
|
* {
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception& e)
|
||||||
|
* {
|
||||||
|
* std::cerr << "Exception: " << e.what() << "\n";
|
||||||
|
* }
|
||||||
|
* }, asio::detached);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* The new thread of execution is created with a cancellation state that
|
||||||
|
* supports @c cancellation_type::terminal values only. To change the
|
||||||
|
* cancellation state, call asio::this_coro::reset_cancellation_state.
|
||||||
|
*/
|
||||||
|
template <typename Executor, typename F,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(typename detail::awaitable_signature<
|
||||||
|
typename result_of<F()>::type>::type) CompletionToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(Executor)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken,
|
||||||
|
typename detail::awaitable_signature<typename result_of<F()>::type>::type)
|
||||||
|
co_spawn(const Executor& ex, F&& f,
|
||||||
|
CompletionToken&& token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(Executor),
|
||||||
|
typename constraint<
|
||||||
|
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||||
|
>::type = 0);
|
||||||
|
|
||||||
|
/// Spawn a new coroutined-based thread of execution.
|
||||||
|
/**
|
||||||
|
* @param ctx An execution context that will provide the executor to be used to
|
||||||
|
* schedule the new thread of execution.
|
||||||
|
*
|
||||||
|
* @param f A nullary function object with a return type of the form
|
||||||
|
* @c asio::awaitable<R,E> that will be used as the coroutine's entry
|
||||||
|
* point.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will handle the notification
|
||||||
|
* that the thread of execution has completed. If @c R is @c void, the function
|
||||||
|
* signature of the completion handler must be:
|
||||||
|
*
|
||||||
|
* @code void handler(std::exception_ptr); @endcode
|
||||||
|
* Otherwise, the function signature of the completion handler must be:
|
||||||
|
* @code void handler(std::exception_ptr, R); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void(std::exception_ptr, R) @endcode
|
||||||
|
* where @c R is the first template argument to the @c awaitable returned by the
|
||||||
|
* supplied function object @c F:
|
||||||
|
* @code asio::awaitable<R, AwaitableExecutor> F() @endcode
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* @code
|
||||||
|
* asio::awaitable<std::size_t> echo(tcp::socket socket)
|
||||||
|
* {
|
||||||
|
* std::size_t bytes_transferred = 0;
|
||||||
|
*
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* bytes_transferred += n;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception&)
|
||||||
|
* {
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* co_return bytes_transferred;
|
||||||
|
* }
|
||||||
|
*
|
||||||
|
* // ...
|
||||||
|
*
|
||||||
|
* asio::co_spawn(my_io_context,
|
||||||
|
* [socket = std::move(my_tcp_socket)]() mutable
|
||||||
|
* -> asio::awaitable<void>
|
||||||
|
* {
|
||||||
|
* try
|
||||||
|
* {
|
||||||
|
* char data[1024];
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* std::size_t n = co_await socket.async_read_some(
|
||||||
|
* asio::buffer(data), asio::use_awaitable);
|
||||||
|
*
|
||||||
|
* co_await asio::async_write(socket,
|
||||||
|
* asio::buffer(data, n), asio::use_awaitable);
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* catch (const std::exception& e)
|
||||||
|
* {
|
||||||
|
* std::cerr << "Exception: " << e.what() << "\n";
|
||||||
|
* }
|
||||||
|
* }, asio::detached);
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @par Per-Operation Cancellation
|
||||||
|
* The new thread of execution is created with a cancellation state that
|
||||||
|
* supports @c cancellation_type::terminal values only. To change the
|
||||||
|
* cancellation state, call asio::this_coro::reset_cancellation_state.
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext, typename F,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(typename detail::awaitable_signature<
|
||||||
|
typename result_of<F()>::type>::type) CompletionToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(
|
||||||
|
typename ExecutionContext::executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken,
|
||||||
|
typename detail::awaitable_signature<typename result_of<F()>::type>::type)
|
||||||
|
co_spawn(ExecutionContext& ctx, F&& f,
|
||||||
|
CompletionToken&& token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(
|
||||||
|
typename ExecutionContext::executor_type),
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<ExecutionContext&, execution_context&>::value
|
||||||
|
>::type = 0);
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/co_spawn.hpp"
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_CO_AWAIT) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_CO_SPAWN_HPP
|
218
lib/asio-1.26.0/asio/completion_condition.hpp
Normal file
218
lib/asio-1.26.0/asio/completion_condition.hpp
Normal file
|
@ -0,0 +1,218 @@
|
||||||
|
//
|
||||||
|
// completion_condition.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_COMPLETION_CONDITION_HPP
|
||||||
|
#define ASIO_COMPLETION_CONDITION_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// The default maximum number of bytes to transfer in a single operation.
|
||||||
|
enum default_max_transfer_size_t { default_max_transfer_size = 65536 };
|
||||||
|
|
||||||
|
// Adapt result of old-style completion conditions (which had a bool result
|
||||||
|
// where true indicated that the operation was complete).
|
||||||
|
inline std::size_t adapt_completion_condition_result(bool result)
|
||||||
|
{
|
||||||
|
return result ? 0 : default_max_transfer_size;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Adapt result of current completion conditions (which have a size_t result
|
||||||
|
// where 0 means the operation is complete, and otherwise the result is the
|
||||||
|
// maximum number of bytes to transfer on the next underlying operation).
|
||||||
|
inline std::size_t adapt_completion_condition_result(std::size_t result)
|
||||||
|
{
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
class transfer_all_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef std::size_t result_type;
|
||||||
|
|
||||||
|
template <typename Error>
|
||||||
|
std::size_t operator()(const Error& err, std::size_t)
|
||||||
|
{
|
||||||
|
return !!err ? 0 : default_max_transfer_size;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
class transfer_at_least_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef std::size_t result_type;
|
||||||
|
|
||||||
|
explicit transfer_at_least_t(std::size_t minimum)
|
||||||
|
: minimum_(minimum)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Error>
|
||||||
|
std::size_t operator()(const Error& err, std::size_t bytes_transferred)
|
||||||
|
{
|
||||||
|
return (!!err || bytes_transferred >= minimum_)
|
||||||
|
? 0 : default_max_transfer_size;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
std::size_t minimum_;
|
||||||
|
};
|
||||||
|
|
||||||
|
class transfer_exactly_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef std::size_t result_type;
|
||||||
|
|
||||||
|
explicit transfer_exactly_t(std::size_t size)
|
||||||
|
: size_(size)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Error>
|
||||||
|
std::size_t operator()(const Error& err, std::size_t bytes_transferred)
|
||||||
|
{
|
||||||
|
return (!!err || bytes_transferred >= size_) ? 0 :
|
||||||
|
(size_ - bytes_transferred < default_max_transfer_size
|
||||||
|
? size_ - bytes_transferred : std::size_t(default_max_transfer_size));
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
std::size_t size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @defgroup completion_condition Completion Condition Function Objects
|
||||||
|
*
|
||||||
|
* Function objects used for determining when a read or write operation should
|
||||||
|
* complete.
|
||||||
|
*/
|
||||||
|
/*@{*/
|
||||||
|
|
||||||
|
/// Return a completion condition function object that indicates that a read or
|
||||||
|
/// write operation should continue until all of the data has been transferred,
|
||||||
|
/// or until an error occurs.
|
||||||
|
/**
|
||||||
|
* This function is used to create an object, of unspecified type, that meets
|
||||||
|
* CompletionCondition requirements.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* Reading until a buffer is full:
|
||||||
|
* @code
|
||||||
|
* boost::array<char, 128> buf;
|
||||||
|
* asio::error_code ec;
|
||||||
|
* std::size_t n = asio::read(
|
||||||
|
* sock, asio::buffer(buf),
|
||||||
|
* asio::transfer_all(), ec);
|
||||||
|
* if (ec)
|
||||||
|
* {
|
||||||
|
* // An error occurred.
|
||||||
|
* }
|
||||||
|
* else
|
||||||
|
* {
|
||||||
|
* // n == 128
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
unspecified transfer_all();
|
||||||
|
#else
|
||||||
|
inline detail::transfer_all_t transfer_all()
|
||||||
|
{
|
||||||
|
return detail::transfer_all_t();
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Return a completion condition function object that indicates that a read or
|
||||||
|
/// write operation should continue until a minimum number of bytes has been
|
||||||
|
/// transferred, or until an error occurs.
|
||||||
|
/**
|
||||||
|
* This function is used to create an object, of unspecified type, that meets
|
||||||
|
* CompletionCondition requirements.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* Reading until a buffer is full or contains at least 64 bytes:
|
||||||
|
* @code
|
||||||
|
* boost::array<char, 128> buf;
|
||||||
|
* asio::error_code ec;
|
||||||
|
* std::size_t n = asio::read(
|
||||||
|
* sock, asio::buffer(buf),
|
||||||
|
* asio::transfer_at_least(64), ec);
|
||||||
|
* if (ec)
|
||||||
|
* {
|
||||||
|
* // An error occurred.
|
||||||
|
* }
|
||||||
|
* else
|
||||||
|
* {
|
||||||
|
* // n >= 64 && n <= 128
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
unspecified transfer_at_least(std::size_t minimum);
|
||||||
|
#else
|
||||||
|
inline detail::transfer_at_least_t transfer_at_least(std::size_t minimum)
|
||||||
|
{
|
||||||
|
return detail::transfer_at_least_t(minimum);
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/// Return a completion condition function object that indicates that a read or
|
||||||
|
/// write operation should continue until an exact number of bytes has been
|
||||||
|
/// transferred, or until an error occurs.
|
||||||
|
/**
|
||||||
|
* This function is used to create an object, of unspecified type, that meets
|
||||||
|
* CompletionCondition requirements.
|
||||||
|
*
|
||||||
|
* @par Example
|
||||||
|
* Reading until a buffer is full or contains exactly 64 bytes:
|
||||||
|
* @code
|
||||||
|
* boost::array<char, 128> buf;
|
||||||
|
* asio::error_code ec;
|
||||||
|
* std::size_t n = asio::read(
|
||||||
|
* sock, asio::buffer(buf),
|
||||||
|
* asio::transfer_exactly(64), ec);
|
||||||
|
* if (ec)
|
||||||
|
* {
|
||||||
|
* // An error occurred.
|
||||||
|
* }
|
||||||
|
* else
|
||||||
|
* {
|
||||||
|
* // n == 64
|
||||||
|
* }
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
unspecified transfer_exactly(std::size_t size);
|
||||||
|
#else
|
||||||
|
inline detail::transfer_exactly_t transfer_exactly(std::size_t size)
|
||||||
|
{
|
||||||
|
return detail::transfer_exactly_t(size);
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/*@}*/
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_COMPLETION_CONDITION_HPP
|
531
lib/asio-1.26.0/asio/compose.hpp
Normal file
531
lib/asio-1.26.0/asio/compose.hpp
Normal file
|
@ -0,0 +1,531 @@
|
||||||
|
//
|
||||||
|
// compose.hpp
|
||||||
|
// ~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_COMPOSE_HPP
|
||||||
|
#define ASIO_COMPOSE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/associated_executor.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/base_from_cancellation_state.hpp"
|
||||||
|
#include "asio/detail/composed_work.hpp"
|
||||||
|
#include "asio/detail/handler_alloc_helpers.hpp"
|
||||||
|
#include "asio/detail/handler_cont_helpers.hpp"
|
||||||
|
#include "asio/detail/handler_invoke_helpers.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/variadic_templates.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
template <typename Impl, typename Work, typename Handler, typename Signature>
|
||||||
|
class composed_op;
|
||||||
|
|
||||||
|
template <typename Impl, typename Work, typename Handler,
|
||||||
|
typename R, typename... Args>
|
||||||
|
class composed_op<Impl, Work, Handler, R(Args...)>
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
template <typename Impl, typename Work, typename Handler, typename Signature>
|
||||||
|
class composed_op
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
: public base_from_cancellation_state<Handler>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename I, typename W, typename H>
|
||||||
|
composed_op(ASIO_MOVE_ARG(I) impl,
|
||||||
|
ASIO_MOVE_ARG(W) work,
|
||||||
|
ASIO_MOVE_ARG(H) handler)
|
||||||
|
: base_from_cancellation_state<Handler>(
|
||||||
|
handler, enable_terminal_cancellation()),
|
||||||
|
impl_(ASIO_MOVE_CAST(I)(impl)),
|
||||||
|
work_(ASIO_MOVE_CAST(W)(work)),
|
||||||
|
handler_(ASIO_MOVE_CAST(H)(handler)),
|
||||||
|
invocations_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_MOVE)
|
||||||
|
composed_op(composed_op&& other)
|
||||||
|
: base_from_cancellation_state<Handler>(
|
||||||
|
ASIO_MOVE_CAST(base_from_cancellation_state<
|
||||||
|
Handler>)(other)),
|
||||||
|
impl_(ASIO_MOVE_CAST(Impl)(other.impl_)),
|
||||||
|
work_(ASIO_MOVE_CAST(Work)(other.work_)),
|
||||||
|
handler_(ASIO_MOVE_CAST(Handler)(other.handler_)),
|
||||||
|
invocations_(other.invocations_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_MOVE)
|
||||||
|
|
||||||
|
typedef typename composed_work_guard<
|
||||||
|
typename Work::head_type>::executor_type io_executor_type;
|
||||||
|
|
||||||
|
io_executor_type get_io_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return work_.head_.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef typename associated_executor<Handler, io_executor_type>::type
|
||||||
|
executor_type;
|
||||||
|
|
||||||
|
executor_type get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return (get_associated_executor)(handler_, work_.head_.get_executor());
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef typename associated_allocator<Handler,
|
||||||
|
std::allocator<void> >::type allocator_type;
|
||||||
|
|
||||||
|
allocator_type get_allocator() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return (get_associated_allocator)(handler_, std::allocator<void>());
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template<typename... T>
|
||||||
|
void operator()(ASIO_MOVE_ARG(T)... t)
|
||||||
|
{
|
||||||
|
if (invocations_ < ~0u)
|
||||||
|
++invocations_;
|
||||||
|
this->get_cancellation_state().slot().clear();
|
||||||
|
impl_(*this, ASIO_MOVE_CAST(T)(t)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
void complete(Args... args)
|
||||||
|
{
|
||||||
|
this->work_.reset();
|
||||||
|
ASIO_MOVE_OR_LVALUE(Handler)(this->handler_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
void operator()()
|
||||||
|
{
|
||||||
|
if (invocations_ < ~0u)
|
||||||
|
++invocations_;
|
||||||
|
this->get_cancellation_state().slot().clear();
|
||||||
|
impl_(*this);
|
||||||
|
}
|
||||||
|
|
||||||
|
void complete()
|
||||||
|
{
|
||||||
|
this->work_.reset();
|
||||||
|
ASIO_MOVE_OR_LVALUE(Handler)(this->handler_)();
|
||||||
|
}
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_COMPOSED_OP_DEF(n) \
|
||||||
|
template<ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void operator()(ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
if (invocations_ < ~0u) \
|
||||||
|
++invocations_; \
|
||||||
|
this->get_cancellation_state().slot().clear(); \
|
||||||
|
impl_(*this, ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
template<ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
void complete(ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
this->work_.reset(); \
|
||||||
|
ASIO_MOVE_OR_LVALUE(Handler)(this->handler_)( \
|
||||||
|
ASIO_VARIADIC_MOVE_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_COMPOSED_OP_DEF)
|
||||||
|
#undef ASIO_PRIVATE_COMPOSED_OP_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
void reset_cancellation_state()
|
||||||
|
{
|
||||||
|
base_from_cancellation_state<Handler>::reset_cancellation_state(handler_);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Filter>
|
||||||
|
void reset_cancellation_state(ASIO_MOVE_ARG(Filter) filter)
|
||||||
|
{
|
||||||
|
base_from_cancellation_state<Handler>::reset_cancellation_state(handler_,
|
||||||
|
ASIO_MOVE_CAST(Filter)(filter));
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename InFilter, typename OutFilter>
|
||||||
|
void reset_cancellation_state(ASIO_MOVE_ARG(InFilter) in_filter,
|
||||||
|
ASIO_MOVE_ARG(OutFilter) out_filter)
|
||||||
|
{
|
||||||
|
base_from_cancellation_state<Handler>::reset_cancellation_state(handler_,
|
||||||
|
ASIO_MOVE_CAST(InFilter)(in_filter),
|
||||||
|
ASIO_MOVE_CAST(OutFilter)(out_filter));
|
||||||
|
}
|
||||||
|
|
||||||
|
cancellation_type_t cancelled() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return base_from_cancellation_state<Handler>::cancelled();
|
||||||
|
}
|
||||||
|
|
||||||
|
//private:
|
||||||
|
Impl impl_;
|
||||||
|
Work work_;
|
||||||
|
Handler handler_;
|
||||||
|
unsigned invocations_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Impl, typename Work, typename Handler, typename Signature>
|
||||||
|
inline asio_handler_allocate_is_deprecated
|
||||||
|
asio_handler_allocate(std::size_t size,
|
||||||
|
composed_op<Impl, Work, Handler, Signature>* this_handler)
|
||||||
|
{
|
||||||
|
#if defined(ASIO_NO_DEPRECATED)
|
||||||
|
asio_handler_alloc_helpers::allocate(size, this_handler->handler_);
|
||||||
|
return asio_handler_allocate_is_no_longer_used();
|
||||||
|
#else // defined(ASIO_NO_DEPRECATED)
|
||||||
|
return asio_handler_alloc_helpers::allocate(
|
||||||
|
size, this_handler->handler_);
|
||||||
|
#endif // defined(ASIO_NO_DEPRECATED)
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Impl, typename Work, typename Handler, typename Signature>
|
||||||
|
inline asio_handler_deallocate_is_deprecated
|
||||||
|
asio_handler_deallocate(void* pointer, std::size_t size,
|
||||||
|
composed_op<Impl, Work, Handler, Signature>* this_handler)
|
||||||
|
{
|
||||||
|
asio_handler_alloc_helpers::deallocate(
|
||||||
|
pointer, size, this_handler->handler_);
|
||||||
|
#if defined(ASIO_NO_DEPRECATED)
|
||||||
|
return asio_handler_deallocate_is_no_longer_used();
|
||||||
|
#endif // defined(ASIO_NO_DEPRECATED)
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Impl, typename Work, typename Handler, typename Signature>
|
||||||
|
inline bool asio_handler_is_continuation(
|
||||||
|
composed_op<Impl, Work, Handler, Signature>* this_handler)
|
||||||
|
{
|
||||||
|
return this_handler->invocations_ > 1 ? true
|
||||||
|
: asio_handler_cont_helpers::is_continuation(
|
||||||
|
this_handler->handler_);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Function, typename Impl,
|
||||||
|
typename Work, typename Handler, typename Signature>
|
||||||
|
inline asio_handler_invoke_is_deprecated
|
||||||
|
asio_handler_invoke(Function& function,
|
||||||
|
composed_op<Impl, Work, Handler, Signature>* this_handler)
|
||||||
|
{
|
||||||
|
asio_handler_invoke_helpers::invoke(
|
||||||
|
function, this_handler->handler_);
|
||||||
|
#if defined(ASIO_NO_DEPRECATED)
|
||||||
|
return asio_handler_invoke_is_no_longer_used();
|
||||||
|
#endif // defined(ASIO_NO_DEPRECATED)
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Function, typename Impl,
|
||||||
|
typename Work, typename Handler, typename Signature>
|
||||||
|
inline asio_handler_invoke_is_deprecated
|
||||||
|
asio_handler_invoke(const Function& function,
|
||||||
|
composed_op<Impl, Work, Handler, Signature>* this_handler)
|
||||||
|
{
|
||||||
|
asio_handler_invoke_helpers::invoke(
|
||||||
|
function, this_handler->handler_);
|
||||||
|
#if defined(ASIO_NO_DEPRECATED)
|
||||||
|
return asio_handler_invoke_is_no_longer_used();
|
||||||
|
#endif // defined(ASIO_NO_DEPRECATED)
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Signature, typename Executors>
|
||||||
|
class initiate_composed_op
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef typename composed_io_executors<Executors>::head_type executor_type;
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
explicit initiate_composed_op(int, ASIO_MOVE_ARG(T) executors)
|
||||||
|
: executors_(ASIO_MOVE_CAST(T)(executors))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
executor_type get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return executors_.head_;
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Handler, typename Impl>
|
||||||
|
void operator()(ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
ASIO_MOVE_ARG(Impl) impl) const
|
||||||
|
{
|
||||||
|
composed_op<typename decay<Impl>::type, composed_work<Executors>,
|
||||||
|
typename decay<Handler>::type, Signature>(
|
||||||
|
ASIO_MOVE_CAST(Impl)(impl),
|
||||||
|
composed_work<Executors>(executors_),
|
||||||
|
ASIO_MOVE_CAST(Handler)(handler))();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
composed_io_executors<Executors> executors_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Signature, typename Executors>
|
||||||
|
inline initiate_composed_op<Signature, Executors> make_initiate_composed_op(
|
||||||
|
ASIO_MOVE_ARG(composed_io_executors<Executors>) executors)
|
||||||
|
{
|
||||||
|
return initiate_composed_op<Signature, Executors>(0,
|
||||||
|
ASIO_MOVE_CAST(composed_io_executors<Executors>)(executors));
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <template <typename, typename> class Associator,
|
||||||
|
typename Impl, typename Work, typename Handler,
|
||||||
|
typename Signature, typename DefaultCandidate>
|
||||||
|
struct associator<Associator,
|
||||||
|
detail::composed_op<Impl, Work, Handler, Signature>,
|
||||||
|
DefaultCandidate>
|
||||||
|
: Associator<Handler, DefaultCandidate>
|
||||||
|
{
|
||||||
|
static typename Associator<Handler, DefaultCandidate>::type
|
||||||
|
get(const detail::composed_op<Impl, Work, Handler, Signature>& h)
|
||||||
|
ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return Associator<Handler, DefaultCandidate>::get(h.handler_);
|
||||||
|
}
|
||||||
|
|
||||||
|
static ASIO_AUTO_RETURN_TYPE_PREFIX2(
|
||||||
|
typename Associator<Handler, DefaultCandidate>::type)
|
||||||
|
get(const detail::composed_op<Impl, Work, Handler, Signature>& h,
|
||||||
|
const DefaultCandidate& c) ASIO_NOEXCEPT
|
||||||
|
ASIO_AUTO_RETURN_TYPE_SUFFIX((
|
||||||
|
Associator<Handler, DefaultCandidate>::get(h.handler_, c)))
|
||||||
|
{
|
||||||
|
return Associator<Handler, DefaultCandidate>::get(h.handler_, c);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Launch an asynchronous operation with a stateful implementation.
|
||||||
|
/**
|
||||||
|
* The async_compose function simplifies the implementation of composed
|
||||||
|
* asynchronous operations automatically wrapping a stateful function object
|
||||||
|
* with a conforming intermediate completion handler.
|
||||||
|
*
|
||||||
|
* @param implementation A function object that contains the implementation of
|
||||||
|
* the composed asynchronous operation. The first argument to the function
|
||||||
|
* object is a non-const reference to the enclosing intermediate completion
|
||||||
|
* handler. The remaining arguments are any arguments that originate from the
|
||||||
|
* completion handlers of any asynchronous operations performed by the
|
||||||
|
* implementation.
|
||||||
|
*
|
||||||
|
* @param token The completion token.
|
||||||
|
*
|
||||||
|
* @param io_objects_or_executors Zero or more I/O objects or I/O executors for
|
||||||
|
* which outstanding work must be maintained.
|
||||||
|
*
|
||||||
|
* @par Example:
|
||||||
|
*
|
||||||
|
* @code struct async_echo_implementation
|
||||||
|
* {
|
||||||
|
* tcp::socket& socket_;
|
||||||
|
* asio::mutable_buffer buffer_;
|
||||||
|
* enum { starting, reading, writing } state_;
|
||||||
|
*
|
||||||
|
* template <typename Self>
|
||||||
|
* void operator()(Self& self,
|
||||||
|
* asio::error_code error = {},
|
||||||
|
* std::size_t n = 0)
|
||||||
|
* {
|
||||||
|
* switch (state_)
|
||||||
|
* {
|
||||||
|
* case starting:
|
||||||
|
* state_ = reading;
|
||||||
|
* socket_.async_read_some(
|
||||||
|
* buffer_, std::move(self));
|
||||||
|
* break;
|
||||||
|
* case reading:
|
||||||
|
* if (error)
|
||||||
|
* {
|
||||||
|
* self.complete(error, 0);
|
||||||
|
* }
|
||||||
|
* else
|
||||||
|
* {
|
||||||
|
* state_ = writing;
|
||||||
|
* asio::async_write(socket_, buffer_,
|
||||||
|
* asio::transfer_exactly(n),
|
||||||
|
* std::move(self));
|
||||||
|
* }
|
||||||
|
* break;
|
||||||
|
* case writing:
|
||||||
|
* self.complete(error, n);
|
||||||
|
* break;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* };
|
||||||
|
*
|
||||||
|
* template <typename CompletionToken>
|
||||||
|
* auto async_echo(tcp::socket& socket,
|
||||||
|
* asio::mutable_buffer buffer,
|
||||||
|
* CompletionToken&& token) ->
|
||||||
|
* decltype(
|
||||||
|
* asio::async_compose<CompletionToken,
|
||||||
|
* void(asio::error_code, std::size_t)>(
|
||||||
|
* std::declval<async_echo_implementation>(),
|
||||||
|
* token, socket))
|
||||||
|
* {
|
||||||
|
* return asio::async_compose<CompletionToken,
|
||||||
|
* void(asio::error_code, std::size_t)>(
|
||||||
|
* async_echo_implementation{socket, buffer,
|
||||||
|
* async_echo_implementation::starting},
|
||||||
|
* token, socket);
|
||||||
|
* } @endcode
|
||||||
|
*/
|
||||||
|
template <typename CompletionToken, typename Signature,
|
||||||
|
typename Implementation, typename... IoObjectsOrExecutors>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(CompletionToken, Signature)
|
||||||
|
async_compose(ASIO_MOVE_ARG(Implementation) implementation,
|
||||||
|
ASIO_NONDEDUCED_MOVE_ARG(CompletionToken) token,
|
||||||
|
ASIO_MOVE_ARG(IoObjectsOrExecutors)... io_objects_or_executors)
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<CompletionToken, Signature>(
|
||||||
|
detail::make_initiate_composed_op<Signature>(
|
||||||
|
detail::make_composed_io_executors(
|
||||||
|
detail::get_composed_io_executor(
|
||||||
|
ASIO_MOVE_CAST(IoObjectsOrExecutors)(
|
||||||
|
io_objects_or_executors))...)),
|
||||||
|
token, ASIO_MOVE_CAST(Implementation)(implementation))))
|
||||||
|
{
|
||||||
|
return async_initiate<CompletionToken, Signature>(
|
||||||
|
detail::make_initiate_composed_op<Signature>(
|
||||||
|
detail::make_composed_io_executors(
|
||||||
|
detail::get_composed_io_executor(
|
||||||
|
ASIO_MOVE_CAST(IoObjectsOrExecutors)(
|
||||||
|
io_objects_or_executors))...)),
|
||||||
|
token, ASIO_MOVE_CAST(Implementation)(implementation));
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
template <typename CompletionToken, typename Signature, typename Implementation>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(CompletionToken, Signature)
|
||||||
|
async_compose(ASIO_MOVE_ARG(Implementation) implementation,
|
||||||
|
ASIO_NONDEDUCED_MOVE_ARG(CompletionToken) token)
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<CompletionToken, Signature>(
|
||||||
|
detail::make_initiate_composed_op<Signature>(
|
||||||
|
detail::make_composed_io_executors()),
|
||||||
|
token, ASIO_MOVE_CAST(Implementation)(implementation))))
|
||||||
|
{
|
||||||
|
return async_initiate<CompletionToken, Signature>(
|
||||||
|
detail::make_initiate_composed_op<Signature>(
|
||||||
|
detail::make_composed_io_executors()),
|
||||||
|
token, ASIO_MOVE_CAST(Implementation)(implementation));
|
||||||
|
}
|
||||||
|
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR(n) \
|
||||||
|
ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_##n
|
||||||
|
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_1 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_2 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_3 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T3)(x3))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_4 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T3)(x3)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T4)(x4))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_5 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T3)(x3)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T4)(x4)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T5)(x5))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_6 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T3)(x3)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T4)(x4)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T5)(x5)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T6)(x6))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_7 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T3)(x3)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T4)(x4)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T5)(x5)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T6)(x6)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T7)(x7))
|
||||||
|
# define ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_8 \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T1)(x1)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T2)(x2)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T3)(x3)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T4)(x4)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T5)(x5)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T6)(x6)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T7)(x7)), \
|
||||||
|
detail::get_composed_io_executor(ASIO_MOVE_CAST(T8)(x8))
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_ASYNC_COMPOSE_DEF(n) \
|
||||||
|
template <typename CompletionToken, typename Signature, \
|
||||||
|
typename Implementation, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(CompletionToken, Signature) \
|
||||||
|
async_compose(ASIO_MOVE_ARG(Implementation) implementation, \
|
||||||
|
ASIO_NONDEDUCED_MOVE_ARG(CompletionToken) token, \
|
||||||
|
ASIO_VARIADIC_MOVE_PARAMS(n)) \
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX(( \
|
||||||
|
async_initiate<CompletionToken, Signature>( \
|
||||||
|
detail::make_initiate_composed_op<Signature>( \
|
||||||
|
detail::make_composed_io_executors( \
|
||||||
|
ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR(n))), \
|
||||||
|
token, ASIO_MOVE_CAST(Implementation)(implementation)))) \
|
||||||
|
{ \
|
||||||
|
return async_initiate<CompletionToken, Signature>( \
|
||||||
|
detail::make_initiate_composed_op<Signature>( \
|
||||||
|
detail::make_composed_io_executors( \
|
||||||
|
ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR(n))), \
|
||||||
|
token, ASIO_MOVE_CAST(Implementation)(implementation)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_ASYNC_COMPOSE_DEF)
|
||||||
|
#undef ASIO_PRIVATE_ASYNC_COMPOSE_DEF
|
||||||
|
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_1
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_2
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_3
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_4
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_5
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_6
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_7
|
||||||
|
#undef ASIO_PRIVATE_GET_COMPOSED_IO_EXECUTOR_8
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_COMPOSE_HPP
|
1207
lib/asio-1.26.0/asio/connect.hpp
Normal file
1207
lib/asio-1.26.0/asio/connect.hpp
Normal file
File diff suppressed because it is too large
Load diff
83
lib/asio-1.26.0/asio/connect_pipe.hpp
Normal file
83
lib/asio-1.26.0/asio/connect_pipe.hpp
Normal file
|
@ -0,0 +1,83 @@
|
||||||
|
//
|
||||||
|
// connect_pipe.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_CONNECT_PIPE_HPP
|
||||||
|
#define ASIO_CONNECT_PIPE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_PIPE) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include "asio/basic_readable_pipe.hpp"
|
||||||
|
#include "asio/basic_writable_pipe.hpp"
|
||||||
|
#include "asio/error.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_IOCP)
|
||||||
|
typedef HANDLE native_pipe_handle;
|
||||||
|
#else // defined(ASIO_HAS_IOCP)
|
||||||
|
typedef int native_pipe_handle;
|
||||||
|
#endif // defined(ASIO_HAS_IOCP)
|
||||||
|
|
||||||
|
ASIO_DECL void create_pipe(native_pipe_handle p[2],
|
||||||
|
asio::error_code& ec);
|
||||||
|
|
||||||
|
ASIO_DECL void close_pipe(native_pipe_handle p);
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Connect two pipe ends using an anonymous pipe.
|
||||||
|
/**
|
||||||
|
* @param read_end The read end of the pipe.
|
||||||
|
*
|
||||||
|
* @param write_end The write end of the pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*/
|
||||||
|
template <typename Executor1, typename Executor2>
|
||||||
|
void connect_pipe(basic_readable_pipe<Executor1>& read_end,
|
||||||
|
basic_writable_pipe<Executor2>& write_end);
|
||||||
|
|
||||||
|
/// Connect two pipe ends using an anonymous pipe.
|
||||||
|
/**
|
||||||
|
* @param read_end The read end of the pipe.
|
||||||
|
*
|
||||||
|
* @param write_end The write end of the pipe.
|
||||||
|
*
|
||||||
|
* @throws asio::system_error Thrown on failure.
|
||||||
|
*
|
||||||
|
* @param ec Set to indicate what error occurred, if any.
|
||||||
|
*/
|
||||||
|
template <typename Executor1, typename Executor2>
|
||||||
|
ASIO_SYNC_OP_VOID connect_pipe(basic_readable_pipe<Executor1>& read_end,
|
||||||
|
basic_writable_pipe<Executor2>& write_end, asio::error_code& ec);
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/connect_pipe.hpp"
|
||||||
|
#if defined(ASIO_HEADER_ONLY)
|
||||||
|
# include "asio/impl/connect_pipe.ipp"
|
||||||
|
#endif // defined(ASIO_HEADER_ONLY)
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_PIPE)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_CONNECT_PIPE_HPP
|
88
lib/asio-1.26.0/asio/consign.hpp
Normal file
88
lib/asio-1.26.0/asio/consign.hpp
Normal file
|
@ -0,0 +1,88 @@
|
||||||
|
//
|
||||||
|
// consign.hpp
|
||||||
|
// ~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_CONSIGN_HPP
|
||||||
|
#define ASIO_CONSIGN_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if (defined(ASIO_HAS_STD_TUPLE) \
|
||||||
|
&& defined(ASIO_HAS_VARIADIC_TEMPLATES)) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <tuple>
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Completion token type used to specify that the completion handler should
|
||||||
|
/// carry additional values along with it.
|
||||||
|
/**
|
||||||
|
* This completion token adapter is typically used to keep at least one copy of
|
||||||
|
* an object, such as a smart pointer, alive until the completion handler is
|
||||||
|
* called.
|
||||||
|
*/
|
||||||
|
template <typename CompletionToken, typename... Values>
|
||||||
|
class consign_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Constructor.
|
||||||
|
template <typename T, typename... V>
|
||||||
|
ASIO_CONSTEXPR explicit consign_t(
|
||||||
|
ASIO_MOVE_ARG(T) completion_token,
|
||||||
|
ASIO_MOVE_ARG(V)... values)
|
||||||
|
: token_(ASIO_MOVE_CAST(T)(completion_token)),
|
||||||
|
values_(ASIO_MOVE_CAST(V)(values)...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(GENERATING_DOCUMENTATION)
|
||||||
|
private:
|
||||||
|
#endif // defined(GENERATING_DOCUMENTATION)
|
||||||
|
CompletionToken token_;
|
||||||
|
std::tuple<Values...> values_;
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Completion token adapter used to specify that the completion handler should
|
||||||
|
/// carry additional values along with it.
|
||||||
|
/**
|
||||||
|
* This completion token adapter is typically used to keep at least one copy of
|
||||||
|
* an object, such as a smart pointer, alive until the completion handler is
|
||||||
|
* called.
|
||||||
|
*/
|
||||||
|
template <typename CompletionToken, typename... Values>
|
||||||
|
ASIO_NODISCARD inline ASIO_CONSTEXPR consign_t<
|
||||||
|
typename decay<CompletionToken>::type, typename decay<Values>::type...>
|
||||||
|
consign(ASIO_MOVE_ARG(CompletionToken) completion_token,
|
||||||
|
ASIO_MOVE_ARG(Values)... values)
|
||||||
|
{
|
||||||
|
return consign_t<
|
||||||
|
typename decay<CompletionToken>::type, typename decay<Values>::type...>(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(completion_token),
|
||||||
|
ASIO_MOVE_CAST(Values)(values)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/consign.hpp"
|
||||||
|
|
||||||
|
#endif // (defined(ASIO_HAS_STD_TUPLE)
|
||||||
|
// && defined(ASIO_HAS_VARIADIC_TEMPLATES))
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_CONSIGN_HPP
|
328
lib/asio-1.26.0/asio/coroutine.hpp
Normal file
328
lib/asio-1.26.0/asio/coroutine.hpp
Normal file
|
@ -0,0 +1,328 @@
|
||||||
|
//
|
||||||
|
// coroutine.hpp
|
||||||
|
// ~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_COROUTINE_HPP
|
||||||
|
#define ASIO_COROUTINE_HPP
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class coroutine_ref;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Provides support for implementing stackless coroutines.
|
||||||
|
/**
|
||||||
|
* The @c coroutine class may be used to implement stackless coroutines. The
|
||||||
|
* class itself is used to store the current state of the coroutine.
|
||||||
|
*
|
||||||
|
* Coroutines are copy-constructible and assignable, and the space overhead is
|
||||||
|
* a single int. They can be used as a base class:
|
||||||
|
*
|
||||||
|
* @code class session : coroutine
|
||||||
|
* {
|
||||||
|
* ...
|
||||||
|
* }; @endcode
|
||||||
|
*
|
||||||
|
* or as a data member:
|
||||||
|
*
|
||||||
|
* @code class session
|
||||||
|
* {
|
||||||
|
* ...
|
||||||
|
* coroutine coro_;
|
||||||
|
* }; @endcode
|
||||||
|
*
|
||||||
|
* or even bound in as a function argument using lambdas or @c bind(). The
|
||||||
|
* important thing is that as the application maintains a copy of the object
|
||||||
|
* for as long as the coroutine must be kept alive.
|
||||||
|
*
|
||||||
|
* @par Pseudo-keywords
|
||||||
|
*
|
||||||
|
* A coroutine is used in conjunction with certain "pseudo-keywords", which
|
||||||
|
* are implemented as macros. These macros are defined by a header file:
|
||||||
|
*
|
||||||
|
* @code #include <asio/yield.hpp>@endcode
|
||||||
|
*
|
||||||
|
* and may conversely be undefined as follows:
|
||||||
|
*
|
||||||
|
* @code #include <asio/unyield.hpp>@endcode
|
||||||
|
*
|
||||||
|
* <b>reenter</b>
|
||||||
|
*
|
||||||
|
* The @c reenter macro is used to define the body of a coroutine. It takes a
|
||||||
|
* single argument: a pointer or reference to a coroutine object. For example,
|
||||||
|
* if the base class is a coroutine object you may write:
|
||||||
|
*
|
||||||
|
* @code reenter (this)
|
||||||
|
* {
|
||||||
|
* ... coroutine body ...
|
||||||
|
* } @endcode
|
||||||
|
*
|
||||||
|
* and if a data member or other variable you can write:
|
||||||
|
*
|
||||||
|
* @code reenter (coro_)
|
||||||
|
* {
|
||||||
|
* ... coroutine body ...
|
||||||
|
* } @endcode
|
||||||
|
*
|
||||||
|
* When @c reenter is executed at runtime, control jumps to the location of the
|
||||||
|
* last @c yield or @c fork.
|
||||||
|
*
|
||||||
|
* The coroutine body may also be a single statement, such as:
|
||||||
|
*
|
||||||
|
* @code reenter (this) for (;;)
|
||||||
|
* {
|
||||||
|
* ...
|
||||||
|
* } @endcode
|
||||||
|
*
|
||||||
|
* @b Limitation: The @c reenter macro is implemented using a switch. This
|
||||||
|
* means that you must take care when using local variables within the
|
||||||
|
* coroutine body. The local variable is not allowed in a position where
|
||||||
|
* reentering the coroutine could bypass the variable definition.
|
||||||
|
*
|
||||||
|
* <b>yield <em>statement</em></b>
|
||||||
|
*
|
||||||
|
* This form of the @c yield keyword is often used with asynchronous operations:
|
||||||
|
*
|
||||||
|
* @code yield socket_->async_read_some(buffer(*buffer_), *this); @endcode
|
||||||
|
*
|
||||||
|
* This divides into four logical steps:
|
||||||
|
*
|
||||||
|
* @li @c yield saves the current state of the coroutine.
|
||||||
|
* @li The statement initiates the asynchronous operation.
|
||||||
|
* @li The resume point is defined immediately following the statement.
|
||||||
|
* @li Control is transferred to the end of the coroutine body.
|
||||||
|
*
|
||||||
|
* When the asynchronous operation completes, the function object is invoked
|
||||||
|
* and @c reenter causes control to transfer to the resume point. It is
|
||||||
|
* important to remember to carry the coroutine state forward with the
|
||||||
|
* asynchronous operation. In the above snippet, the current class is a
|
||||||
|
* function object object with a coroutine object as base class or data member.
|
||||||
|
*
|
||||||
|
* The statement may also be a compound statement, and this permits us to
|
||||||
|
* define local variables with limited scope:
|
||||||
|
*
|
||||||
|
* @code yield
|
||||||
|
* {
|
||||||
|
* mutable_buffers_1 b = buffer(*buffer_);
|
||||||
|
* socket_->async_read_some(b, *this);
|
||||||
|
* } @endcode
|
||||||
|
*
|
||||||
|
* <b>yield return <em>expression</em> ;</b>
|
||||||
|
*
|
||||||
|
* This form of @c yield is often used in generators or coroutine-based parsers.
|
||||||
|
* For example, the function object:
|
||||||
|
*
|
||||||
|
* @code struct interleave : coroutine
|
||||||
|
* {
|
||||||
|
* istream& is1;
|
||||||
|
* istream& is2;
|
||||||
|
* char operator()(char c)
|
||||||
|
* {
|
||||||
|
* reenter (this) for (;;)
|
||||||
|
* {
|
||||||
|
* yield return is1.get();
|
||||||
|
* yield return is2.get();
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* }; @endcode
|
||||||
|
*
|
||||||
|
* defines a trivial coroutine that interleaves the characters from two input
|
||||||
|
* streams.
|
||||||
|
*
|
||||||
|
* This type of @c yield divides into three logical steps:
|
||||||
|
*
|
||||||
|
* @li @c yield saves the current state of the coroutine.
|
||||||
|
* @li The resume point is defined immediately following the semicolon.
|
||||||
|
* @li The value of the expression is returned from the function.
|
||||||
|
*
|
||||||
|
* <b>yield ;</b>
|
||||||
|
*
|
||||||
|
* This form of @c yield is equivalent to the following steps:
|
||||||
|
*
|
||||||
|
* @li @c yield saves the current state of the coroutine.
|
||||||
|
* @li The resume point is defined immediately following the semicolon.
|
||||||
|
* @li Control is transferred to the end of the coroutine body.
|
||||||
|
*
|
||||||
|
* This form might be applied when coroutines are used for cooperative
|
||||||
|
* threading and scheduling is explicitly managed. For example:
|
||||||
|
*
|
||||||
|
* @code struct task : coroutine
|
||||||
|
* {
|
||||||
|
* ...
|
||||||
|
* void operator()()
|
||||||
|
* {
|
||||||
|
* reenter (this)
|
||||||
|
* {
|
||||||
|
* while (... not finished ...)
|
||||||
|
* {
|
||||||
|
* ... do something ...
|
||||||
|
* yield;
|
||||||
|
* ... do some more ...
|
||||||
|
* yield;
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* }
|
||||||
|
* ...
|
||||||
|
* };
|
||||||
|
* ...
|
||||||
|
* task t1, t2;
|
||||||
|
* for (;;)
|
||||||
|
* {
|
||||||
|
* t1();
|
||||||
|
* t2();
|
||||||
|
* } @endcode
|
||||||
|
*
|
||||||
|
* <b>yield break ;</b>
|
||||||
|
*
|
||||||
|
* The final form of @c yield is used to explicitly terminate the coroutine.
|
||||||
|
* This form is comprised of two steps:
|
||||||
|
*
|
||||||
|
* @li @c yield sets the coroutine state to indicate termination.
|
||||||
|
* @li Control is transferred to the end of the coroutine body.
|
||||||
|
*
|
||||||
|
* Once terminated, calls to is_complete() return true and the coroutine cannot
|
||||||
|
* be reentered.
|
||||||
|
*
|
||||||
|
* Note that a coroutine may also be implicitly terminated if the coroutine
|
||||||
|
* body is exited without a yield, e.g. by return, throw or by running to the
|
||||||
|
* end of the body.
|
||||||
|
*
|
||||||
|
* <b>fork <em>statement</em></b>
|
||||||
|
*
|
||||||
|
* The @c fork pseudo-keyword is used when "forking" a coroutine, i.e. splitting
|
||||||
|
* it into two (or more) copies. One use of @c fork is in a server, where a new
|
||||||
|
* coroutine is created to handle each client connection:
|
||||||
|
*
|
||||||
|
* @code reenter (this)
|
||||||
|
* {
|
||||||
|
* do
|
||||||
|
* {
|
||||||
|
* socket_.reset(new tcp::socket(my_context_));
|
||||||
|
* yield acceptor->async_accept(*socket_, *this);
|
||||||
|
* fork server(*this)();
|
||||||
|
* } while (is_parent());
|
||||||
|
* ... client-specific handling follows ...
|
||||||
|
* } @endcode
|
||||||
|
*
|
||||||
|
* The logical steps involved in a @c fork are:
|
||||||
|
*
|
||||||
|
* @li @c fork saves the current state of the coroutine.
|
||||||
|
* @li The statement creates a copy of the coroutine and either executes it
|
||||||
|
* immediately or schedules it for later execution.
|
||||||
|
* @li The resume point is defined immediately following the semicolon.
|
||||||
|
* @li For the "parent", control immediately continues from the next line.
|
||||||
|
*
|
||||||
|
* The functions is_parent() and is_child() can be used to differentiate
|
||||||
|
* between parent and child. You would use these functions to alter subsequent
|
||||||
|
* control flow.
|
||||||
|
*
|
||||||
|
* Note that @c fork doesn't do the actual forking by itself. It is the
|
||||||
|
* application's responsibility to create a clone of the coroutine and call it.
|
||||||
|
* The clone can be called immediately, as above, or scheduled for delayed
|
||||||
|
* execution using something like asio::post().
|
||||||
|
*
|
||||||
|
* @par Alternate macro names
|
||||||
|
*
|
||||||
|
* If preferred, an application can use macro names that follow a more typical
|
||||||
|
* naming convention, rather than the pseudo-keywords. These are:
|
||||||
|
*
|
||||||
|
* @li @c ASIO_CORO_REENTER instead of @c reenter
|
||||||
|
* @li @c ASIO_CORO_YIELD instead of @c yield
|
||||||
|
* @li @c ASIO_CORO_FORK instead of @c fork
|
||||||
|
*/
|
||||||
|
class coroutine
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Constructs a coroutine in its initial state.
|
||||||
|
coroutine() : value_(0) {}
|
||||||
|
|
||||||
|
/// Returns true if the coroutine is the child of a fork.
|
||||||
|
bool is_child() const { return value_ < 0; }
|
||||||
|
|
||||||
|
/// Returns true if the coroutine is the parent of a fork.
|
||||||
|
bool is_parent() const { return !is_child(); }
|
||||||
|
|
||||||
|
/// Returns true if the coroutine has reached its terminal state.
|
||||||
|
bool is_complete() const { return value_ == -1; }
|
||||||
|
|
||||||
|
private:
|
||||||
|
friend class detail::coroutine_ref;
|
||||||
|
int value_;
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class coroutine_ref
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
coroutine_ref(coroutine& c) : value_(c.value_), modified_(false) {}
|
||||||
|
coroutine_ref(coroutine* c) : value_(c->value_), modified_(false) {}
|
||||||
|
~coroutine_ref() { if (!modified_) value_ = -1; }
|
||||||
|
operator int() const { return value_; }
|
||||||
|
int& operator=(int v) { modified_ = true; return value_ = v; }
|
||||||
|
private:
|
||||||
|
void operator=(const coroutine_ref&);
|
||||||
|
int& value_;
|
||||||
|
bool modified_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#define ASIO_CORO_REENTER(c) \
|
||||||
|
switch (::asio::detail::coroutine_ref _coro_value = c) \
|
||||||
|
case -1: if (_coro_value) \
|
||||||
|
{ \
|
||||||
|
goto terminate_coroutine; \
|
||||||
|
terminate_coroutine: \
|
||||||
|
_coro_value = -1; \
|
||||||
|
goto bail_out_of_coroutine; \
|
||||||
|
bail_out_of_coroutine: \
|
||||||
|
break; \
|
||||||
|
} \
|
||||||
|
else /* fall-through */ case 0:
|
||||||
|
|
||||||
|
#define ASIO_CORO_YIELD_IMPL(n) \
|
||||||
|
for (_coro_value = (n);;) \
|
||||||
|
if (_coro_value == 0) \
|
||||||
|
{ \
|
||||||
|
case (n): ; \
|
||||||
|
break; \
|
||||||
|
} \
|
||||||
|
else \
|
||||||
|
switch (_coro_value ? 0 : 1) \
|
||||||
|
for (;;) \
|
||||||
|
/* fall-through */ case -1: if (_coro_value) \
|
||||||
|
goto terminate_coroutine; \
|
||||||
|
else for (;;) \
|
||||||
|
/* fall-through */ case 1: if (_coro_value) \
|
||||||
|
goto bail_out_of_coroutine; \
|
||||||
|
else /* fall-through */ case 0:
|
||||||
|
|
||||||
|
#define ASIO_CORO_FORK_IMPL(n) \
|
||||||
|
for (_coro_value = -(n);; _coro_value = (n)) \
|
||||||
|
if (_coro_value == (n)) \
|
||||||
|
{ \
|
||||||
|
case -(n): ; \
|
||||||
|
break; \
|
||||||
|
} \
|
||||||
|
else
|
||||||
|
|
||||||
|
#if defined(_MSC_VER)
|
||||||
|
# define ASIO_CORO_YIELD ASIO_CORO_YIELD_IMPL(__COUNTER__ + 1)
|
||||||
|
# define ASIO_CORO_FORK ASIO_CORO_FORK_IMPL(__COUNTER__ + 1)
|
||||||
|
#else // defined(_MSC_VER)
|
||||||
|
# define ASIO_CORO_YIELD ASIO_CORO_YIELD_IMPL(__LINE__)
|
||||||
|
# define ASIO_CORO_FORK ASIO_CORO_FORK_IMPL(__LINE__)
|
||||||
|
#endif // defined(_MSC_VER)
|
||||||
|
|
||||||
|
#endif // ASIO_COROUTINE_HPP
|
38
lib/asio-1.26.0/asio/deadline_timer.hpp
Normal file
38
lib/asio-1.26.0/asio/deadline_timer.hpp
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
//
|
||||||
|
// deadline_timer.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DEADLINE_TIMER_HPP
|
||||||
|
#define ASIO_DEADLINE_TIMER_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_BOOST_DATE_TIME) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include "asio/detail/socket_types.hpp" // Must come before posix_time.
|
||||||
|
#include "asio/basic_deadline_timer.hpp"
|
||||||
|
|
||||||
|
#include <boost/date_time/posix_time/posix_time_types.hpp>
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Typedef for the typical usage of timer. Uses a UTC clock.
|
||||||
|
typedef basic_deadline_timer<boost::posix_time::ptime> deadline_timer;
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_DATE_TIME)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_DEADLINE_TIMER_HPP
|
215
lib/asio-1.26.0/asio/defer.hpp
Normal file
215
lib/asio-1.26.0/asio/defer.hpp
Normal file
|
@ -0,0 +1,215 @@
|
||||||
|
//
|
||||||
|
// defer.hpp
|
||||||
|
// ~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DEFER_HPP
|
||||||
|
#define ASIO_DEFER_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/execution_context.hpp"
|
||||||
|
#include "asio/execution/blocking.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
#include "asio/require.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class initiate_defer;
|
||||||
|
template <typename> class initiate_defer_with_executor;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Submits a completion token or function object for execution.
|
||||||
|
/**
|
||||||
|
* This function submits an object for execution using the object's associated
|
||||||
|
* executor. The function object is queued for execution, and is never called
|
||||||
|
* from the current thread prior to returning from <tt>defer()</tt>.
|
||||||
|
*
|
||||||
|
* The use of @c defer(), rather than @ref post(), indicates the caller's
|
||||||
|
* preference that the executor defer the queueing of the function object. This
|
||||||
|
* may allow the executor to optimise queueing for cases when the function
|
||||||
|
* object represents a continuation of the current call context.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(); @endcode
|
||||||
|
*
|
||||||
|
* @returns This function returns <tt>async_initiate<NullaryToken,
|
||||||
|
* void()>(Init{}, token)</tt>, where @c Init is a function object type defined
|
||||||
|
* as:
|
||||||
|
*
|
||||||
|
* @code class Init
|
||||||
|
* {
|
||||||
|
* public:
|
||||||
|
* template <typename CompletionHandler>
|
||||||
|
* void operator()(CompletionHandler&& completion_handler) const;
|
||||||
|
* }; @endcode
|
||||||
|
*
|
||||||
|
* The function call operator of @c Init:
|
||||||
|
*
|
||||||
|
* @li Obtains the handler's associated executor object @c ex of type @c Ex by
|
||||||
|
* performing @code auto ex = get_associated_executor(handler); @endcode
|
||||||
|
*
|
||||||
|
* @li Obtains the handler's associated allocator object @c alloc by performing
|
||||||
|
* @code auto alloc = get_associated_allocator(handler); @endcode
|
||||||
|
*
|
||||||
|
* @li If <tt>execution::is_executor<Ex>::value</tt> is true, performs
|
||||||
|
* @code prefer(
|
||||||
|
* require(ex, execution::blocking.never),
|
||||||
|
* execution::relationship.continuation,
|
||||||
|
* execution::allocator(alloc)
|
||||||
|
* ).execute(std::forward<CompletionHandler>(completion_handler)); @endcode
|
||||||
|
*
|
||||||
|
* @li If <tt>execution::is_executor<Ex>::value</tt> is false, performs
|
||||||
|
* @code ex.defer(
|
||||||
|
* std::forward<CompletionHandler>(completion_handler),
|
||||||
|
* alloc); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void() @endcode
|
||||||
|
*/
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(void()) NullaryToken>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(NullaryToken, void()) defer(
|
||||||
|
ASIO_MOVE_ARG(NullaryToken) token)
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<NullaryToken, void()>(
|
||||||
|
declval<detail::initiate_defer>(), token)));
|
||||||
|
|
||||||
|
/// Submits a completion token or function object for execution.
|
||||||
|
/**
|
||||||
|
* This function submits an object for execution using the specified executor.
|
||||||
|
* The function object is queued for execution, and is never called from the
|
||||||
|
* current thread prior to returning from <tt>defer()</tt>.
|
||||||
|
*
|
||||||
|
* The use of @c defer(), rather than @ref post(), indicates the caller's
|
||||||
|
* preference that the executor defer the queueing of the function object. This
|
||||||
|
* may allow the executor to optimise queueing for cases when the function
|
||||||
|
* object represents a continuation of the current call context.
|
||||||
|
*
|
||||||
|
* @param ex The target executor.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(); @endcode
|
||||||
|
*
|
||||||
|
* @returns This function returns <tt>async_initiate<NullaryToken,
|
||||||
|
* void()>(Init{ex}, token)</tt>, where @c Init is a function object type
|
||||||
|
* defined as:
|
||||||
|
*
|
||||||
|
* @code class Init
|
||||||
|
* {
|
||||||
|
* public:
|
||||||
|
* using executor_type = Executor;
|
||||||
|
* explicit Init(const Executor& ex) : ex_(ex) {}
|
||||||
|
* executor_type get_executor() const noexcept { return ex_; }
|
||||||
|
* template <typename CompletionHandler>
|
||||||
|
* void operator()(CompletionHandler&& completion_handler) const;
|
||||||
|
* private:
|
||||||
|
* Executor ex_; // exposition only
|
||||||
|
* }; @endcode
|
||||||
|
*
|
||||||
|
* The function call operator of @c Init:
|
||||||
|
*
|
||||||
|
* @li Obtains the handler's associated executor object @c ex1 of type @c Ex1 by
|
||||||
|
* performing @code auto ex1 = get_associated_executor(handler, ex); @endcode
|
||||||
|
*
|
||||||
|
* @li Obtains the handler's associated allocator object @c alloc by performing
|
||||||
|
* @code auto alloc = get_associated_allocator(handler); @endcode
|
||||||
|
*
|
||||||
|
* @li If <tt>execution::is_executor<Ex1>::value</tt> is true, constructs a
|
||||||
|
* function object @c f with a member @c executor_ that is initialised with
|
||||||
|
* <tt>prefer(ex1, execution::outstanding_work.tracked)</tt>, a member @c
|
||||||
|
* handler_ that is a decay-copy of @c completion_handler, and a function call
|
||||||
|
* operator that performs:
|
||||||
|
* @code auto a = get_associated_allocator(handler_);
|
||||||
|
* prefer(executor_, execution::allocator(a)).execute(std::move(handler_));
|
||||||
|
* @endcode
|
||||||
|
*
|
||||||
|
* @li If <tt>execution::is_executor<Ex1>::value</tt> is false, constructs a
|
||||||
|
* function object @c f with a member @c work_ that is initialised with
|
||||||
|
* <tt>make_work_guard(ex1)</tt>, a member @c handler_ that is a decay-copy of
|
||||||
|
* @c completion_handler, and a function call operator that performs:
|
||||||
|
* @code auto a = get_associated_allocator(handler_);
|
||||||
|
* work_.get_executor().dispatch(std::move(handler_), a);
|
||||||
|
* work_.reset(); @endcode
|
||||||
|
*
|
||||||
|
* @li If <tt>execution::is_executor<Ex>::value</tt> is true, performs
|
||||||
|
* @code prefer(
|
||||||
|
* require(ex, execution::blocking.never),
|
||||||
|
* execution::relationship.continuation,
|
||||||
|
* execution::allocator(alloc)
|
||||||
|
* ).execute(std::move(f)); @endcode
|
||||||
|
*
|
||||||
|
* @li If <tt>execution::is_executor<Ex>::value</tt> is false, performs
|
||||||
|
* @code ex.defer(std::move(f), alloc); @endcode
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void() @endcode
|
||||||
|
*/
|
||||||
|
template <typename Executor,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void()) NullaryToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(Executor)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(NullaryToken, void()) defer(
|
||||||
|
const Executor& ex,
|
||||||
|
ASIO_MOVE_ARG(NullaryToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(Executor),
|
||||||
|
typename constraint<
|
||||||
|
(execution::is_executor<Executor>::value
|
||||||
|
&& can_require<Executor, execution::blocking_t::never_t>::value)
|
||||||
|
|| is_executor<Executor>::value
|
||||||
|
>::type = 0)
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<NullaryToken, void()>(
|
||||||
|
declval<detail::initiate_defer_with_executor<Executor> >(), token)));
|
||||||
|
|
||||||
|
/// Submits a completion token or function object for execution.
|
||||||
|
/**
|
||||||
|
* @param ctx An execution context, from which the target executor is obtained.
|
||||||
|
*
|
||||||
|
* @param token The @ref completion_token that will be used to produce a
|
||||||
|
* completion handler. The function signature of the completion handler must be:
|
||||||
|
* @code void handler(); @endcode
|
||||||
|
*
|
||||||
|
* @returns <tt>defer(ctx.get_executor(), forward<NullaryToken>(token))</tt>.
|
||||||
|
*
|
||||||
|
* @par Completion Signature
|
||||||
|
* @code void() @endcode
|
||||||
|
*/
|
||||||
|
template <typename ExecutionContext,
|
||||||
|
ASIO_COMPLETION_TOKEN_FOR(void()) NullaryToken
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(
|
||||||
|
typename ExecutionContext::executor_type)>
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(NullaryToken, void()) defer(
|
||||||
|
ExecutionContext& ctx,
|
||||||
|
ASIO_MOVE_ARG(NullaryToken) token
|
||||||
|
ASIO_DEFAULT_COMPLETION_TOKEN(
|
||||||
|
typename ExecutionContext::executor_type),
|
||||||
|
typename constraint<is_convertible<
|
||||||
|
ExecutionContext&, execution_context&>::value>::type = 0)
|
||||||
|
ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX((
|
||||||
|
async_initiate<NullaryToken, void()>(
|
||||||
|
declval<detail::initiate_defer_with_executor<
|
||||||
|
typename ExecutionContext::executor_type> >(), token)));
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/defer.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DEFER_HPP
|
675
lib/asio-1.26.0/asio/deferred.hpp
Normal file
675
lib/asio-1.26.0/asio/deferred.hpp
Normal file
|
@ -0,0 +1,675 @@
|
||||||
|
//
|
||||||
|
// deferred.hpp
|
||||||
|
// ~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DEFERRED_HPP
|
||||||
|
#define ASIO_DEFERRED_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if (defined(ASIO_HAS_STD_TUPLE) \
|
||||||
|
&& defined(ASIO_HAS_DECLTYPE) \
|
||||||
|
&& defined(ASIO_HAS_VARIADIC_TEMPLATES)) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#include <tuple>
|
||||||
|
#include "asio/associator.hpp"
|
||||||
|
#include "asio/async_result.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/utility.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// Trait for detecting objects that are usable as deferred operations.
|
||||||
|
template <typename T>
|
||||||
|
struct is_deferred : false_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper trait for getting the completion signature of the tail in a sequence
|
||||||
|
// when invoked with the specified arguments.
|
||||||
|
|
||||||
|
template <typename HeadSignature, typename Tail>
|
||||||
|
struct deferred_sequence_signature;
|
||||||
|
|
||||||
|
template <typename R, typename... Args, typename Tail>
|
||||||
|
struct deferred_sequence_signature<R(Args...), Tail>
|
||||||
|
{
|
||||||
|
static_assert(
|
||||||
|
!is_same<decltype(declval<Tail>()(declval<Args>()...)), void>::value,
|
||||||
|
"deferred functions must produce a deferred return type");
|
||||||
|
|
||||||
|
typedef typename completion_signature_of<
|
||||||
|
decltype(declval<Tail>()(declval<Args>()...))>::type type;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Completion handler for the head component of a deferred sequence.
|
||||||
|
template <typename Handler, typename Tail>
|
||||||
|
class deferred_sequence_handler
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
template <typename H, typename T>
|
||||||
|
explicit deferred_sequence_handler(
|
||||||
|
ASIO_MOVE_ARG(H) handler, ASIO_MOVE_ARG(T) tail)
|
||||||
|
: handler_(ASIO_MOVE_CAST(H)(handler)),
|
||||||
|
tail_(ASIO_MOVE_CAST(T)(tail))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename... Args>
|
||||||
|
void operator()(ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_OR_LVALUE(Tail)(tail_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...)(
|
||||||
|
ASIO_MOVE_OR_LVALUE(Handler)(handler_));
|
||||||
|
}
|
||||||
|
|
||||||
|
//private:
|
||||||
|
Handler handler_;
|
||||||
|
Tail tail_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
|
||||||
|
/// Used to represent an empty deferred action.
|
||||||
|
struct deferred_noop
|
||||||
|
{
|
||||||
|
/// No effect.
|
||||||
|
template <typename... Args>
|
||||||
|
void operator()(ASIO_MOVE_ARG(Args)...) ASIO_RVALUE_REF_QUAL
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
/// No effect.
|
||||||
|
template <typename... Args>
|
||||||
|
void operator()(ASIO_MOVE_ARG(Args)...) const &
|
||||||
|
{
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <>
|
||||||
|
struct is_deferred<deferred_noop> : true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Tag type to disambiguate deferred constructors.
|
||||||
|
struct deferred_init_tag {};
|
||||||
|
|
||||||
|
/// Wraps a function object so that it may be used as an element in a deferred
|
||||||
|
/// composition.
|
||||||
|
template <typename Function>
|
||||||
|
class deferred_function
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Constructor.
|
||||||
|
template <typename F>
|
||||||
|
ASIO_CONSTEXPR explicit deferred_function(
|
||||||
|
deferred_init_tag, ASIO_MOVE_ARG(F) function)
|
||||||
|
: function_(ASIO_MOVE_CAST(F)(function))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
//private:
|
||||||
|
Function function_;
|
||||||
|
|
||||||
|
public:
|
||||||
|
template <typename... Args>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args) ASIO_RVALUE_REF_QUAL
|
||||||
|
-> decltype(
|
||||||
|
ASIO_MOVE_CAST(Function)(this->function_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...))
|
||||||
|
{
|
||||||
|
return ASIO_MOVE_CAST(Function)(function_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <typename... Args>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(Args)... args) const &
|
||||||
|
-> decltype(Function(function_)(ASIO_MOVE_CAST(Args)(args)...))
|
||||||
|
{
|
||||||
|
return Function(function_)(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Function>
|
||||||
|
struct is_deferred<deferred_function<Function> > : true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Encapsulates deferred values.
|
||||||
|
template <typename... Values>
|
||||||
|
class ASIO_NODISCARD deferred_values
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
std::tuple<Values...> values_;
|
||||||
|
|
||||||
|
struct initiate
|
||||||
|
{
|
||||||
|
template <typename Handler, typename... V>
|
||||||
|
void operator()(Handler handler, ASIO_MOVE_ARG(V)... values)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_OR_LVALUE(Handler)(handler)(
|
||||||
|
ASIO_MOVE_CAST(V)(values)...);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename CompletionToken, std::size_t... I>
|
||||||
|
auto invoke_helper(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token,
|
||||||
|
detail::index_sequence<I...>)
|
||||||
|
-> decltype(
|
||||||
|
asio::async_initiate<CompletionToken, void(Values...)>(
|
||||||
|
initiate(), token,
|
||||||
|
std::get<I>(
|
||||||
|
ASIO_MOVE_CAST(std::tuple<Values...>)(this->values_))...))
|
||||||
|
{
|
||||||
|
return asio::async_initiate<CompletionToken, void(Values...)>(
|
||||||
|
initiate(), token,
|
||||||
|
std::get<I>(ASIO_MOVE_CAST(std::tuple<Values...>)(values_))...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <typename CompletionToken, std::size_t... I>
|
||||||
|
auto const_invoke_helper(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token,
|
||||||
|
detail::index_sequence<I...>)
|
||||||
|
-> decltype(
|
||||||
|
asio::async_initiate<CompletionToken, void(Values...)>(
|
||||||
|
initiate(), token, std::get<I>(values_)...))
|
||||||
|
{
|
||||||
|
return asio::async_initiate<CompletionToken, void(Values...)>(
|
||||||
|
initiate(), token, std::get<I>(values_)...);
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// Construct a deferred asynchronous operation from the arguments to an
|
||||||
|
/// initiation function object.
|
||||||
|
template <typename... V>
|
||||||
|
ASIO_CONSTEXPR explicit deferred_values(
|
||||||
|
deferred_init_tag, ASIO_MOVE_ARG(V)... values)
|
||||||
|
: values_(ASIO_MOVE_CAST(V)(values)...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Initiate the deferred operation using the supplied completion token.
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(void(Values...)) CompletionToken>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token) ASIO_RVALUE_REF_QUAL
|
||||||
|
-> decltype(
|
||||||
|
this->invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<Values...>()))
|
||||||
|
{
|
||||||
|
return this->invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<Values...>());
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(void(Values...)) CompletionToken>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token) const &
|
||||||
|
-> decltype(
|
||||||
|
this->const_invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<Values...>()))
|
||||||
|
{
|
||||||
|
return this->const_invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<Values...>());
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename... Values>
|
||||||
|
struct is_deferred<deferred_values<Values...> > : true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Encapsulates a deferred asynchronous operation.
|
||||||
|
template <typename Signature, typename Initiation, typename... InitArgs>
|
||||||
|
class ASIO_NODISCARD deferred_async_operation
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
typedef typename decay<Initiation>::type initiation_t;
|
||||||
|
initiation_t initiation_;
|
||||||
|
typedef std::tuple<typename decay<InitArgs>::type...> init_args_t;
|
||||||
|
init_args_t init_args_;
|
||||||
|
|
||||||
|
template <typename CompletionToken, std::size_t... I>
|
||||||
|
auto invoke_helper(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token,
|
||||||
|
detail::index_sequence<I...>)
|
||||||
|
-> decltype(
|
||||||
|
asio::async_initiate<CompletionToken, Signature>(
|
||||||
|
ASIO_MOVE_CAST(initiation_t)(initiation_), token,
|
||||||
|
std::get<I>(ASIO_MOVE_CAST(init_args_t)(init_args_))...))
|
||||||
|
{
|
||||||
|
return asio::async_initiate<CompletionToken, Signature>(
|
||||||
|
ASIO_MOVE_CAST(initiation_t)(initiation_), token,
|
||||||
|
std::get<I>(ASIO_MOVE_CAST(init_args_t)(init_args_))...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <typename CompletionToken, std::size_t... I>
|
||||||
|
auto const_invoke_helper(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token,
|
||||||
|
detail::index_sequence<I...>) const &
|
||||||
|
-> decltype(
|
||||||
|
asio::async_initiate<CompletionToken, Signature>(
|
||||||
|
initiation_t(initiation_), token, std::get<I>(init_args_)...))
|
||||||
|
{
|
||||||
|
return asio::async_initiate<CompletionToken, Signature>(
|
||||||
|
initiation_t(initiation_), token, std::get<I>(init_args_)...);
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// Construct a deferred asynchronous operation from the arguments to an
|
||||||
|
/// initiation function object.
|
||||||
|
template <typename I, typename... A>
|
||||||
|
ASIO_CONSTEXPR explicit deferred_async_operation(
|
||||||
|
deferred_init_tag, ASIO_MOVE_ARG(I) initiation,
|
||||||
|
ASIO_MOVE_ARG(A)... init_args)
|
||||||
|
: initiation_(ASIO_MOVE_CAST(I)(initiation)),
|
||||||
|
init_args_(ASIO_MOVE_CAST(A)(init_args)...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Initiate the asynchronous operation using the supplied completion token.
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(Signature) CompletionToken>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token) ASIO_RVALUE_REF_QUAL
|
||||||
|
-> decltype(
|
||||||
|
this->invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<InitArgs...>()))
|
||||||
|
{
|
||||||
|
return this->invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<InitArgs...>());
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(Signature) CompletionToken>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token) const &
|
||||||
|
-> decltype(
|
||||||
|
this->const_invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<InitArgs...>()))
|
||||||
|
{
|
||||||
|
return this->const_invoke_helper(
|
||||||
|
ASIO_MOVE_CAST(CompletionToken)(token),
|
||||||
|
detail::index_sequence_for<InitArgs...>());
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Signature, typename Initiation, typename... InitArgs>
|
||||||
|
struct is_deferred<
|
||||||
|
deferred_async_operation<Signature, Initiation, InitArgs...> > : true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Defines a link between two consecutive operations in a sequence.
|
||||||
|
template <typename Head, typename Tail>
|
||||||
|
class ASIO_NODISCARD deferred_sequence
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
typedef typename detail::deferred_sequence_signature<
|
||||||
|
typename completion_signature_of<Head>::type, Tail>::type
|
||||||
|
signature;
|
||||||
|
|
||||||
|
struct initiate
|
||||||
|
{
|
||||||
|
template <typename Handler>
|
||||||
|
void operator()(ASIO_MOVE_ARG(Handler) handler,
|
||||||
|
Head head, ASIO_MOVE_ARG(Tail) tail)
|
||||||
|
{
|
||||||
|
ASIO_MOVE_OR_LVALUE(Head)(head)(
|
||||||
|
detail::deferred_sequence_handler<
|
||||||
|
typename decay<Handler>::type,
|
||||||
|
typename decay<Tail>::type>(
|
||||||
|
ASIO_MOVE_CAST(Handler)(handler),
|
||||||
|
ASIO_MOVE_CAST(Tail)(tail)));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
Head head_;
|
||||||
|
Tail tail_;
|
||||||
|
|
||||||
|
public:
|
||||||
|
template <typename H, typename T>
|
||||||
|
ASIO_CONSTEXPR explicit deferred_sequence(deferred_init_tag,
|
||||||
|
ASIO_MOVE_ARG(H) head, ASIO_MOVE_ARG(T) tail)
|
||||||
|
: head_(ASIO_MOVE_CAST(H)(head)),
|
||||||
|
tail_(ASIO_MOVE_CAST(T)(tail))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(signature) CompletionToken>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token) ASIO_RVALUE_REF_QUAL
|
||||||
|
-> decltype(
|
||||||
|
asio::async_initiate<CompletionToken, signature>(
|
||||||
|
declval<initiate>(), token,
|
||||||
|
ASIO_MOVE_OR_LVALUE(Head)(this->head_),
|
||||||
|
ASIO_MOVE_OR_LVALUE(Tail)(this->tail_)))
|
||||||
|
{
|
||||||
|
return asio::async_initiate<CompletionToken, signature>(
|
||||||
|
initiate(), token,
|
||||||
|
ASIO_MOVE_OR_LVALUE(Head)(head_),
|
||||||
|
ASIO_MOVE_OR_LVALUE(Tail)(tail_));
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <ASIO_COMPLETION_TOKEN_FOR(signature) CompletionToken>
|
||||||
|
auto operator()(
|
||||||
|
ASIO_MOVE_ARG(CompletionToken) token) const &
|
||||||
|
-> decltype(
|
||||||
|
asio::async_initiate<CompletionToken, signature>(
|
||||||
|
initiate(), token, head_, tail_))
|
||||||
|
{
|
||||||
|
return asio::async_initiate<CompletionToken, signature>(
|
||||||
|
initiate(), token, head_, tail_);
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename Head, typename Tail>
|
||||||
|
struct is_deferred<deferred_sequence<Head, Tail> > : true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Used to represent a deferred conditional branch.
|
||||||
|
template <typename OnTrue = deferred_noop,
|
||||||
|
typename OnFalse = deferred_noop>
|
||||||
|
class ASIO_NODISCARD deferred_conditional
|
||||||
|
{
|
||||||
|
private:
|
||||||
|
template <typename T, typename F> friend class deferred_conditional;
|
||||||
|
|
||||||
|
// Helper constructor.
|
||||||
|
template <typename T, typename F>
|
||||||
|
explicit deferred_conditional(bool b, ASIO_MOVE_ARG(T) on_true,
|
||||||
|
ASIO_MOVE_ARG(F) on_false)
|
||||||
|
: on_true_(ASIO_MOVE_CAST(T)(on_true)),
|
||||||
|
on_false_(ASIO_MOVE_CAST(F)(on_false)),
|
||||||
|
bool_(b)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
OnTrue on_true_;
|
||||||
|
OnFalse on_false_;
|
||||||
|
bool bool_;
|
||||||
|
|
||||||
|
public:
|
||||||
|
/// Construct a deferred conditional with the value to determine which branch
|
||||||
|
/// will be executed.
|
||||||
|
ASIO_CONSTEXPR explicit deferred_conditional(bool b)
|
||||||
|
: on_true_(),
|
||||||
|
on_false_(),
|
||||||
|
bool_(b)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Invoke the conditional branch bsaed on the stored alue.
|
||||||
|
template <typename... Args>
|
||||||
|
auto operator()(ASIO_MOVE_ARG(Args)... args) ASIO_RVALUE_REF_QUAL
|
||||||
|
-> decltype(
|
||||||
|
ASIO_MOVE_OR_LVALUE(OnTrue)(on_true_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...))
|
||||||
|
{
|
||||||
|
if (bool_)
|
||||||
|
{
|
||||||
|
return ASIO_MOVE_OR_LVALUE(OnTrue)(on_true_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return ASIO_MOVE_OR_LVALUE(OnFalse)(on_false_)(
|
||||||
|
ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
template <typename... Args>
|
||||||
|
auto operator()(ASIO_MOVE_ARG(Args)... args) const &
|
||||||
|
-> decltype(on_true_(ASIO_MOVE_CAST(Args)(args)...))
|
||||||
|
{
|
||||||
|
if (bool_)
|
||||||
|
{
|
||||||
|
return on_true_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return on_false_(ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_HAS_REF_QUALIFIED_FUNCTIONS)
|
||||||
|
|
||||||
|
/// Set the true branch of the conditional.
|
||||||
|
template <typename T>
|
||||||
|
deferred_conditional<T, OnFalse> then(T on_true,
|
||||||
|
typename constraint<
|
||||||
|
is_deferred<T>::value
|
||||||
|
>::type* = 0,
|
||||||
|
typename constraint<
|
||||||
|
is_same<
|
||||||
|
typename conditional<true, OnTrue, T>::type,
|
||||||
|
deferred_noop
|
||||||
|
>::value
|
||||||
|
>::type* = 0) ASIO_RVALUE_REF_QUAL
|
||||||
|
{
|
||||||
|
return deferred_conditional<T, OnFalse>(
|
||||||
|
bool_, ASIO_MOVE_CAST(T)(on_true),
|
||||||
|
ASIO_MOVE_CAST(OnFalse)(on_false_));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Set the false branch of the conditional.
|
||||||
|
template <typename T>
|
||||||
|
deferred_conditional<OnTrue, T> otherwise(T on_false,
|
||||||
|
typename constraint<
|
||||||
|
is_deferred<T>::value
|
||||||
|
>::type* = 0,
|
||||||
|
typename constraint<
|
||||||
|
!is_same<
|
||||||
|
typename conditional<true, OnTrue, T>::type,
|
||||||
|
deferred_noop
|
||||||
|
>::value
|
||||||
|
>::type* = 0,
|
||||||
|
typename constraint<
|
||||||
|
is_same<
|
||||||
|
typename conditional<true, OnFalse, T>::type,
|
||||||
|
deferred_noop
|
||||||
|
>::value
|
||||||
|
>::type* = 0) ASIO_RVALUE_REF_QUAL
|
||||||
|
{
|
||||||
|
return deferred_conditional<OnTrue, T>(
|
||||||
|
bool_, ASIO_MOVE_CAST(OnTrue)(on_true_),
|
||||||
|
ASIO_MOVE_CAST(T)(on_false));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename OnTrue, typename OnFalse>
|
||||||
|
struct is_deferred<deferred_conditional<OnTrue, OnFalse> > : true_type
|
||||||
|
{
|
||||||
|
};
|
||||||
|
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Class used to specify that an asynchronous operation should return a
|
||||||
|
/// function object to lazily launch the operation.
|
||||||
|
/**
|
||||||
|
* The deferred_t class is used to indicate that an asynchronous operation
|
||||||
|
* should return a function object which is itself an initiation function. A
|
||||||
|
* deferred_t object may be passed as a completion token to an asynchronous
|
||||||
|
* operation, typically using the special value @c asio::deferred. For
|
||||||
|
* example:
|
||||||
|
*
|
||||||
|
* @code auto my_deferred_op
|
||||||
|
* = my_socket.async_read_some(my_buffer,
|
||||||
|
* asio::deferred); @endcode
|
||||||
|
*
|
||||||
|
* The initiating function (async_read_some in the above example) returns a
|
||||||
|
* function object that will lazily initiate the operation.
|
||||||
|
*/
|
||||||
|
class deferred_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Default constructor.
|
||||||
|
ASIO_CONSTEXPR deferred_t()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Adapts an executor to add the @c deferred_t completion token as the
|
||||||
|
/// default.
|
||||||
|
template <typename InnerExecutor>
|
||||||
|
struct executor_with_default : InnerExecutor
|
||||||
|
{
|
||||||
|
/// Specify @c deferred_t as the default completion token type.
|
||||||
|
typedef deferred_t default_completion_token_type;
|
||||||
|
|
||||||
|
/// Construct the adapted executor from the inner executor type.
|
||||||
|
template <typename InnerExecutor1>
|
||||||
|
executor_with_default(const InnerExecutor1& ex,
|
||||||
|
typename constraint<
|
||||||
|
conditional<
|
||||||
|
!is_same<InnerExecutor1, executor_with_default>::value,
|
||||||
|
is_convertible<InnerExecutor1, InnerExecutor>,
|
||||||
|
false_type
|
||||||
|
>::type::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: InnerExecutor(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Type alias to adapt an I/O object to use @c deferred_t as its
|
||||||
|
/// default completion token type.
|
||||||
|
#if defined(ASIO_HAS_ALIAS_TEMPLATES) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename T>
|
||||||
|
using as_default_on_t = typename T::template rebind_executor<
|
||||||
|
executor_with_default<typename T::executor_type> >::other;
|
||||||
|
#endif // defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Function helper to adapt an I/O object to use @c deferred_t as its
|
||||||
|
/// default completion token type.
|
||||||
|
template <typename T>
|
||||||
|
static typename decay<T>::type::template rebind_executor<
|
||||||
|
executor_with_default<typename decay<T>::type::executor_type>
|
||||||
|
>::other
|
||||||
|
as_default_on(ASIO_MOVE_ARG(T) object)
|
||||||
|
{
|
||||||
|
return typename decay<T>::type::template rebind_executor<
|
||||||
|
executor_with_default<typename decay<T>::type::executor_type>
|
||||||
|
>::other(ASIO_MOVE_CAST(T)(object));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Creates a new deferred from a function.
|
||||||
|
template <typename Function>
|
||||||
|
typename constraint<
|
||||||
|
!is_deferred<typename decay<Function>::type>::value,
|
||||||
|
deferred_function<typename decay<Function>::type>
|
||||||
|
>::type operator()(ASIO_MOVE_ARG(Function) function) const
|
||||||
|
{
|
||||||
|
return deferred_function<typename decay<Function>::type>(
|
||||||
|
deferred_init_tag{}, ASIO_MOVE_CAST(Function)(function));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Passes through anything that is already deferred.
|
||||||
|
template <typename T>
|
||||||
|
typename constraint<
|
||||||
|
is_deferred<typename decay<T>::type>::value,
|
||||||
|
typename decay<T>::type
|
||||||
|
>::type operator()(ASIO_MOVE_ARG(T) t) const
|
||||||
|
{
|
||||||
|
return ASIO_MOVE_CAST(T)(t);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Returns a deferred operation that returns the provided values.
|
||||||
|
template <typename... Args>
|
||||||
|
static ASIO_CONSTEXPR deferred_values<typename decay<Args>::type...>
|
||||||
|
values(ASIO_MOVE_ARG(Args)... args)
|
||||||
|
{
|
||||||
|
return deferred_values<typename decay<Args>::type...>(
|
||||||
|
deferred_init_tag{}, ASIO_MOVE_CAST(Args)(args)...);
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Creates a conditional object for branching deferred operations.
|
||||||
|
static ASIO_CONSTEXPR deferred_conditional<> when(bool b)
|
||||||
|
{
|
||||||
|
return deferred_conditional<>(b);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Pipe operator used to chain deferred operations.
|
||||||
|
template <typename Head, typename Tail>
|
||||||
|
inline auto operator|(Head head, ASIO_MOVE_ARG(Tail) tail)
|
||||||
|
-> typename constraint<
|
||||||
|
is_deferred<Head>::value,
|
||||||
|
decltype(ASIO_MOVE_OR_LVALUE(Head)(head)(
|
||||||
|
ASIO_MOVE_CAST(Tail)(tail)))
|
||||||
|
>::type
|
||||||
|
{
|
||||||
|
return ASIO_MOVE_OR_LVALUE(Head)(head)(
|
||||||
|
ASIO_MOVE_CAST(Tail)(tail));
|
||||||
|
}
|
||||||
|
|
||||||
|
/// A @ref completion_token object used to specify that an asynchronous
|
||||||
|
/// operation should return a function object to lazily launch the operation.
|
||||||
|
/**
|
||||||
|
* See the documentation for asio::deferred_t for a usage example.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_HAS_CONSTEXPR) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
constexpr deferred_t deferred;
|
||||||
|
#elif defined(ASIO_MSVC)
|
||||||
|
__declspec(selectany) deferred_t deferred;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/deferred.hpp"
|
||||||
|
|
||||||
|
#endif // (defined(ASIO_HAS_STD_TUPLE)
|
||||||
|
// && defined(ASIO_HAS_DECLTYPE))
|
||||||
|
// && defined(ASIO_HAS_VARIADIC_TEMPLATES))
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
#endif // ASIO_DEFERRED_HPP
|
113
lib/asio-1.26.0/asio/detached.hpp
Normal file
113
lib/asio-1.26.0/asio/detached.hpp
Normal file
|
@ -0,0 +1,113 @@
|
||||||
|
//
|
||||||
|
// detached.hpp
|
||||||
|
// ~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETACHED_HPP
|
||||||
|
#define ASIO_DETACHED_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <memory>
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
|
||||||
|
/// A @ref completion_token type used to specify that an asynchronous operation
|
||||||
|
/// is detached.
|
||||||
|
/**
|
||||||
|
* The detached_t class is used to indicate that an asynchronous operation is
|
||||||
|
* detached. That is, there is no completion handler waiting for the
|
||||||
|
* operation's result. A detached_t object may be passed as a handler to an
|
||||||
|
* asynchronous operation, typically using the special value
|
||||||
|
* @c asio::detached. For example:
|
||||||
|
*
|
||||||
|
* @code my_socket.async_send(my_buffer, asio::detached);
|
||||||
|
* @endcode
|
||||||
|
*/
|
||||||
|
class detached_t
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
/// Constructor.
|
||||||
|
ASIO_CONSTEXPR detached_t()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Adapts an executor to add the @c detached_t completion token as the
|
||||||
|
/// default.
|
||||||
|
template <typename InnerExecutor>
|
||||||
|
struct executor_with_default : InnerExecutor
|
||||||
|
{
|
||||||
|
/// Specify @c detached_t as the default completion token type.
|
||||||
|
typedef detached_t default_completion_token_type;
|
||||||
|
|
||||||
|
/// Construct the adapted executor from the inner executor type.
|
||||||
|
executor_with_default(const InnerExecutor& ex) ASIO_NOEXCEPT
|
||||||
|
: InnerExecutor(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Convert the specified executor to the inner executor type, then use
|
||||||
|
/// that to construct the adapted executor.
|
||||||
|
template <typename OtherExecutor>
|
||||||
|
executor_with_default(const OtherExecutor& ex,
|
||||||
|
typename constraint<
|
||||||
|
is_convertible<OtherExecutor, InnerExecutor>::value
|
||||||
|
>::type = 0) ASIO_NOEXCEPT
|
||||||
|
: InnerExecutor(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// Type alias to adapt an I/O object to use @c detached_t as its
|
||||||
|
/// default completion token type.
|
||||||
|
#if defined(ASIO_HAS_ALIAS_TEMPLATES) \
|
||||||
|
|| defined(GENERATING_DOCUMENTATION)
|
||||||
|
template <typename T>
|
||||||
|
using as_default_on_t = typename T::template rebind_executor<
|
||||||
|
executor_with_default<typename T::executor_type> >::other;
|
||||||
|
#endif // defined(ASIO_HAS_ALIAS_TEMPLATES)
|
||||||
|
// || defined(GENERATING_DOCUMENTATION)
|
||||||
|
|
||||||
|
/// Function helper to adapt an I/O object to use @c detached_t as its
|
||||||
|
/// default completion token type.
|
||||||
|
template <typename T>
|
||||||
|
static typename decay<T>::type::template rebind_executor<
|
||||||
|
executor_with_default<typename decay<T>::type::executor_type>
|
||||||
|
>::other
|
||||||
|
as_default_on(ASIO_MOVE_ARG(T) object)
|
||||||
|
{
|
||||||
|
return typename decay<T>::type::template rebind_executor<
|
||||||
|
executor_with_default<typename decay<T>::type::executor_type>
|
||||||
|
>::other(ASIO_MOVE_CAST(T)(object));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
/// A @ref completion_token object used to specify that an asynchronous
|
||||||
|
/// operation is detached.
|
||||||
|
/**
|
||||||
|
* See the documentation for asio::detached_t for a usage example.
|
||||||
|
*/
|
||||||
|
#if defined(ASIO_HAS_CONSTEXPR) || defined(GENERATING_DOCUMENTATION)
|
||||||
|
constexpr detached_t detached;
|
||||||
|
#elif defined(ASIO_MSVC)
|
||||||
|
__declspec(selectany) detached_t detached;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#include "asio/impl/detached.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETACHED_HPP
|
38
lib/asio-1.26.0/asio/detail/array.hpp
Normal file
38
lib/asio-1.26.0/asio/detail/array.hpp
Normal file
|
@ -0,0 +1,38 @@
|
||||||
|
//
|
||||||
|
// detail/array.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_ARRAY_HPP
|
||||||
|
#define ASIO_DETAIL_ARRAY_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
# include <array>
|
||||||
|
#else // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
# include <boost/array.hpp>
|
||||||
|
#endif // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
using std::array;
|
||||||
|
#else // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
using boost::array;
|
||||||
|
#endif // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_ARRAY_HPP
|
34
lib/asio-1.26.0/asio/detail/array_fwd.hpp
Normal file
34
lib/asio-1.26.0/asio/detail/array_fwd.hpp
Normal file
|
@ -0,0 +1,34 @@
|
||||||
|
//
|
||||||
|
// detail/array_fwd.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_ARRAY_FWD_HPP
|
||||||
|
#define ASIO_DETAIL_ARRAY_FWD_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
namespace boost {
|
||||||
|
|
||||||
|
template<class T, std::size_t N>
|
||||||
|
class array;
|
||||||
|
|
||||||
|
} // namespace boost
|
||||||
|
|
||||||
|
// Standard library components can't be forward declared, so we'll have to
|
||||||
|
// include the array header. Fortunately, it's fairly lightweight and doesn't
|
||||||
|
// add significantly to the compile time.
|
||||||
|
#if defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
# include <array>
|
||||||
|
#endif // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_ARRAY_FWD_HPP
|
32
lib/asio-1.26.0/asio/detail/assert.hpp
Normal file
32
lib/asio-1.26.0/asio/detail/assert.hpp
Normal file
|
@ -0,0 +1,32 @@
|
||||||
|
//
|
||||||
|
// detail/assert.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_ASSERT_HPP
|
||||||
|
#define ASIO_DETAIL_ASSERT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_BOOST_ASSERT)
|
||||||
|
# include <boost/assert.hpp>
|
||||||
|
#else // defined(ASIO_HAS_BOOST_ASSERT)
|
||||||
|
# include <cassert>
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_ASSERT)
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_BOOST_ASSERT)
|
||||||
|
# define ASIO_ASSERT(expr) BOOST_ASSERT(expr)
|
||||||
|
#else // defined(ASIO_HAS_BOOST_ASSERT)
|
||||||
|
# define ASIO_ASSERT(expr) assert(expr)
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_ASSERT)
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_ASSERT_HPP
|
67
lib/asio-1.26.0/asio/detail/atomic_count.hpp
Normal file
67
lib/asio-1.26.0/asio/detail/atomic_count.hpp
Normal file
|
@ -0,0 +1,67 @@
|
||||||
|
//
|
||||||
|
// detail/atomic_count.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_ATOMIC_COUNT_HPP
|
||||||
|
#define ASIO_DETAIL_ATOMIC_COUNT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_THREADS)
|
||||||
|
// Nothing to include.
|
||||||
|
#elif defined(ASIO_HAS_STD_ATOMIC)
|
||||||
|
# include <atomic>
|
||||||
|
#else // defined(ASIO_HAS_STD_ATOMIC)
|
||||||
|
# include <boost/detail/atomic_count.hpp>
|
||||||
|
#endif // defined(ASIO_HAS_STD_ATOMIC)
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
#if !defined(ASIO_HAS_THREADS)
|
||||||
|
typedef long atomic_count;
|
||||||
|
inline void increment(atomic_count& a, long b) { a += b; }
|
||||||
|
inline void decrement(atomic_count& a, long b) { a -= b; }
|
||||||
|
inline void ref_count_up(atomic_count& a) { ++a; }
|
||||||
|
inline bool ref_count_down(atomic_count& a) { return --a == 0; }
|
||||||
|
#elif defined(ASIO_HAS_STD_ATOMIC)
|
||||||
|
typedef std::atomic<long> atomic_count;
|
||||||
|
inline void increment(atomic_count& a, long b) { a += b; }
|
||||||
|
inline void decrement(atomic_count& a, long b) { a -= b; }
|
||||||
|
|
||||||
|
inline void ref_count_up(atomic_count& a)
|
||||||
|
{
|
||||||
|
a.fetch_add(1, std::memory_order_relaxed);
|
||||||
|
}
|
||||||
|
|
||||||
|
inline bool ref_count_down(atomic_count& a)
|
||||||
|
{
|
||||||
|
if (a.fetch_sub(1, std::memory_order_release) == 1)
|
||||||
|
{
|
||||||
|
std::atomic_thread_fence(std::memory_order_acquire);
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
#else // defined(ASIO_HAS_STD_ATOMIC)
|
||||||
|
typedef boost::detail::atomic_count atomic_count;
|
||||||
|
inline void increment(atomic_count& a, long b) { while (b > 0) ++a, --b; }
|
||||||
|
inline void decrement(atomic_count& a, long b) { while (b > 0) --a, --b; }
|
||||||
|
inline void ref_count_up(atomic_count& a) { ++a; }
|
||||||
|
inline bool ref_count_down(atomic_count& a) { return --a == 0; }
|
||||||
|
#endif // defined(ASIO_HAS_STD_ATOMIC)
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_ATOMIC_COUNT_HPP
|
163
lib/asio-1.26.0/asio/detail/base_from_cancellation_state.hpp
Normal file
163
lib/asio-1.26.0/asio/detail/base_from_cancellation_state.hpp
Normal file
|
@ -0,0 +1,163 @@
|
||||||
|
//
|
||||||
|
// detail/base_from_cancellation_state.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BASE_FROM_CANCELLATION_STATE_HPP
|
||||||
|
#define ASIO_DETAIL_BASE_FROM_CANCELLATION_STATE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/associated_cancellation_slot.hpp"
|
||||||
|
#include "asio/cancellation_state.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename Handler, typename = void>
|
||||||
|
class base_from_cancellation_state
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef cancellation_slot cancellation_slot_type;
|
||||||
|
|
||||||
|
cancellation_slot_type get_cancellation_slot() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancellation_state_.slot();
|
||||||
|
}
|
||||||
|
|
||||||
|
cancellation_state get_cancellation_state() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancellation_state_;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
explicit base_from_cancellation_state(const Handler& handler)
|
||||||
|
: cancellation_state_(
|
||||||
|
asio::get_associated_cancellation_slot(handler))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Filter>
|
||||||
|
base_from_cancellation_state(const Handler& handler, Filter filter)
|
||||||
|
: cancellation_state_(
|
||||||
|
asio::get_associated_cancellation_slot(handler), filter, filter)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename InFilter, typename OutFilter>
|
||||||
|
base_from_cancellation_state(const Handler& handler,
|
||||||
|
ASIO_MOVE_ARG(InFilter) in_filter,
|
||||||
|
ASIO_MOVE_ARG(OutFilter) out_filter)
|
||||||
|
: cancellation_state_(
|
||||||
|
asio::get_associated_cancellation_slot(handler),
|
||||||
|
ASIO_MOVE_CAST(InFilter)(in_filter),
|
||||||
|
ASIO_MOVE_CAST(OutFilter)(out_filter))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset_cancellation_state(const Handler& handler)
|
||||||
|
{
|
||||||
|
cancellation_state_ = cancellation_state(
|
||||||
|
asio::get_associated_cancellation_slot(handler));
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Filter>
|
||||||
|
void reset_cancellation_state(const Handler& handler, Filter filter)
|
||||||
|
{
|
||||||
|
cancellation_state_ = cancellation_state(
|
||||||
|
asio::get_associated_cancellation_slot(handler), filter, filter);
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename InFilter, typename OutFilter>
|
||||||
|
void reset_cancellation_state(const Handler& handler,
|
||||||
|
ASIO_MOVE_ARG(InFilter) in_filter,
|
||||||
|
ASIO_MOVE_ARG(OutFilter) out_filter)
|
||||||
|
{
|
||||||
|
cancellation_state_ = cancellation_state(
|
||||||
|
asio::get_associated_cancellation_slot(handler),
|
||||||
|
ASIO_MOVE_CAST(InFilter)(in_filter),
|
||||||
|
ASIO_MOVE_CAST(OutFilter)(out_filter));
|
||||||
|
}
|
||||||
|
|
||||||
|
cancellation_type_t cancelled() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancellation_state_.cancelled();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
cancellation_state cancellation_state_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Handler>
|
||||||
|
class base_from_cancellation_state<Handler,
|
||||||
|
typename enable_if<
|
||||||
|
is_same<
|
||||||
|
typename associated_cancellation_slot<
|
||||||
|
Handler, cancellation_slot
|
||||||
|
>::asio_associated_cancellation_slot_is_unspecialised,
|
||||||
|
void
|
||||||
|
>::value
|
||||||
|
>::type>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
cancellation_state get_cancellation_state() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancellation_state();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
explicit base_from_cancellation_state(const Handler&)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Filter>
|
||||||
|
base_from_cancellation_state(const Handler&, Filter)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename InFilter, typename OutFilter>
|
||||||
|
base_from_cancellation_state(const Handler&,
|
||||||
|
ASIO_MOVE_ARG(InFilter),
|
||||||
|
ASIO_MOVE_ARG(OutFilter))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset_cancellation_state(const Handler&)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Filter>
|
||||||
|
void reset_cancellation_state(const Handler&, Filter)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename InFilter, typename OutFilter>
|
||||||
|
void reset_cancellation_state(const Handler&,
|
||||||
|
ASIO_MOVE_ARG(InFilter),
|
||||||
|
ASIO_MOVE_ARG(OutFilter))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
ASIO_CONSTEXPR cancellation_type_t cancelled() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return cancellation_type::none;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BASE_FROM_CANCELLATION_STATE_HPP
|
69
lib/asio-1.26.0/asio/detail/base_from_completion_cond.hpp
Normal file
69
lib/asio-1.26.0/asio/detail/base_from_completion_cond.hpp
Normal file
|
@ -0,0 +1,69 @@
|
||||||
|
//
|
||||||
|
// detail/base_from_completion_cond.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BASE_FROM_COMPLETION_COND_HPP
|
||||||
|
#define ASIO_DETAIL_BASE_FROM_COMPLETION_COND_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/completion_condition.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename CompletionCondition>
|
||||||
|
class base_from_completion_cond
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
explicit base_from_completion_cond(CompletionCondition& completion_condition)
|
||||||
|
: completion_condition_(
|
||||||
|
ASIO_MOVE_CAST(CompletionCondition)(completion_condition))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t check_for_completion(
|
||||||
|
const asio::error_code& ec,
|
||||||
|
std::size_t total_transferred)
|
||||||
|
{
|
||||||
|
return detail::adapt_completion_condition_result(
|
||||||
|
completion_condition_(ec, total_transferred));
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
CompletionCondition completion_condition_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class base_from_completion_cond<transfer_all_t>
|
||||||
|
{
|
||||||
|
protected:
|
||||||
|
explicit base_from_completion_cond(transfer_all_t)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
static std::size_t check_for_completion(
|
||||||
|
const asio::error_code& ec,
|
||||||
|
std::size_t total_transferred)
|
||||||
|
{
|
||||||
|
return transfer_all_t()(ec, total_transferred);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BASE_FROM_COMPLETION_COND_HPP
|
1145
lib/asio-1.26.0/asio/detail/bind_handler.hpp
Normal file
1145
lib/asio-1.26.0/asio/detail/bind_handler.hpp
Normal file
File diff suppressed because it is too large
Load diff
107
lib/asio-1.26.0/asio/detail/blocking_executor_op.hpp
Normal file
107
lib/asio-1.26.0/asio/detail/blocking_executor_op.hpp
Normal file
|
@ -0,0 +1,107 @@
|
||||||
|
//
|
||||||
|
// detail/blocking_executor_op.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BLOCKING_EXECUTOR_OP_HPP
|
||||||
|
#define ASIO_DETAIL_BLOCKING_EXECUTOR_OP_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/event.hpp"
|
||||||
|
#include "asio/detail/fenced_block.hpp"
|
||||||
|
#include "asio/detail/handler_invoke_helpers.hpp"
|
||||||
|
#include "asio/detail/mutex.hpp"
|
||||||
|
#include "asio/detail/scheduler_operation.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename Operation = scheduler_operation>
|
||||||
|
class blocking_executor_op_base : public Operation
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
blocking_executor_op_base(typename Operation::func_type complete_func)
|
||||||
|
: Operation(complete_func),
|
||||||
|
is_complete_(false)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void wait()
|
||||||
|
{
|
||||||
|
asio::detail::mutex::scoped_lock lock(mutex_);
|
||||||
|
while (!is_complete_)
|
||||||
|
event_.wait(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected:
|
||||||
|
struct do_complete_cleanup
|
||||||
|
{
|
||||||
|
~do_complete_cleanup()
|
||||||
|
{
|
||||||
|
asio::detail::mutex::scoped_lock lock(op_->mutex_);
|
||||||
|
op_->is_complete_ = true;
|
||||||
|
op_->event_.unlock_and_signal_one_for_destruction(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
blocking_executor_op_base* op_;
|
||||||
|
};
|
||||||
|
|
||||||
|
private:
|
||||||
|
asio::detail::mutex mutex_;
|
||||||
|
asio::detail::event event_;
|
||||||
|
bool is_complete_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Handler, typename Operation = scheduler_operation>
|
||||||
|
class blocking_executor_op : public blocking_executor_op_base<Operation>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
blocking_executor_op(Handler& h)
|
||||||
|
: blocking_executor_op_base<Operation>(&blocking_executor_op::do_complete),
|
||||||
|
handler_(h)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
static void do_complete(void* owner, Operation* base,
|
||||||
|
const asio::error_code& /*ec*/,
|
||||||
|
std::size_t /*bytes_transferred*/)
|
||||||
|
{
|
||||||
|
blocking_executor_op* o(static_cast<blocking_executor_op*>(base));
|
||||||
|
|
||||||
|
typename blocking_executor_op_base<Operation>::do_complete_cleanup
|
||||||
|
on_exit = { o };
|
||||||
|
(void)on_exit;
|
||||||
|
|
||||||
|
ASIO_HANDLER_COMPLETION((*o));
|
||||||
|
|
||||||
|
// Make the upcall if required.
|
||||||
|
if (owner)
|
||||||
|
{
|
||||||
|
fenced_block b(fenced_block::half);
|
||||||
|
ASIO_HANDLER_INVOCATION_BEGIN(());
|
||||||
|
asio_handler_invoke_helpers::invoke(o->handler_, o->handler_);
|
||||||
|
ASIO_HANDLER_INVOCATION_END;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
Handler& handler_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BLOCKING_EXECUTOR_OP_HPP
|
66
lib/asio-1.26.0/asio/detail/buffer_resize_guard.hpp
Normal file
66
lib/asio-1.26.0/asio/detail/buffer_resize_guard.hpp
Normal file
|
@ -0,0 +1,66 @@
|
||||||
|
//
|
||||||
|
// detail/buffer_resize_guard.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BUFFER_RESIZE_GUARD_HPP
|
||||||
|
#define ASIO_DETAIL_BUFFER_RESIZE_GUARD_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/limits.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper class to manage buffer resizing in an exception safe way.
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_resize_guard
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Constructor.
|
||||||
|
buffer_resize_guard(Buffer& buffer)
|
||||||
|
: buffer_(buffer),
|
||||||
|
old_size_(buffer.size())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Destructor rolls back the buffer resize unless commit was called.
|
||||||
|
~buffer_resize_guard()
|
||||||
|
{
|
||||||
|
if (old_size_ != (std::numeric_limits<size_t>::max)())
|
||||||
|
{
|
||||||
|
buffer_.resize(old_size_);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Commit the resize transaction.
|
||||||
|
void commit()
|
||||||
|
{
|
||||||
|
old_size_ = (std::numeric_limits<size_t>::max)();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// The buffer being managed.
|
||||||
|
Buffer& buffer_;
|
||||||
|
|
||||||
|
// The size of the buffer at the time the guard was constructed.
|
||||||
|
size_t old_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BUFFER_RESIZE_GUARD_HPP
|
841
lib/asio-1.26.0/asio/detail/buffer_sequence_adapter.hpp
Normal file
841
lib/asio-1.26.0/asio/detail/buffer_sequence_adapter.hpp
Normal file
|
@ -0,0 +1,841 @@
|
||||||
|
//
|
||||||
|
// detail/buffer_sequence_adapter.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BUFFER_SEQUENCE_ADAPTER_HPP
|
||||||
|
#define ASIO_DETAIL_BUFFER_SEQUENCE_ADAPTER_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/detail/array_fwd.hpp"
|
||||||
|
#include "asio/detail/socket_types.hpp"
|
||||||
|
#include "asio/registered_buffer.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
#if defined(ASIO_WINDOWS_RUNTIME)
|
||||||
|
public:
|
||||||
|
// The maximum number of buffers to support in a single operation.
|
||||||
|
enum { max_buffers = 1 };
|
||||||
|
|
||||||
|
protected:
|
||||||
|
typedef Windows::Storage::Streams::IBuffer^ native_buffer_type;
|
||||||
|
|
||||||
|
ASIO_DECL static void init_native_buffer(
|
||||||
|
native_buffer_type& buf,
|
||||||
|
const asio::mutable_buffer& buffer);
|
||||||
|
|
||||||
|
ASIO_DECL static void init_native_buffer(
|
||||||
|
native_buffer_type& buf,
|
||||||
|
const asio::const_buffer& buffer);
|
||||||
|
#elif defined(ASIO_WINDOWS) || defined(__CYGWIN__)
|
||||||
|
public:
|
||||||
|
// The maximum number of buffers to support in a single operation.
|
||||||
|
enum { max_buffers = 64 < max_iov_len ? 64 : max_iov_len };
|
||||||
|
|
||||||
|
protected:
|
||||||
|
typedef WSABUF native_buffer_type;
|
||||||
|
|
||||||
|
static void init_native_buffer(WSABUF& buf,
|
||||||
|
const asio::mutable_buffer& buffer)
|
||||||
|
{
|
||||||
|
buf.buf = static_cast<char*>(buffer.data());
|
||||||
|
buf.len = static_cast<ULONG>(buffer.size());
|
||||||
|
}
|
||||||
|
|
||||||
|
static void init_native_buffer(WSABUF& buf,
|
||||||
|
const asio::const_buffer& buffer)
|
||||||
|
{
|
||||||
|
buf.buf = const_cast<char*>(static_cast<const char*>(buffer.data()));
|
||||||
|
buf.len = static_cast<ULONG>(buffer.size());
|
||||||
|
}
|
||||||
|
#else // defined(ASIO_WINDOWS) || defined(__CYGWIN__)
|
||||||
|
public:
|
||||||
|
// The maximum number of buffers to support in a single operation.
|
||||||
|
enum { max_buffers = 64 < max_iov_len ? 64 : max_iov_len };
|
||||||
|
|
||||||
|
protected:
|
||||||
|
typedef iovec native_buffer_type;
|
||||||
|
|
||||||
|
static void init_iov_base(void*& base, void* addr)
|
||||||
|
{
|
||||||
|
base = addr;
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename T>
|
||||||
|
static void init_iov_base(T& base, void* addr)
|
||||||
|
{
|
||||||
|
base = static_cast<T>(addr);
|
||||||
|
}
|
||||||
|
|
||||||
|
static void init_native_buffer(iovec& iov,
|
||||||
|
const asio::mutable_buffer& buffer)
|
||||||
|
{
|
||||||
|
init_iov_base(iov.iov_base, buffer.data());
|
||||||
|
iov.iov_len = buffer.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
static void init_native_buffer(iovec& iov,
|
||||||
|
const asio::const_buffer& buffer)
|
||||||
|
{
|
||||||
|
init_iov_base(iov.iov_base, const_cast<void*>(buffer.data()));
|
||||||
|
iov.iov_len = buffer.size();
|
||||||
|
}
|
||||||
|
#endif // defined(ASIO_WINDOWS) || defined(__CYGWIN__)
|
||||||
|
};
|
||||||
|
|
||||||
|
// Helper class to translate buffers into the native buffer representation.
|
||||||
|
template <typename Buffer, typename Buffers>
|
||||||
|
class buffer_sequence_adapter
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = false };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(const Buffers& buffer_sequence)
|
||||||
|
: count_(0), total_buffer_size_(0)
|
||||||
|
{
|
||||||
|
buffer_sequence_adapter::init(
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence));
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return buffers_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return count_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const Buffers& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence_adapter::all_empty(
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence));
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const Buffers& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence_adapter::validate(
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence));
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const Buffers& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence_adapter::first(
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence));
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 8192 };
|
||||||
|
|
||||||
|
static Buffer linearise(const Buffers& buffer_sequence,
|
||||||
|
const asio::mutable_buffer& storage)
|
||||||
|
{
|
||||||
|
return buffer_sequence_adapter::linearise(
|
||||||
|
asio::buffer_sequence_begin(buffer_sequence),
|
||||||
|
asio::buffer_sequence_end(buffer_sequence), storage);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
template <typename Iterator>
|
||||||
|
void init(Iterator begin, Iterator end)
|
||||||
|
{
|
||||||
|
Iterator iter = begin;
|
||||||
|
for (; iter != end && count_ < max_buffers; ++iter, ++count_)
|
||||||
|
{
|
||||||
|
Buffer buffer(*iter);
|
||||||
|
init_native_buffer(buffers_[count_], buffer);
|
||||||
|
total_buffer_size_ += buffer.size();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Iterator>
|
||||||
|
static bool all_empty(Iterator begin, Iterator end)
|
||||||
|
{
|
||||||
|
Iterator iter = begin;
|
||||||
|
std::size_t i = 0;
|
||||||
|
for (; iter != end && i < max_buffers; ++iter, ++i)
|
||||||
|
if (Buffer(*iter).size() > 0)
|
||||||
|
return false;
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Iterator>
|
||||||
|
static void validate(Iterator begin, Iterator end)
|
||||||
|
{
|
||||||
|
Iterator iter = begin;
|
||||||
|
for (; iter != end; ++iter)
|
||||||
|
{
|
||||||
|
Buffer buffer(*iter);
|
||||||
|
buffer.data();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Iterator>
|
||||||
|
static Buffer first(Iterator begin, Iterator end)
|
||||||
|
{
|
||||||
|
Iterator iter = begin;
|
||||||
|
for (; iter != end; ++iter)
|
||||||
|
{
|
||||||
|
Buffer buffer(*iter);
|
||||||
|
if (buffer.size() != 0)
|
||||||
|
return buffer;
|
||||||
|
}
|
||||||
|
return Buffer();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Iterator>
|
||||||
|
static Buffer linearise(Iterator begin, Iterator end,
|
||||||
|
const asio::mutable_buffer& storage)
|
||||||
|
{
|
||||||
|
asio::mutable_buffer unused_storage = storage;
|
||||||
|
Iterator iter = begin;
|
||||||
|
while (iter != end && unused_storage.size() != 0)
|
||||||
|
{
|
||||||
|
Buffer buffer(*iter);
|
||||||
|
++iter;
|
||||||
|
if (buffer.size() == 0)
|
||||||
|
continue;
|
||||||
|
if (unused_storage.size() == storage.size())
|
||||||
|
{
|
||||||
|
if (iter == end)
|
||||||
|
return buffer;
|
||||||
|
if (buffer.size() >= unused_storage.size())
|
||||||
|
return buffer;
|
||||||
|
}
|
||||||
|
unused_storage += asio::buffer_copy(unused_storage, buffer);
|
||||||
|
}
|
||||||
|
return Buffer(storage.data(), storage.size() - unused_storage.size());
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type buffers_[max_buffers];
|
||||||
|
std::size_t count_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_sequence_adapter<Buffer, asio::mutable_buffer>
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = true };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const asio::mutable_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffer_, Buffer(buffer_sequence));
|
||||||
|
total_buffer_size_ = buffer_sequence.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return &buffer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const asio::mutable_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence.size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const asio::mutable_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const asio::mutable_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 1 };
|
||||||
|
|
||||||
|
static Buffer linearise(const asio::mutable_buffer& buffer_sequence,
|
||||||
|
const Buffer&)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffer_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_sequence_adapter<Buffer, asio::const_buffer>
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = true };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const asio::const_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffer_, Buffer(buffer_sequence));
|
||||||
|
total_buffer_size_ = buffer_sequence.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return &buffer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const asio::const_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence.size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const asio::const_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const asio::const_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 1 };
|
||||||
|
|
||||||
|
static Buffer linearise(const asio::const_buffer& buffer_sequence,
|
||||||
|
const Buffer&)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffer_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_sequence_adapter<Buffer, asio::mutable_buffers_1>
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = true };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const asio::mutable_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffer_, Buffer(buffer_sequence));
|
||||||
|
total_buffer_size_ = buffer_sequence.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return &buffer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const asio::mutable_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence.size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const asio::mutable_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const asio::mutable_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 1 };
|
||||||
|
|
||||||
|
static Buffer linearise(const asio::mutable_buffers_1& buffer_sequence,
|
||||||
|
const Buffer&)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffer_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_sequence_adapter<Buffer, asio::const_buffers_1>
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = true };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const asio::const_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffer_, Buffer(buffer_sequence));
|
||||||
|
total_buffer_size_ = buffer_sequence.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return &buffer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const asio::const_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence.size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const asio::const_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const asio::const_buffers_1& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 1 };
|
||||||
|
|
||||||
|
static Buffer linearise(const asio::const_buffers_1& buffer_sequence,
|
||||||
|
const Buffer&)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffer_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_sequence_adapter<Buffer, asio::mutable_registered_buffer>
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = true };
|
||||||
|
enum { is_registered_buffer = true };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const asio::mutable_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffer_, buffer_sequence.buffer());
|
||||||
|
total_buffer_size_ = buffer_sequence.size();
|
||||||
|
registered_id_ = buffer_sequence.id();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return &buffer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_id_;
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(
|
||||||
|
const asio::mutable_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence.size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(
|
||||||
|
const asio::mutable_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(
|
||||||
|
const asio::mutable_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence.buffer());
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 1 };
|
||||||
|
|
||||||
|
static Buffer linearise(
|
||||||
|
const asio::mutable_registered_buffer& buffer_sequence,
|
||||||
|
const Buffer&)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence.buffer());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffer_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
registered_buffer_id registered_id_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Buffer>
|
||||||
|
class buffer_sequence_adapter<Buffer, asio::const_registered_buffer>
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = true };
|
||||||
|
enum { is_registered_buffer = true };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const asio::const_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffer_, buffer_sequence.buffer());
|
||||||
|
total_buffer_size_ = buffer_sequence.size();
|
||||||
|
registered_id_ = buffer_sequence.id();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return &buffer_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_id_;
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(
|
||||||
|
const asio::const_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence.size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(
|
||||||
|
const asio::const_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence.data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(
|
||||||
|
const asio::const_registered_buffer& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence.buffer());
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 1 };
|
||||||
|
|
||||||
|
static Buffer linearise(
|
||||||
|
const asio::const_registered_buffer& buffer_sequence,
|
||||||
|
const Buffer&)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence.buffer());
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffer_;
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
registered_buffer_id registered_id_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Buffer, typename Elem>
|
||||||
|
class buffer_sequence_adapter<Buffer, boost::array<Elem, 2> >
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = false };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const boost::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffers_[0], Buffer(buffer_sequence[0]));
|
||||||
|
init_native_buffer(buffers_[1], Buffer(buffer_sequence[1]));
|
||||||
|
total_buffer_size_ = buffer_sequence[0].size() + buffer_sequence[1].size();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return buffers_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const boost::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence[0].size() == 0 && buffer_sequence[1].size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const boost::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence[0].data();
|
||||||
|
buffer_sequence[1].data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const boost::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence[0].size() != 0
|
||||||
|
? buffer_sequence[0] : buffer_sequence[1]);
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 8192 };
|
||||||
|
|
||||||
|
static Buffer linearise(const boost::array<Elem, 2>& buffer_sequence,
|
||||||
|
const asio::mutable_buffer& storage)
|
||||||
|
{
|
||||||
|
if (buffer_sequence[0].size() == 0)
|
||||||
|
return Buffer(buffer_sequence[1]);
|
||||||
|
if (buffer_sequence[1].size() == 0)
|
||||||
|
return Buffer(buffer_sequence[0]);
|
||||||
|
return Buffer(storage.data(),
|
||||||
|
asio::buffer_copy(storage, buffer_sequence));
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffers_[2];
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
template <typename Buffer, typename Elem>
|
||||||
|
class buffer_sequence_adapter<Buffer, std::array<Elem, 2> >
|
||||||
|
: buffer_sequence_adapter_base
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
enum { is_single_buffer = false };
|
||||||
|
enum { is_registered_buffer = false };
|
||||||
|
|
||||||
|
explicit buffer_sequence_adapter(
|
||||||
|
const std::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
init_native_buffer(buffers_[0], Buffer(buffer_sequence[0]));
|
||||||
|
init_native_buffer(buffers_[1], Buffer(buffer_sequence[1]));
|
||||||
|
total_buffer_size_ = buffer_sequence[0].size() + buffer_sequence[1].size();
|
||||||
|
}
|
||||||
|
|
||||||
|
native_buffer_type* buffers()
|
||||||
|
{
|
||||||
|
return buffers_;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t count() const
|
||||||
|
{
|
||||||
|
return 2;
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_size() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
registered_buffer_id registered_id() const
|
||||||
|
{
|
||||||
|
return registered_buffer_id();
|
||||||
|
}
|
||||||
|
|
||||||
|
bool all_empty() const
|
||||||
|
{
|
||||||
|
return total_buffer_size_ == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static bool all_empty(const std::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
return buffer_sequence[0].size() == 0 && buffer_sequence[1].size() == 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
static void validate(const std::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
buffer_sequence[0].data();
|
||||||
|
buffer_sequence[1].data();
|
||||||
|
}
|
||||||
|
|
||||||
|
static Buffer first(const std::array<Elem, 2>& buffer_sequence)
|
||||||
|
{
|
||||||
|
return Buffer(buffer_sequence[0].size() != 0
|
||||||
|
? buffer_sequence[0] : buffer_sequence[1]);
|
||||||
|
}
|
||||||
|
|
||||||
|
enum { linearisation_storage_size = 8192 };
|
||||||
|
|
||||||
|
static Buffer linearise(const std::array<Elem, 2>& buffer_sequence,
|
||||||
|
const asio::mutable_buffer& storage)
|
||||||
|
{
|
||||||
|
if (buffer_sequence[0].size() == 0)
|
||||||
|
return Buffer(buffer_sequence[1]);
|
||||||
|
if (buffer_sequence[1].size() == 0)
|
||||||
|
return Buffer(buffer_sequence[0]);
|
||||||
|
return Buffer(storage.data(),
|
||||||
|
asio::buffer_copy(storage, buffer_sequence));
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
native_buffer_type buffers_[2];
|
||||||
|
std::size_t total_buffer_size_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HEADER_ONLY)
|
||||||
|
# include "asio/detail/impl/buffer_sequence_adapter.ipp"
|
||||||
|
#endif // defined(ASIO_HEADER_ONLY)
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BUFFER_SEQUENCE_ADAPTER_HPP
|
126
lib/asio-1.26.0/asio/detail/buffered_stream_storage.hpp
Normal file
126
lib/asio-1.26.0/asio/detail/buffered_stream_storage.hpp
Normal file
|
@ -0,0 +1,126 @@
|
||||||
|
//
|
||||||
|
// detail/buffered_stream_storage.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BUFFERED_STREAM_STORAGE_HPP
|
||||||
|
#define ASIO_DETAIL_BUFFERED_STREAM_STORAGE_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/detail/assert.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include <cstring>
|
||||||
|
#include <vector>
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
class buffered_stream_storage
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// The type of the bytes stored in the buffer.
|
||||||
|
typedef unsigned char byte_type;
|
||||||
|
|
||||||
|
// The type used for offsets into the buffer.
|
||||||
|
typedef std::size_t size_type;
|
||||||
|
|
||||||
|
// Constructor.
|
||||||
|
explicit buffered_stream_storage(std::size_t buffer_capacity)
|
||||||
|
: begin_offset_(0),
|
||||||
|
end_offset_(0),
|
||||||
|
buffer_(buffer_capacity)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
/// Clear the buffer.
|
||||||
|
void clear()
|
||||||
|
{
|
||||||
|
begin_offset_ = 0;
|
||||||
|
end_offset_ = 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Return a pointer to the beginning of the unread data.
|
||||||
|
mutable_buffer data()
|
||||||
|
{
|
||||||
|
return asio::buffer(buffer_) + begin_offset_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Return a pointer to the beginning of the unread data.
|
||||||
|
const_buffer data() const
|
||||||
|
{
|
||||||
|
return asio::buffer(buffer_) + begin_offset_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Is there no unread data in the buffer.
|
||||||
|
bool empty() const
|
||||||
|
{
|
||||||
|
return begin_offset_ == end_offset_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Return the amount of unread data the is in the buffer.
|
||||||
|
size_type size() const
|
||||||
|
{
|
||||||
|
return end_offset_ - begin_offset_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Resize the buffer to the specified length.
|
||||||
|
void resize(size_type length)
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(length <= capacity());
|
||||||
|
if (begin_offset_ + length <= capacity())
|
||||||
|
{
|
||||||
|
end_offset_ = begin_offset_ + length;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
using namespace std; // For memmove.
|
||||||
|
memmove(&buffer_[0], &buffer_[0] + begin_offset_, size());
|
||||||
|
end_offset_ = length;
|
||||||
|
begin_offset_ = 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Return the maximum size for data in the buffer.
|
||||||
|
size_type capacity() const
|
||||||
|
{
|
||||||
|
return buffer_.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Consume multiple bytes from the beginning of the buffer.
|
||||||
|
void consume(size_type count)
|
||||||
|
{
|
||||||
|
ASIO_ASSERT(begin_offset_ + count <= end_offset_);
|
||||||
|
begin_offset_ += count;
|
||||||
|
if (empty())
|
||||||
|
clear();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// The offset to the beginning of the unread data.
|
||||||
|
size_type begin_offset_;
|
||||||
|
|
||||||
|
// The offset to the end of the unread data.
|
||||||
|
size_type end_offset_;
|
||||||
|
|
||||||
|
// The data in the buffer.
|
||||||
|
std::vector<byte_type> buffer_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BUFFERED_STREAM_STORAGE_HPP
|
88
lib/asio-1.26.0/asio/detail/bulk_executor_op.hpp
Normal file
88
lib/asio-1.26.0/asio/detail/bulk_executor_op.hpp
Normal file
|
@ -0,0 +1,88 @@
|
||||||
|
//
|
||||||
|
// detail/bulk_executor_op.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_BULK_EXECUTOR_OP_HPP
|
||||||
|
#define ASIO_DETAIL_BULK_EXECUTOR_OP_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/bind_handler.hpp"
|
||||||
|
#include "asio/detail/fenced_block.hpp"
|
||||||
|
#include "asio/detail/handler_alloc_helpers.hpp"
|
||||||
|
#include "asio/detail/handler_invoke_helpers.hpp"
|
||||||
|
#include "asio/detail/scheduler_operation.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename Handler, typename Alloc,
|
||||||
|
typename Operation = scheduler_operation>
|
||||||
|
class bulk_executor_op : public Operation
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
ASIO_DEFINE_HANDLER_ALLOCATOR_PTR(bulk_executor_op);
|
||||||
|
|
||||||
|
template <typename H>
|
||||||
|
bulk_executor_op(ASIO_MOVE_ARG(H) h,
|
||||||
|
const Alloc& allocator, std::size_t i)
|
||||||
|
: Operation(&bulk_executor_op::do_complete),
|
||||||
|
handler_(ASIO_MOVE_CAST(H)(h)),
|
||||||
|
allocator_(allocator),
|
||||||
|
index_(i)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
static void do_complete(void* owner, Operation* base,
|
||||||
|
const asio::error_code& /*ec*/,
|
||||||
|
std::size_t /*bytes_transferred*/)
|
||||||
|
{
|
||||||
|
// Take ownership of the handler object.
|
||||||
|
bulk_executor_op* o(static_cast<bulk_executor_op*>(base));
|
||||||
|
Alloc allocator(o->allocator_);
|
||||||
|
ptr p = { detail::addressof(allocator), o, o };
|
||||||
|
|
||||||
|
ASIO_HANDLER_COMPLETION((*o));
|
||||||
|
|
||||||
|
// Make a copy of the handler so that the memory can be deallocated before
|
||||||
|
// the upcall is made. Even if we're not about to make an upcall, a
|
||||||
|
// sub-object of the handler may be the true owner of the memory associated
|
||||||
|
// with the handler. Consequently, a local copy of the handler is required
|
||||||
|
// to ensure that any owning sub-object remains valid until after we have
|
||||||
|
// deallocated the memory here.
|
||||||
|
detail::binder1<Handler, std::size_t> handler(o->handler_, o->index_);
|
||||||
|
p.reset();
|
||||||
|
|
||||||
|
// Make the upcall if required.
|
||||||
|
if (owner)
|
||||||
|
{
|
||||||
|
fenced_block b(fenced_block::half);
|
||||||
|
ASIO_HANDLER_INVOCATION_BEGIN(());
|
||||||
|
asio_handler_invoke_helpers::invoke(handler, handler.handler_);
|
||||||
|
ASIO_HANDLER_INVOCATION_END;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
Handler handler_;
|
||||||
|
Alloc allocator_;
|
||||||
|
std::size_t index_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_BULK_EXECUTOR_OP_HPP
|
125
lib/asio-1.26.0/asio/detail/call_stack.hpp
Normal file
125
lib/asio-1.26.0/asio/detail/call_stack.hpp
Normal file
|
@ -0,0 +1,125 @@
|
||||||
|
//
|
||||||
|
// detail/call_stack.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CALL_STACK_HPP
|
||||||
|
#define ASIO_DETAIL_CALL_STACK_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/detail/tss_ptr.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper class to determine whether or not the current thread is inside an
|
||||||
|
// invocation of io_context::run() for a specified io_context object.
|
||||||
|
template <typename Key, typename Value = unsigned char>
|
||||||
|
class call_stack
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Context class automatically pushes the key/value pair on to the stack.
|
||||||
|
class context
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Push the key on to the stack.
|
||||||
|
explicit context(Key* k)
|
||||||
|
: key_(k),
|
||||||
|
next_(call_stack<Key, Value>::top_)
|
||||||
|
{
|
||||||
|
value_ = reinterpret_cast<unsigned char*>(this);
|
||||||
|
call_stack<Key, Value>::top_ = this;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Push the key/value pair on to the stack.
|
||||||
|
context(Key* k, Value& v)
|
||||||
|
: key_(k),
|
||||||
|
value_(&v),
|
||||||
|
next_(call_stack<Key, Value>::top_)
|
||||||
|
{
|
||||||
|
call_stack<Key, Value>::top_ = this;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Pop the key/value pair from the stack.
|
||||||
|
~context()
|
||||||
|
{
|
||||||
|
call_stack<Key, Value>::top_ = next_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find the next context with the same key.
|
||||||
|
Value* next_by_key() const
|
||||||
|
{
|
||||||
|
context* elem = next_;
|
||||||
|
while (elem)
|
||||||
|
{
|
||||||
|
if (elem->key_ == key_)
|
||||||
|
return elem->value_;
|
||||||
|
elem = elem->next_;
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
friend class call_stack<Key, Value>;
|
||||||
|
|
||||||
|
// The key associated with the context.
|
||||||
|
Key* key_;
|
||||||
|
|
||||||
|
// The value associated with the context.
|
||||||
|
Value* value_;
|
||||||
|
|
||||||
|
// The next element in the stack.
|
||||||
|
context* next_;
|
||||||
|
};
|
||||||
|
|
||||||
|
friend class context;
|
||||||
|
|
||||||
|
// Determine whether the specified owner is on the stack. Returns address of
|
||||||
|
// key if present, 0 otherwise.
|
||||||
|
static Value* contains(Key* k)
|
||||||
|
{
|
||||||
|
context* elem = top_;
|
||||||
|
while (elem)
|
||||||
|
{
|
||||||
|
if (elem->key_ == k)
|
||||||
|
return elem->value_;
|
||||||
|
elem = elem->next_;
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Obtain the value at the top of the stack.
|
||||||
|
static Value* top()
|
||||||
|
{
|
||||||
|
context* elem = top_;
|
||||||
|
return elem ? elem->value_ : 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
// The top of the stack of calls for the current thread.
|
||||||
|
static tss_ptr<context> top_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Key, typename Value>
|
||||||
|
tss_ptr<typename call_stack<Key, Value>::context>
|
||||||
|
call_stack<Key, Value>::top_;
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CALL_STACK_HPP
|
66
lib/asio-1.26.0/asio/detail/chrono.hpp
Normal file
66
lib/asio-1.26.0/asio/detail/chrono.hpp
Normal file
|
@ -0,0 +1,66 @@
|
||||||
|
//
|
||||||
|
// detail/chrono.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CHRONO_HPP
|
||||||
|
#define ASIO_DETAIL_CHRONO_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_CHRONO)
|
||||||
|
# include <chrono>
|
||||||
|
#elif defined(ASIO_HAS_BOOST_CHRONO)
|
||||||
|
# include <boost/chrono/system_clocks.hpp>
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_CHRONO)
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace chrono {
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_CHRONO)
|
||||||
|
using std::chrono::duration;
|
||||||
|
using std::chrono::time_point;
|
||||||
|
using std::chrono::duration_cast;
|
||||||
|
using std::chrono::nanoseconds;
|
||||||
|
using std::chrono::microseconds;
|
||||||
|
using std::chrono::milliseconds;
|
||||||
|
using std::chrono::seconds;
|
||||||
|
using std::chrono::minutes;
|
||||||
|
using std::chrono::hours;
|
||||||
|
using std::chrono::time_point_cast;
|
||||||
|
#if defined(ASIO_HAS_STD_CHRONO_MONOTONIC_CLOCK)
|
||||||
|
typedef std::chrono::monotonic_clock steady_clock;
|
||||||
|
#else // defined(ASIO_HAS_STD_CHRONO_MONOTONIC_CLOCK)
|
||||||
|
using std::chrono::steady_clock;
|
||||||
|
#endif // defined(ASIO_HAS_STD_CHRONO_MONOTONIC_CLOCK)
|
||||||
|
using std::chrono::system_clock;
|
||||||
|
using std::chrono::high_resolution_clock;
|
||||||
|
#elif defined(ASIO_HAS_BOOST_CHRONO)
|
||||||
|
using boost::chrono::duration;
|
||||||
|
using boost::chrono::time_point;
|
||||||
|
using boost::chrono::duration_cast;
|
||||||
|
using boost::chrono::nanoseconds;
|
||||||
|
using boost::chrono::microseconds;
|
||||||
|
using boost::chrono::milliseconds;
|
||||||
|
using boost::chrono::seconds;
|
||||||
|
using boost::chrono::minutes;
|
||||||
|
using boost::chrono::hours;
|
||||||
|
using boost::chrono::time_point_cast;
|
||||||
|
using boost::chrono::system_clock;
|
||||||
|
using boost::chrono::steady_clock;
|
||||||
|
using boost::chrono::high_resolution_clock;
|
||||||
|
#endif // defined(ASIO_HAS_BOOST_CHRONO)
|
||||||
|
|
||||||
|
} // namespace chrono
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CHRONO_HPP
|
190
lib/asio-1.26.0/asio/detail/chrono_time_traits.hpp
Normal file
190
lib/asio-1.26.0/asio/detail/chrono_time_traits.hpp
Normal file
|
@ -0,0 +1,190 @@
|
||||||
|
//
|
||||||
|
// detail/chrono_time_traits.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CHRONO_TIME_TRAITS_HPP
|
||||||
|
#define ASIO_DETAIL_CHRONO_TIME_TRAITS_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/cstdint.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper template to compute the greatest common divisor.
|
||||||
|
template <int64_t v1, int64_t v2>
|
||||||
|
struct gcd { enum { value = gcd<v2, v1 % v2>::value }; };
|
||||||
|
|
||||||
|
template <int64_t v1>
|
||||||
|
struct gcd<v1, 0> { enum { value = v1 }; };
|
||||||
|
|
||||||
|
// Adapts std::chrono clocks for use with a deadline timer.
|
||||||
|
template <typename Clock, typename WaitTraits>
|
||||||
|
struct chrono_time_traits
|
||||||
|
{
|
||||||
|
// The clock type.
|
||||||
|
typedef Clock clock_type;
|
||||||
|
|
||||||
|
// The duration type of the clock.
|
||||||
|
typedef typename clock_type::duration duration_type;
|
||||||
|
|
||||||
|
// The time point type of the clock.
|
||||||
|
typedef typename clock_type::time_point time_type;
|
||||||
|
|
||||||
|
// The period of the clock.
|
||||||
|
typedef typename duration_type::period period_type;
|
||||||
|
|
||||||
|
// Get the current time.
|
||||||
|
static time_type now()
|
||||||
|
{
|
||||||
|
return clock_type::now();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Add a duration to a time.
|
||||||
|
static time_type add(const time_type& t, const duration_type& d)
|
||||||
|
{
|
||||||
|
const time_type epoch;
|
||||||
|
if (t >= epoch)
|
||||||
|
{
|
||||||
|
if ((time_type::max)() - t < d)
|
||||||
|
return (time_type::max)();
|
||||||
|
}
|
||||||
|
else // t < epoch
|
||||||
|
{
|
||||||
|
if (-(t - (time_type::min)()) > d)
|
||||||
|
return (time_type::min)();
|
||||||
|
}
|
||||||
|
|
||||||
|
return t + d;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Subtract one time from another.
|
||||||
|
static duration_type subtract(const time_type& t1, const time_type& t2)
|
||||||
|
{
|
||||||
|
const time_type epoch;
|
||||||
|
if (t1 >= epoch)
|
||||||
|
{
|
||||||
|
if (t2 >= epoch)
|
||||||
|
{
|
||||||
|
return t1 - t2;
|
||||||
|
}
|
||||||
|
else if (t2 == (time_type::min)())
|
||||||
|
{
|
||||||
|
return (duration_type::max)();
|
||||||
|
}
|
||||||
|
else if ((time_type::max)() - t1 < epoch - t2)
|
||||||
|
{
|
||||||
|
return (duration_type::max)();
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return t1 - t2;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else // t1 < epoch
|
||||||
|
{
|
||||||
|
if (t2 < epoch)
|
||||||
|
{
|
||||||
|
return t1 - t2;
|
||||||
|
}
|
||||||
|
else if (t1 == (time_type::min)())
|
||||||
|
{
|
||||||
|
return (duration_type::min)();
|
||||||
|
}
|
||||||
|
else if ((time_type::max)() - t2 < epoch - t1)
|
||||||
|
{
|
||||||
|
return (duration_type::min)();
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
return -(t2 - t1);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Test whether one time is less than another.
|
||||||
|
static bool less_than(const time_type& t1, const time_type& t2)
|
||||||
|
{
|
||||||
|
return t1 < t2;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Implement just enough of the posix_time::time_duration interface to supply
|
||||||
|
// what the timer_queue requires.
|
||||||
|
class posix_time_duration
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit posix_time_duration(const duration_type& d)
|
||||||
|
: d_(d)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
int64_t ticks() const
|
||||||
|
{
|
||||||
|
return d_.count();
|
||||||
|
}
|
||||||
|
|
||||||
|
int64_t total_seconds() const
|
||||||
|
{
|
||||||
|
return duration_cast<1, 1>();
|
||||||
|
}
|
||||||
|
|
||||||
|
int64_t total_milliseconds() const
|
||||||
|
{
|
||||||
|
return duration_cast<1, 1000>();
|
||||||
|
}
|
||||||
|
|
||||||
|
int64_t total_microseconds() const
|
||||||
|
{
|
||||||
|
return duration_cast<1, 1000000>();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
template <int64_t Num, int64_t Den>
|
||||||
|
int64_t duration_cast() const
|
||||||
|
{
|
||||||
|
const int64_t num1 = period_type::num / gcd<period_type::num, Num>::value;
|
||||||
|
const int64_t num2 = Num / gcd<period_type::num, Num>::value;
|
||||||
|
|
||||||
|
const int64_t den1 = period_type::den / gcd<period_type::den, Den>::value;
|
||||||
|
const int64_t den2 = Den / gcd<period_type::den, Den>::value;
|
||||||
|
|
||||||
|
const int64_t num = num1 * den2;
|
||||||
|
const int64_t den = num2 * den1;
|
||||||
|
|
||||||
|
if (num == 1 && den == 1)
|
||||||
|
return ticks();
|
||||||
|
else if (num != 1 && den == 1)
|
||||||
|
return ticks() * num;
|
||||||
|
else if (num == 1 && period_type::den != 1)
|
||||||
|
return ticks() / den;
|
||||||
|
else
|
||||||
|
return ticks() * num / den;
|
||||||
|
}
|
||||||
|
|
||||||
|
duration_type d_;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Convert to POSIX duration type.
|
||||||
|
static posix_time_duration to_posix_duration(const duration_type& d)
|
||||||
|
{
|
||||||
|
return posix_time_duration(WaitTraits::to_wait_duration(d));
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CHRONO_TIME_TRAITS_HPP
|
88
lib/asio-1.26.0/asio/detail/completion_handler.hpp
Normal file
88
lib/asio-1.26.0/asio/detail/completion_handler.hpp
Normal file
|
@ -0,0 +1,88 @@
|
||||||
|
//
|
||||||
|
// detail/completion_handler.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_COMPLETION_HANDLER_HPP
|
||||||
|
#define ASIO_DETAIL_COMPLETION_HANDLER_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/fenced_block.hpp"
|
||||||
|
#include "asio/detail/handler_alloc_helpers.hpp"
|
||||||
|
#include "asio/detail/handler_work.hpp"
|
||||||
|
#include "asio/detail/memory.hpp"
|
||||||
|
#include "asio/detail/operation.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename Handler, typename IoExecutor>
|
||||||
|
class completion_handler : public operation
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
ASIO_DEFINE_HANDLER_PTR(completion_handler);
|
||||||
|
|
||||||
|
completion_handler(Handler& h, const IoExecutor& io_ex)
|
||||||
|
: operation(&completion_handler::do_complete),
|
||||||
|
handler_(ASIO_MOVE_CAST(Handler)(h)),
|
||||||
|
work_(handler_, io_ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
static void do_complete(void* owner, operation* base,
|
||||||
|
const asio::error_code& /*ec*/,
|
||||||
|
std::size_t /*bytes_transferred*/)
|
||||||
|
{
|
||||||
|
// Take ownership of the handler object.
|
||||||
|
completion_handler* h(static_cast<completion_handler*>(base));
|
||||||
|
ptr p = { asio::detail::addressof(h->handler_), h, h };
|
||||||
|
|
||||||
|
ASIO_HANDLER_COMPLETION((*h));
|
||||||
|
|
||||||
|
// Take ownership of the operation's outstanding work.
|
||||||
|
handler_work<Handler, IoExecutor> w(
|
||||||
|
ASIO_MOVE_CAST2(handler_work<Handler, IoExecutor>)(
|
||||||
|
h->work_));
|
||||||
|
|
||||||
|
// Make a copy of the handler so that the memory can be deallocated before
|
||||||
|
// the upcall is made. Even if we're not about to make an upcall, a
|
||||||
|
// sub-object of the handler may be the true owner of the memory associated
|
||||||
|
// with the handler. Consequently, a local copy of the handler is required
|
||||||
|
// to ensure that any owning sub-object remains valid until after we have
|
||||||
|
// deallocated the memory here.
|
||||||
|
Handler handler(ASIO_MOVE_CAST(Handler)(h->handler_));
|
||||||
|
p.h = asio::detail::addressof(handler);
|
||||||
|
p.reset();
|
||||||
|
|
||||||
|
// Make the upcall if required.
|
||||||
|
if (owner)
|
||||||
|
{
|
||||||
|
fenced_block b(fenced_block::half);
|
||||||
|
ASIO_HANDLER_INVOCATION_BEGIN(());
|
||||||
|
w.complete(handler, handler);
|
||||||
|
ASIO_HANDLER_INVOCATION_END;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
Handler handler_;
|
||||||
|
handler_work<Handler, IoExecutor> work_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_COMPLETION_HANDLER_HPP
|
328
lib/asio-1.26.0/asio/detail/composed_work.hpp
Normal file
328
lib/asio-1.26.0/asio/detail/composed_work.hpp
Normal file
|
@ -0,0 +1,328 @@
|
||||||
|
//
|
||||||
|
// detail/composed_work.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_COMPOSED_WORK_HPP
|
||||||
|
#define ASIO_DETAIL_COMPOSED_WORK_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/type_traits.hpp"
|
||||||
|
#include "asio/detail/variadic_templates.hpp"
|
||||||
|
#include "asio/execution/executor.hpp"
|
||||||
|
#include "asio/execution/outstanding_work.hpp"
|
||||||
|
#include "asio/executor_work_guard.hpp"
|
||||||
|
#include "asio/is_executor.hpp"
|
||||||
|
#include "asio/system_executor.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
template <typename Executor, typename = void>
|
||||||
|
class composed_work_guard
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef typename decay<
|
||||||
|
typename prefer_result<Executor,
|
||||||
|
execution::outstanding_work_t::tracked_t
|
||||||
|
>::type
|
||||||
|
>::type executor_type;
|
||||||
|
|
||||||
|
composed_work_guard(const Executor& ex)
|
||||||
|
: executor_(asio::prefer(ex, execution::outstanding_work.tracked))
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
executor_type get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return executor_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
executor_type executor_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct composed_work_guard<system_executor>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef system_executor executor_type;
|
||||||
|
|
||||||
|
composed_work_guard(const system_executor&)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
executor_type get_executor() const ASIO_NOEXCEPT
|
||||||
|
{
|
||||||
|
return system_executor();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_TS_EXECUTORS)
|
||||||
|
|
||||||
|
template <typename Executor>
|
||||||
|
struct composed_work_guard<Executor,
|
||||||
|
typename enable_if<
|
||||||
|
!execution::is_executor<Executor>::value
|
||||||
|
>::type> : executor_work_guard<Executor>
|
||||||
|
{
|
||||||
|
composed_work_guard(const Executor& ex)
|
||||||
|
: executor_work_guard<Executor>(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_TS_EXECUTORS)
|
||||||
|
|
||||||
|
template <typename>
|
||||||
|
struct composed_io_executors;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct composed_io_executors<void()>
|
||||||
|
{
|
||||||
|
composed_io_executors() ASIO_NOEXCEPT
|
||||||
|
: head_(system_executor())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef system_executor head_type;
|
||||||
|
system_executor head_;
|
||||||
|
};
|
||||||
|
|
||||||
|
inline composed_io_executors<void()> make_composed_io_executors()
|
||||||
|
{
|
||||||
|
return composed_io_executors<void()>();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Head>
|
||||||
|
struct composed_io_executors<void(Head)>
|
||||||
|
{
|
||||||
|
explicit composed_io_executors(const Head& ex) ASIO_NOEXCEPT
|
||||||
|
: head_(ex)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef Head head_type;
|
||||||
|
Head head_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Head>
|
||||||
|
inline composed_io_executors<void(Head)>
|
||||||
|
make_composed_io_executors(const Head& head)
|
||||||
|
{
|
||||||
|
return composed_io_executors<void(Head)>(head);
|
||||||
|
}
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Head, typename... Tail>
|
||||||
|
struct composed_io_executors<void(Head, Tail...)>
|
||||||
|
{
|
||||||
|
explicit composed_io_executors(const Head& head,
|
||||||
|
const Tail&... tail) ASIO_NOEXCEPT
|
||||||
|
: head_(head),
|
||||||
|
tail_(tail...)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset()
|
||||||
|
{
|
||||||
|
head_.reset();
|
||||||
|
tail_.reset();
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef Head head_type;
|
||||||
|
Head head_;
|
||||||
|
composed_io_executors<void(Tail...)> tail_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Head, typename... Tail>
|
||||||
|
inline composed_io_executors<void(Head, Tail...)>
|
||||||
|
make_composed_io_executors(const Head& head, const Tail&... tail)
|
||||||
|
{
|
||||||
|
return composed_io_executors<void(Head, Tail...)>(head, tail...);
|
||||||
|
}
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_COMPOSED_IO_EXECUTORS_DEF(n) \
|
||||||
|
template <typename Head, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
struct composed_io_executors<void(Head, ASIO_VARIADIC_TARGS(n))> \
|
||||||
|
{ \
|
||||||
|
explicit composed_io_executors(const Head& head, \
|
||||||
|
ASIO_VARIADIC_CONSTREF_PARAMS(n)) ASIO_NOEXCEPT \
|
||||||
|
: head_(head), \
|
||||||
|
tail_(ASIO_VARIADIC_BYVAL_ARGS(n)) \
|
||||||
|
{ \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
void reset() \
|
||||||
|
{ \
|
||||||
|
head_.reset(); \
|
||||||
|
tail_.reset(); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
typedef Head head_type; \
|
||||||
|
Head head_; \
|
||||||
|
composed_io_executors<void(ASIO_VARIADIC_TARGS(n))> tail_; \
|
||||||
|
}; \
|
||||||
|
\
|
||||||
|
template <typename Head, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
inline composed_io_executors<void(Head, ASIO_VARIADIC_TARGS(n))> \
|
||||||
|
make_composed_io_executors(const Head& head, \
|
||||||
|
ASIO_VARIADIC_CONSTREF_PARAMS(n)) \
|
||||||
|
{ \
|
||||||
|
return composed_io_executors< \
|
||||||
|
void(Head, ASIO_VARIADIC_TARGS(n))>( \
|
||||||
|
head, ASIO_VARIADIC_BYVAL_ARGS(n)); \
|
||||||
|
} \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_COMPOSED_IO_EXECUTORS_DEF)
|
||||||
|
#undef ASIO_PRIVATE_COMPOSED_IO_EXECUTORS_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename>
|
||||||
|
struct composed_work;
|
||||||
|
|
||||||
|
template <>
|
||||||
|
struct composed_work<void()>
|
||||||
|
{
|
||||||
|
typedef composed_io_executors<void()> executors_type;
|
||||||
|
|
||||||
|
composed_work(const executors_type&) ASIO_NOEXCEPT
|
||||||
|
: head_(system_executor())
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset()
|
||||||
|
{
|
||||||
|
head_.reset();
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef system_executor head_type;
|
||||||
|
composed_work_guard<system_executor> head_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Head>
|
||||||
|
struct composed_work<void(Head)>
|
||||||
|
{
|
||||||
|
typedef composed_io_executors<void(Head)> executors_type;
|
||||||
|
|
||||||
|
explicit composed_work(const executors_type& ex) ASIO_NOEXCEPT
|
||||||
|
: head_(ex.head_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset()
|
||||||
|
{
|
||||||
|
head_.reset();
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef Head head_type;
|
||||||
|
composed_work_guard<Head> head_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename Head, typename... Tail>
|
||||||
|
struct composed_work<void(Head, Tail...)>
|
||||||
|
{
|
||||||
|
typedef composed_io_executors<void(Head, Tail...)> executors_type;
|
||||||
|
|
||||||
|
explicit composed_work(const executors_type& ex) ASIO_NOEXCEPT
|
||||||
|
: head_(ex.head_),
|
||||||
|
tail_(ex.tail_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
void reset()
|
||||||
|
{
|
||||||
|
head_.reset();
|
||||||
|
tail_.reset();
|
||||||
|
}
|
||||||
|
|
||||||
|
typedef Head head_type;
|
||||||
|
composed_work_guard<Head> head_;
|
||||||
|
composed_work<void(Tail...)> tail_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#else // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
#define ASIO_PRIVATE_COMPOSED_WORK_DEF(n) \
|
||||||
|
template <typename Head, ASIO_VARIADIC_TPARAMS(n)> \
|
||||||
|
struct composed_work<void(Head, ASIO_VARIADIC_TARGS(n))> \
|
||||||
|
{ \
|
||||||
|
typedef composed_io_executors<void(Head, \
|
||||||
|
ASIO_VARIADIC_TARGS(n))> executors_type; \
|
||||||
|
\
|
||||||
|
explicit composed_work(const executors_type& ex) ASIO_NOEXCEPT \
|
||||||
|
: head_(ex.head_), \
|
||||||
|
tail_(ex.tail_) \
|
||||||
|
{ \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
void reset() \
|
||||||
|
{ \
|
||||||
|
head_.reset(); \
|
||||||
|
tail_.reset(); \
|
||||||
|
} \
|
||||||
|
\
|
||||||
|
typedef Head head_type; \
|
||||||
|
composed_work_guard<Head> head_; \
|
||||||
|
composed_work<void(ASIO_VARIADIC_TARGS(n))> tail_; \
|
||||||
|
}; \
|
||||||
|
/**/
|
||||||
|
ASIO_VARIADIC_GENERATE(ASIO_PRIVATE_COMPOSED_WORK_DEF)
|
||||||
|
#undef ASIO_PRIVATE_COMPOSED_WORK_DEF
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_VARIADIC_TEMPLATES)
|
||||||
|
|
||||||
|
template <typename IoObject>
|
||||||
|
inline typename IoObject::executor_type
|
||||||
|
get_composed_io_executor(IoObject& io_object,
|
||||||
|
typename enable_if<
|
||||||
|
!is_executor<IoObject>::value
|
||||||
|
>::type* = 0,
|
||||||
|
typename enable_if<
|
||||||
|
!execution::is_executor<IoObject>::value
|
||||||
|
>::type* = 0)
|
||||||
|
{
|
||||||
|
return io_object.get_executor();
|
||||||
|
}
|
||||||
|
|
||||||
|
template <typename Executor>
|
||||||
|
inline const Executor& get_composed_io_executor(const Executor& ex,
|
||||||
|
typename enable_if<
|
||||||
|
is_executor<Executor>::value
|
||||||
|
|| execution::is_executor<Executor>::value
|
||||||
|
>::type* = 0)
|
||||||
|
{
|
||||||
|
return ex;
|
||||||
|
}
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_COMPOSED_WORK_HPP
|
94
lib/asio-1.26.0/asio/detail/concurrency_hint.hpp
Normal file
94
lib/asio-1.26.0/asio/detail/concurrency_hint.hpp
Normal file
|
@ -0,0 +1,94 @@
|
||||||
|
//
|
||||||
|
// detail/concurrency_hint.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CONCURRENCY_HINT_HPP
|
||||||
|
#define ASIO_DETAIL_CONCURRENCY_HINT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
|
||||||
|
// The concurrency hint ID and mask are used to identify when a "well-known"
|
||||||
|
// concurrency hint value has been passed to the io_context.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_ID 0xA5100000u
|
||||||
|
#define ASIO_CONCURRENCY_HINT_ID_MASK 0xFFFF0000u
|
||||||
|
|
||||||
|
// If set, this bit indicates that the scheduler should perform locking.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_LOCKING_SCHEDULER 0x1u
|
||||||
|
|
||||||
|
// If set, this bit indicates that the reactor should perform locking when
|
||||||
|
// managing descriptor registrations.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_LOCKING_REACTOR_REGISTRATION 0x2u
|
||||||
|
|
||||||
|
// If set, this bit indicates that the reactor should perform locking for I/O.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_LOCKING_REACTOR_IO 0x4u
|
||||||
|
|
||||||
|
// Helper macro to determine if we have a special concurrency hint.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_IS_SPECIAL(hint) \
|
||||||
|
((static_cast<unsigned>(hint) \
|
||||||
|
& ASIO_CONCURRENCY_HINT_ID_MASK) \
|
||||||
|
== ASIO_CONCURRENCY_HINT_ID)
|
||||||
|
|
||||||
|
// Helper macro to determine if locking is enabled for a given facility.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_IS_LOCKING(facility, hint) \
|
||||||
|
(((static_cast<unsigned>(hint) \
|
||||||
|
& (ASIO_CONCURRENCY_HINT_ID_MASK \
|
||||||
|
| ASIO_CONCURRENCY_HINT_LOCKING_ ## facility)) \
|
||||||
|
^ ASIO_CONCURRENCY_HINT_ID) != 0)
|
||||||
|
|
||||||
|
// This special concurrency hint disables locking in both the scheduler and
|
||||||
|
// reactor I/O. This hint has the following restrictions:
|
||||||
|
//
|
||||||
|
// - Care must be taken to ensure that all operations on the io_context and any
|
||||||
|
// of its associated I/O objects (such as sockets and timers) occur in only
|
||||||
|
// one thread at a time.
|
||||||
|
//
|
||||||
|
// - Asynchronous resolve operations fail with operation_not_supported.
|
||||||
|
//
|
||||||
|
// - If a signal_set is used with the io_context, signal_set objects cannot be
|
||||||
|
// used with any other io_context in the program.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_UNSAFE \
|
||||||
|
static_cast<int>(ASIO_CONCURRENCY_HINT_ID)
|
||||||
|
|
||||||
|
// This special concurrency hint disables locking in the reactor I/O. This hint
|
||||||
|
// has the following restrictions:
|
||||||
|
//
|
||||||
|
// - Care must be taken to ensure that run functions on the io_context, and all
|
||||||
|
// operations on the io_context's associated I/O objects (such as sockets and
|
||||||
|
// timers), occur in only one thread at a time.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_UNSAFE_IO \
|
||||||
|
static_cast<int>(ASIO_CONCURRENCY_HINT_ID \
|
||||||
|
| ASIO_CONCURRENCY_HINT_LOCKING_SCHEDULER \
|
||||||
|
| ASIO_CONCURRENCY_HINT_LOCKING_REACTOR_REGISTRATION)
|
||||||
|
|
||||||
|
// The special concurrency hint provides full thread safety.
|
||||||
|
#define ASIO_CONCURRENCY_HINT_SAFE \
|
||||||
|
static_cast<int>(ASIO_CONCURRENCY_HINT_ID \
|
||||||
|
| ASIO_CONCURRENCY_HINT_LOCKING_SCHEDULER \
|
||||||
|
| ASIO_CONCURRENCY_HINT_LOCKING_REACTOR_REGISTRATION \
|
||||||
|
| ASIO_CONCURRENCY_HINT_LOCKING_REACTOR_IO)
|
||||||
|
|
||||||
|
// This #define may be overridden at compile time to specify a program-wide
|
||||||
|
// default concurrency hint, used by the zero-argument io_context constructor.
|
||||||
|
#if !defined(ASIO_CONCURRENCY_HINT_DEFAULT)
|
||||||
|
# define ASIO_CONCURRENCY_HINT_DEFAULT -1
|
||||||
|
#endif // !defined(ASIO_CONCURRENCY_HINT_DEFAULT)
|
||||||
|
|
||||||
|
// This #define may be overridden at compile time to specify a program-wide
|
||||||
|
// concurrency hint, used by the one-argument io_context constructor when
|
||||||
|
// passed a value of 1.
|
||||||
|
#if !defined(ASIO_CONCURRENCY_HINT_1)
|
||||||
|
# define ASIO_CONCURRENCY_HINT_1 1
|
||||||
|
#endif // !defined(ASIO_CONCURRENCY_HINT_DEFAULT)
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CONCURRENCY_HINT_HPP
|
120
lib/asio-1.26.0/asio/detail/conditionally_enabled_event.hpp
Normal file
120
lib/asio-1.26.0/asio/detail/conditionally_enabled_event.hpp
Normal file
|
@ -0,0 +1,120 @@
|
||||||
|
//
|
||||||
|
// detail/conditionally_enabled_event.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CONDITIONALLY_ENABLED_EVENT_HPP
|
||||||
|
#define ASIO_DETAIL_CONDITIONALLY_ENABLED_EVENT_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/conditionally_enabled_mutex.hpp"
|
||||||
|
#include "asio/detail/event.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/detail/null_event.hpp"
|
||||||
|
#include "asio/detail/scoped_lock.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Mutex adapter used to conditionally enable or disable locking.
|
||||||
|
class conditionally_enabled_event
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Constructor.
|
||||||
|
conditionally_enabled_event()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Destructor.
|
||||||
|
~conditionally_enabled_event()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Signal the event. (Retained for backward compatibility.)
|
||||||
|
void signal(conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
event_.signal(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Signal all waiters.
|
||||||
|
void signal_all(conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
event_.signal_all(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Unlock the mutex and signal one waiter.
|
||||||
|
void unlock_and_signal_one(
|
||||||
|
conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
event_.unlock_and_signal_one(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Unlock the mutex and signal one waiter who may destroy us.
|
||||||
|
void unlock_and_signal_one_for_destruction(
|
||||||
|
conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
event_.unlock_and_signal_one(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
// If there's a waiter, unlock the mutex and signal it.
|
||||||
|
bool maybe_unlock_and_signal_one(
|
||||||
|
conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
return event_.maybe_unlock_and_signal_one(lock);
|
||||||
|
else
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Reset the event.
|
||||||
|
void clear(conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
event_.clear(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Wait for the event to become signalled.
|
||||||
|
void wait(conditionally_enabled_mutex::scoped_lock& lock)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
event_.wait(lock);
|
||||||
|
else
|
||||||
|
null_event().wait(lock);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Timed wait for the event to become signalled.
|
||||||
|
bool wait_for_usec(
|
||||||
|
conditionally_enabled_mutex::scoped_lock& lock, long usec)
|
||||||
|
{
|
||||||
|
if (lock.mutex_.enabled_)
|
||||||
|
return event_.wait_for_usec(lock, usec);
|
||||||
|
else
|
||||||
|
return null_event().wait_for_usec(lock, usec);
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
asio::detail::event event_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CONDITIONALLY_ENABLED_EVENT_HPP
|
149
lib/asio-1.26.0/asio/detail/conditionally_enabled_mutex.hpp
Normal file
149
lib/asio-1.26.0/asio/detail/conditionally_enabled_mutex.hpp
Normal file
|
@ -0,0 +1,149 @@
|
||||||
|
//
|
||||||
|
// detail/conditionally_enabled_mutex.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CONDITIONALLY_ENABLED_MUTEX_HPP
|
||||||
|
#define ASIO_DETAIL_CONDITIONALLY_ENABLED_MUTEX_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include "asio/detail/mutex.hpp"
|
||||||
|
#include "asio/detail/noncopyable.hpp"
|
||||||
|
#include "asio/detail/scoped_lock.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Mutex adapter used to conditionally enable or disable locking.
|
||||||
|
class conditionally_enabled_mutex
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Helper class to lock and unlock a mutex automatically.
|
||||||
|
class scoped_lock
|
||||||
|
: private noncopyable
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Tag type used to distinguish constructors.
|
||||||
|
enum adopt_lock_t { adopt_lock };
|
||||||
|
|
||||||
|
// Constructor adopts a lock that is already held.
|
||||||
|
scoped_lock(conditionally_enabled_mutex& m, adopt_lock_t)
|
||||||
|
: mutex_(m),
|
||||||
|
locked_(m.enabled_)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Constructor acquires the lock.
|
||||||
|
explicit scoped_lock(conditionally_enabled_mutex& m)
|
||||||
|
: mutex_(m)
|
||||||
|
{
|
||||||
|
if (m.enabled_)
|
||||||
|
{
|
||||||
|
mutex_.mutex_.lock();
|
||||||
|
locked_ = true;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
locked_ = false;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Destructor releases the lock.
|
||||||
|
~scoped_lock()
|
||||||
|
{
|
||||||
|
if (locked_)
|
||||||
|
mutex_.mutex_.unlock();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Explicitly acquire the lock.
|
||||||
|
void lock()
|
||||||
|
{
|
||||||
|
if (mutex_.enabled_ && !locked_)
|
||||||
|
{
|
||||||
|
mutex_.mutex_.lock();
|
||||||
|
locked_ = true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Explicitly release the lock.
|
||||||
|
void unlock()
|
||||||
|
{
|
||||||
|
if (locked_)
|
||||||
|
{
|
||||||
|
mutex_.unlock();
|
||||||
|
locked_ = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Test whether the lock is held.
|
||||||
|
bool locked() const
|
||||||
|
{
|
||||||
|
return locked_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the underlying mutex.
|
||||||
|
asio::detail::mutex& mutex()
|
||||||
|
{
|
||||||
|
return mutex_.mutex_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
friend class conditionally_enabled_event;
|
||||||
|
conditionally_enabled_mutex& mutex_;
|
||||||
|
bool locked_;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Constructor.
|
||||||
|
explicit conditionally_enabled_mutex(bool enabled)
|
||||||
|
: enabled_(enabled)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Destructor.
|
||||||
|
~conditionally_enabled_mutex()
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Determine whether locking is enabled.
|
||||||
|
bool enabled() const
|
||||||
|
{
|
||||||
|
return enabled_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Lock the mutex.
|
||||||
|
void lock()
|
||||||
|
{
|
||||||
|
if (enabled_)
|
||||||
|
mutex_.lock();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Unlock the mutex.
|
||||||
|
void unlock()
|
||||||
|
{
|
||||||
|
if (enabled_)
|
||||||
|
mutex_.unlock();
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
friend class scoped_lock;
|
||||||
|
friend class conditionally_enabled_event;
|
||||||
|
asio::detail::mutex mutex_;
|
||||||
|
const bool enabled_;
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CONDITIONALLY_ENABLED_MUTEX_HPP
|
2254
lib/asio-1.26.0/asio/detail/config.hpp
Normal file
2254
lib/asio-1.26.0/asio/detail/config.hpp
Normal file
File diff suppressed because it is too large
Load diff
451
lib/asio-1.26.0/asio/detail/consuming_buffers.hpp
Normal file
451
lib/asio-1.26.0/asio/detail/consuming_buffers.hpp
Normal file
|
@ -0,0 +1,451 @@
|
||||||
|
//
|
||||||
|
// detail/consuming_buffers.hpp
|
||||||
|
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
//
|
||||||
|
// Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||||
|
//
|
||||||
|
// Distributed under the Boost Software License, Version 1.0. (See accompanying
|
||||||
|
// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
//
|
||||||
|
|
||||||
|
#ifndef ASIO_DETAIL_CONSUMING_BUFFERS_HPP
|
||||||
|
#define ASIO_DETAIL_CONSUMING_BUFFERS_HPP
|
||||||
|
|
||||||
|
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
# pragma once
|
||||||
|
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||||
|
|
||||||
|
#include "asio/detail/config.hpp"
|
||||||
|
#include <cstddef>
|
||||||
|
#include "asio/buffer.hpp"
|
||||||
|
#include "asio/detail/buffer_sequence_adapter.hpp"
|
||||||
|
#include "asio/detail/limits.hpp"
|
||||||
|
#include "asio/registered_buffer.hpp"
|
||||||
|
|
||||||
|
#include "asio/detail/push_options.hpp"
|
||||||
|
|
||||||
|
namespace asio {
|
||||||
|
namespace detail {
|
||||||
|
|
||||||
|
// Helper template to determine the maximum number of prepared buffers.
|
||||||
|
template <typename Buffers>
|
||||||
|
struct prepared_buffers_max
|
||||||
|
{
|
||||||
|
enum { value = buffer_sequence_adapter_base::max_buffers };
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Elem, std::size_t N>
|
||||||
|
struct prepared_buffers_max<boost::array<Elem, N> >
|
||||||
|
{
|
||||||
|
enum { value = N };
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
template <typename Elem, std::size_t N>
|
||||||
|
struct prepared_buffers_max<std::array<Elem, N> >
|
||||||
|
{
|
||||||
|
enum { value = N };
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
// A buffer sequence used to represent a subsequence of the buffers.
|
||||||
|
template <typename Buffer, std::size_t MaxBuffers>
|
||||||
|
struct prepared_buffers
|
||||||
|
{
|
||||||
|
typedef Buffer value_type;
|
||||||
|
typedef const Buffer* const_iterator;
|
||||||
|
|
||||||
|
enum { max_buffers = MaxBuffers < 16 ? MaxBuffers : 16 };
|
||||||
|
|
||||||
|
prepared_buffers() : count(0) {}
|
||||||
|
const_iterator begin() const { return elems; }
|
||||||
|
const_iterator end() const { return elems + count; }
|
||||||
|
|
||||||
|
Buffer elems[max_buffers];
|
||||||
|
std::size_t count;
|
||||||
|
};
|
||||||
|
|
||||||
|
// A proxy for a sub-range in a list of buffers.
|
||||||
|
template <typename Buffer, typename Buffers, typename Buffer_Iterator>
|
||||||
|
class consuming_buffers
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
typedef prepared_buffers<Buffer, prepared_buffers_max<Buffers>::value>
|
||||||
|
prepared_buffers_type;
|
||||||
|
|
||||||
|
// Construct to represent the entire list of buffers.
|
||||||
|
explicit consuming_buffers(const Buffers& buffers)
|
||||||
|
: buffers_(buffers),
|
||||||
|
total_consumed_(0),
|
||||||
|
next_elem_(0),
|
||||||
|
next_elem_offset_(0)
|
||||||
|
{
|
||||||
|
using asio::buffer_size;
|
||||||
|
total_size_ = buffer_size(buffers);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Determine if we are at the end of the buffers.
|
||||||
|
bool empty() const
|
||||||
|
{
|
||||||
|
return total_consumed_ >= total_size_;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the buffer for a single transfer, with a size.
|
||||||
|
prepared_buffers_type prepare(std::size_t max_size)
|
||||||
|
{
|
||||||
|
prepared_buffers_type result;
|
||||||
|
|
||||||
|
Buffer_Iterator next = asio::buffer_sequence_begin(buffers_);
|
||||||
|
Buffer_Iterator end = asio::buffer_sequence_end(buffers_);
|
||||||
|
|
||||||
|
std::advance(next, next_elem_);
|
||||||
|
std::size_t elem_offset = next_elem_offset_;
|
||||||
|
while (next != end && max_size > 0 && (result.count) < result.max_buffers)
|
||||||
|
{
|
||||||
|
Buffer next_buf = Buffer(*next) + elem_offset;
|
||||||
|
result.elems[result.count] = asio::buffer(next_buf, max_size);
|
||||||
|
max_size -= result.elems[result.count].size();
|
||||||
|
elem_offset = 0;
|
||||||
|
if (result.elems[result.count].size() > 0)
|
||||||
|
++result.count;
|
||||||
|
++next;
|
||||||
|
}
|
||||||
|
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Consume the specified number of bytes from the buffers.
|
||||||
|
void consume(std::size_t size)
|
||||||
|
{
|
||||||
|
total_consumed_ += size;
|
||||||
|
|
||||||
|
Buffer_Iterator next = asio::buffer_sequence_begin(buffers_);
|
||||||
|
Buffer_Iterator end = asio::buffer_sequence_end(buffers_);
|
||||||
|
|
||||||
|
std::advance(next, next_elem_);
|
||||||
|
while (next != end && size > 0)
|
||||||
|
{
|
||||||
|
Buffer next_buf = Buffer(*next) + next_elem_offset_;
|
||||||
|
if (size < next_buf.size())
|
||||||
|
{
|
||||||
|
next_elem_offset_ += size;
|
||||||
|
size = 0;
|
||||||
|
}
|
||||||
|
else
|
||||||
|
{
|
||||||
|
size -= next_buf.size();
|
||||||
|
next_elem_offset_ = 0;
|
||||||
|
++next_elem_;
|
||||||
|
++next;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the total number of bytes consumed from the buffers.
|
||||||
|
std::size_t total_consumed() const
|
||||||
|
{
|
||||||
|
return total_consumed_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
Buffers buffers_;
|
||||||
|
std::size_t total_size_;
|
||||||
|
std::size_t total_consumed_;
|
||||||
|
std::size_t next_elem_;
|
||||||
|
std::size_t next_elem_offset_;
|
||||||
|
};
|
||||||
|
|
||||||
|
// Base class of all consuming_buffers specialisations for single buffers.
|
||||||
|
template <typename Buffer>
|
||||||
|
class consuming_single_buffer
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Construct to represent the entire list of buffers.
|
||||||
|
template <typename Buffer1>
|
||||||
|
explicit consuming_single_buffer(const Buffer1& buffer)
|
||||||
|
: buffer_(buffer),
|
||||||
|
total_consumed_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Determine if we are at the end of the buffers.
|
||||||
|
bool empty() const
|
||||||
|
{
|
||||||
|
return total_consumed_ >= buffer_.size();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the buffer for a single transfer, with a size.
|
||||||
|
Buffer prepare(std::size_t max_size)
|
||||||
|
{
|
||||||
|
return asio::buffer(buffer_ + total_consumed_, max_size);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Consume the specified number of bytes from the buffers.
|
||||||
|
void consume(std::size_t size)
|
||||||
|
{
|
||||||
|
total_consumed_ += size;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the total number of bytes consumed from the buffers.
|
||||||
|
std::size_t total_consumed() const
|
||||||
|
{
|
||||||
|
return total_consumed_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
Buffer buffer_;
|
||||||
|
std::size_t total_consumed_;
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<mutable_buffer, mutable_buffer, const mutable_buffer*>
|
||||||
|
: public consuming_single_buffer<ASIO_MUTABLE_BUFFER>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const mutable_buffer& buffer)
|
||||||
|
: consuming_single_buffer<ASIO_MUTABLE_BUFFER>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<const_buffer, mutable_buffer, const mutable_buffer*>
|
||||||
|
: public consuming_single_buffer<ASIO_CONST_BUFFER>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const mutable_buffer& buffer)
|
||||||
|
: consuming_single_buffer<ASIO_CONST_BUFFER>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<const_buffer, const_buffer, const const_buffer*>
|
||||||
|
: public consuming_single_buffer<ASIO_CONST_BUFFER>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const const_buffer& buffer)
|
||||||
|
: consuming_single_buffer<ASIO_CONST_BUFFER>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#if !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<mutable_buffer,
|
||||||
|
mutable_buffers_1, const mutable_buffer*>
|
||||||
|
: public consuming_single_buffer<ASIO_MUTABLE_BUFFER>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const mutable_buffers_1& buffer)
|
||||||
|
: consuming_single_buffer<ASIO_MUTABLE_BUFFER>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<const_buffer, mutable_buffers_1, const mutable_buffer*>
|
||||||
|
: public consuming_single_buffer<ASIO_CONST_BUFFER>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const mutable_buffers_1& buffer)
|
||||||
|
: consuming_single_buffer<ASIO_CONST_BUFFER>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<const_buffer, const_buffers_1, const const_buffer*>
|
||||||
|
: public consuming_single_buffer<ASIO_CONST_BUFFER>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const const_buffers_1& buffer)
|
||||||
|
: consuming_single_buffer<ASIO_CONST_BUFFER>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<mutable_buffer,
|
||||||
|
mutable_registered_buffer, const mutable_buffer*>
|
||||||
|
: public consuming_single_buffer<mutable_registered_buffer>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const mutable_registered_buffer& buffer)
|
||||||
|
: consuming_single_buffer<mutable_registered_buffer>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<const_buffer,
|
||||||
|
mutable_registered_buffer, const mutable_buffer*>
|
||||||
|
: public consuming_single_buffer<mutable_registered_buffer>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const mutable_registered_buffer& buffer)
|
||||||
|
: consuming_single_buffer<mutable_registered_buffer>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <>
|
||||||
|
class consuming_buffers<const_buffer,
|
||||||
|
const_registered_buffer, const const_buffer*>
|
||||||
|
: public consuming_single_buffer<const_registered_buffer>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
explicit consuming_buffers(const const_registered_buffer& buffer)
|
||||||
|
: consuming_single_buffer<const_registered_buffer>(buffer)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
template <typename Buffer, typename Elem>
|
||||||
|
class consuming_buffers<Buffer, boost::array<Elem, 2>,
|
||||||
|
typename boost::array<Elem, 2>::const_iterator>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Construct to represent the entire list of buffers.
|
||||||
|
explicit consuming_buffers(const boost::array<Elem, 2>& buffers)
|
||||||
|
: buffers_(buffers),
|
||||||
|
total_consumed_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Determine if we are at the end of the buffers.
|
||||||
|
bool empty() const
|
||||||
|
{
|
||||||
|
return total_consumed_ >=
|
||||||
|
Buffer(buffers_[0]).size() + Buffer(buffers_[1]).size();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the buffer for a single transfer, with a size.
|
||||||
|
boost::array<Buffer, 2> prepare(std::size_t max_size)
|
||||||
|
{
|
||||||
|
boost::array<Buffer, 2> result = {{
|
||||||
|
Buffer(buffers_[0]), Buffer(buffers_[1]) }};
|
||||||
|
std::size_t buffer0_size = result[0].size();
|
||||||
|
result[0] = asio::buffer(result[0] + total_consumed_, max_size);
|
||||||
|
result[1] = asio::buffer(
|
||||||
|
result[1] + (total_consumed_ < buffer0_size
|
||||||
|
? 0 : total_consumed_ - buffer0_size),
|
||||||
|
max_size - result[0].size());
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Consume the specified number of bytes from the buffers.
|
||||||
|
void consume(std::size_t size)
|
||||||
|
{
|
||||||
|
total_consumed_ += size;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the total number of bytes consumed from the buffers.
|
||||||
|
std::size_t total_consumed() const
|
||||||
|
{
|
||||||
|
return total_consumed_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
boost::array<Elem, 2> buffers_;
|
||||||
|
std::size_t total_consumed_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#if defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
template <typename Buffer, typename Elem>
|
||||||
|
class consuming_buffers<Buffer, std::array<Elem, 2>,
|
||||||
|
typename std::array<Elem, 2>::const_iterator>
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
// Construct to represent the entire list of buffers.
|
||||||
|
explicit consuming_buffers(const std::array<Elem, 2>& buffers)
|
||||||
|
: buffers_(buffers),
|
||||||
|
total_consumed_(0)
|
||||||
|
{
|
||||||
|
}
|
||||||
|
|
||||||
|
// Determine if we are at the end of the buffers.
|
||||||
|
bool empty() const
|
||||||
|
{
|
||||||
|
return total_consumed_ >=
|
||||||
|
Buffer(buffers_[0]).size() + Buffer(buffers_[1]).size();
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the buffer for a single transfer, with a size.
|
||||||
|
std::array<Buffer, 2> prepare(std::size_t max_size)
|
||||||
|
{
|
||||||
|
std::array<Buffer, 2> result = {{
|
||||||
|
Buffer(buffers_[0]), Buffer(buffers_[1]) }};
|
||||||
|
std::size_t buffer0_size = result[0].size();
|
||||||
|
result[0] = asio::buffer(result[0] + total_consumed_, max_size);
|
||||||
|
result[1] = asio::buffer(
|
||||||
|
result[1] + (total_consumed_ < buffer0_size
|
||||||
|
? 0 : total_consumed_ - buffer0_size),
|
||||||
|
max_size - result[0].size());
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Consume the specified number of bytes from the buffers.
|
||||||
|
void consume(std::size_t size)
|
||||||
|
{
|
||||||
|
total_consumed_ += size;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Get the total number of bytes consumed from the buffers.
|
||||||
|
std::size_t total_consumed() const
|
||||||
|
{
|
||||||
|
return total_consumed_;
|
||||||
|
}
|
||||||
|
|
||||||
|
private:
|
||||||
|
std::array<Elem, 2> buffers_;
|
||||||
|
std::size_t total_consumed_;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif // defined(ASIO_HAS_STD_ARRAY)
|
||||||
|
|
||||||
|
// Specialisation for null_buffers to ensure that the null_buffers type is
|
||||||
|
// always passed through to the underlying read or write operation.
|
||||||
|
template <typename Buffer>
|
||||||
|
class consuming_buffers<Buffer, null_buffers, const mutable_buffer*>
|
||||||
|
: public asio::null_buffers
|
||||||
|
{
|
||||||
|
public:
|
||||||
|
consuming_buffers(const null_buffers&)
|
||||||
|
{
|
||||||
|
// No-op.
|
||||||
|
}
|
||||||
|
|
||||||
|
bool empty()
|
||||||
|
{
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
|
||||||
|
null_buffers prepare(std::size_t)
|
||||||
|
{
|
||||||
|
return null_buffers();
|
||||||
|
}
|
||||||
|
|
||||||
|
void consume(std::size_t)
|
||||||
|
{
|
||||||
|
// No-op.
|
||||||
|
}
|
||||||
|
|
||||||
|
std::size_t total_consumed() const
|
||||||
|
{
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
} // namespace detail
|
||||||
|
} // namespace asio
|
||||||
|
|
||||||
|
#include "asio/detail/pop_options.hpp"
|
||||||
|
|
||||||
|
#endif // ASIO_DETAIL_CONSUMING_BUFFERS_HPP
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue