first commit
This commit is contained in:
18
.vscode/c_cpp_properties.json
vendored
Normal file
18
.vscode/c_cpp_properties.json
vendored
Normal file
@@ -0,0 +1,18 @@
|
||||
{
|
||||
"configurations": [
|
||||
{
|
||||
"name": "windows-gcc-x64",
|
||||
"includePath": [
|
||||
"${workspaceFolder}/**"
|
||||
],
|
||||
"compilerPath": "C:/Applications/Program Custom/msys2/mingw64/bin/gcc.exe",
|
||||
"cStandard": "${default}",
|
||||
"cppStandard": "${default}",
|
||||
"intelliSenseMode": "windows-gcc-x64",
|
||||
"compilerArgs": [
|
||||
""
|
||||
]
|
||||
}
|
||||
],
|
||||
"version": 4
|
||||
}
|
||||
24
.vscode/launch.json
vendored
Normal file
24
.vscode/launch.json
vendored
Normal file
@@ -0,0 +1,24 @@
|
||||
{
|
||||
"version": "0.2.0",
|
||||
"configurations": [
|
||||
{
|
||||
"name": "C/C++ Runner: Debug Session",
|
||||
"type": "cppdbg",
|
||||
"request": "launch",
|
||||
"args": [],
|
||||
"stopAtEntry": false,
|
||||
"externalConsole": true,
|
||||
"cwd": "c:/Users/anonymous/Desktop/NewProject/Other/UniversalCanCore/Src",
|
||||
"program": "c:/Users/anonymous/Desktop/NewProject/Other/UniversalCanCore/Src/build/Debug/outDebug",
|
||||
"MIMode": "gdb",
|
||||
"miDebuggerPath": "gdb",
|
||||
"setupCommands": [
|
||||
{
|
||||
"description": "Enable pretty-printing for gdb",
|
||||
"text": "-enable-pretty-printing",
|
||||
"ignoreFailures": true
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
59
.vscode/settings.json
vendored
Normal file
59
.vscode/settings.json
vendored
Normal file
@@ -0,0 +1,59 @@
|
||||
{
|
||||
"C_Cpp_Runner.cCompilerPath": "gcc",
|
||||
"C_Cpp_Runner.cppCompilerPath": "g++",
|
||||
"C_Cpp_Runner.debuggerPath": "gdb",
|
||||
"C_Cpp_Runner.cStandard": "",
|
||||
"C_Cpp_Runner.cppStandard": "",
|
||||
"C_Cpp_Runner.msvcBatchPath": "",
|
||||
"C_Cpp_Runner.useMsvc": false,
|
||||
"C_Cpp_Runner.warnings": [
|
||||
"-Wall",
|
||||
"-Wextra",
|
||||
"-Wpedantic",
|
||||
"-Wshadow",
|
||||
"-Wformat=2",
|
||||
"-Wcast-align",
|
||||
"-Wconversion",
|
||||
"-Wsign-conversion",
|
||||
"-Wnull-dereference"
|
||||
],
|
||||
"C_Cpp_Runner.msvcWarnings": [
|
||||
"/W4",
|
||||
"/permissive-",
|
||||
"/w14242",
|
||||
"/w14287",
|
||||
"/w14296",
|
||||
"/w14311",
|
||||
"/w14826",
|
||||
"/w44062",
|
||||
"/w44242",
|
||||
"/w14905",
|
||||
"/w14906",
|
||||
"/w14263",
|
||||
"/w44265",
|
||||
"/w14928"
|
||||
],
|
||||
"C_Cpp_Runner.enableWarnings": true,
|
||||
"C_Cpp_Runner.warningsAsError": false,
|
||||
"C_Cpp_Runner.compilerArgs": [],
|
||||
"C_Cpp_Runner.linkerArgs": [],
|
||||
"C_Cpp_Runner.includePaths": [],
|
||||
"C_Cpp_Runner.includeSearch": [
|
||||
"*",
|
||||
"**/*"
|
||||
],
|
||||
"C_Cpp_Runner.excludeSearch": [
|
||||
"**/build",
|
||||
"**/build/**",
|
||||
"**/.*",
|
||||
"**/.*/**",
|
||||
"**/.vscode",
|
||||
"**/.vscode/**"
|
||||
],
|
||||
"C_Cpp_Runner.useAddressSanitizer": false,
|
||||
"C_Cpp_Runner.useUndefinedSanitizer": false,
|
||||
"C_Cpp_Runner.useLeakSanitizer": false,
|
||||
"C_Cpp_Runner.showCompilationTime": false,
|
||||
"C_Cpp_Runner.useLinkTimeOptimization": false,
|
||||
"C_Cpp_Runner.msvcSecureNoWarnings": false
|
||||
}
|
||||
29
.vscode/tasks.json
vendored
Normal file
29
.vscode/tasks.json
vendored
Normal file
@@ -0,0 +1,29 @@
|
||||
{
|
||||
"tasks": [
|
||||
{
|
||||
"type": "cppbuild",
|
||||
"label": "C/C++: gcc.exe 生成活动文件",
|
||||
"command": "C:/Applications/Program Custom/msys2/mingw64/bin/gcc.exe",
|
||||
"args": [
|
||||
"-fdiagnostics-color=always",
|
||||
"-g",
|
||||
"${file}",
|
||||
"-o",
|
||||
"${fileDirname}\\${fileBasenameNoExtension}.exe",
|
||||
""
|
||||
],
|
||||
"options": {
|
||||
"cwd": "C:/Applications/Program Custom/msys2/mingw64/bin"
|
||||
},
|
||||
"problemMatcher": [
|
||||
"$gcc"
|
||||
],
|
||||
"group": {
|
||||
"kind": "build",
|
||||
"isDefault": true
|
||||
},
|
||||
"detail": "调试器生成的任务。"
|
||||
}
|
||||
],
|
||||
"version": "2.0.0"
|
||||
}
|
||||
9
.xmake/windows/x64/cache/config
vendored
Normal file
9
.xmake/windows/x64/cache/config
vendored
Normal file
@@ -0,0 +1,9 @@
|
||||
{
|
||||
recheck = false,
|
||||
options = {
|
||||
toolchain = "mingw64"
|
||||
},
|
||||
mtimes = {
|
||||
["xmake.lua"] = 1765270728
|
||||
}
|
||||
}
|
||||
55
.xmake/windows/x64/cache/detect
vendored
Normal file
55
.xmake/windows/x64/cache/detect
vendored
Normal file
@@ -0,0 +1,55 @@
|
||||
{
|
||||
find_program_mingw64_arch_x64_plat_windows_checktoolcc = {
|
||||
["C:/Applications/Program Custom/msys2/mingw64/bin/gcc.exe"] = "c:/applications/program custom/msys2/mingw64/bin/gcc.exe"
|
||||
},
|
||||
["core.tools.gcc.has_cflags"] = {
|
||||
["c:/applications/program custom/msys2/mingw64/bin/g++.exe_"] = {
|
||||
["-print-multi-directory"] = true,
|
||||
["-dumpmachine"] = true,
|
||||
["-o"] = true,
|
||||
["-Xlinker"] = true,
|
||||
["-print-search-dirs"] = true,
|
||||
["-print-sysroot-headers-suffix"] = true,
|
||||
["--help"] = true,
|
||||
["-shared"] = true,
|
||||
["-v"] = true,
|
||||
["-save-temps"] = true,
|
||||
["-x"] = true,
|
||||
["-print-libgcc-file-name"] = true,
|
||||
["--param"] = true,
|
||||
["--version"] = true,
|
||||
["-S"] = true,
|
||||
["-pipe"] = true,
|
||||
["-print-multi-os-directory"] = true,
|
||||
["-pie"] = true,
|
||||
["-c"] = true,
|
||||
["-no-canonical-prefixes"] = true,
|
||||
["-print-sysroot"] = true,
|
||||
["-E"] = true,
|
||||
["-Xassembler"] = true,
|
||||
["-print-multi-lib"] = true,
|
||||
["-print-multiarch"] = true,
|
||||
["-B"] = true,
|
||||
["-dumpspecs"] = true,
|
||||
["-pass-exit-codes"] = true,
|
||||
["-Xpreprocessor"] = true,
|
||||
["-dumpversion"] = true,
|
||||
["-time"] = true,
|
||||
["--target-help"] = true
|
||||
}
|
||||
},
|
||||
find_program_mingw64_arch_x64_plat_windows_checktoolcxx = {
|
||||
["C:/Applications/Program Custom/msys2/mingw64/bin/g++.exe"] = "c:/applications/program custom/msys2/mingw64/bin/g++.exe"
|
||||
},
|
||||
find_program = {
|
||||
["c:/applications/program custom/msys2/mingw64/bin/g++.exe"] = "c:/applications/program custom/msys2/mingw64/bin/g++.exe"
|
||||
},
|
||||
find_program_mingw64_arch_x64_plat_windows_checktoolld = {
|
||||
["C:/Applications/Program Custom/msys2/mingw64/bin/g++.exe"] = "c:/applications/program custom/msys2/mingw64/bin/g++.exe"
|
||||
},
|
||||
["lib.detect.has_flags"] = {
|
||||
["windows_x64_c:/applications/program custom/msys2/mingw64/bin/g++.exe__cxx_cxflags__-Wno-gnu-line-marker -Werror"] = true,
|
||||
["windows_x64_c:/applications/program custom/msys2/mingw64/bin/g++.exe__cxx_cxflags__-MMD -MF"] = true,
|
||||
["windows_x64_c:/applications/program custom/msys2/mingw64/bin/g++.exe__cxx_cxflags__-fdiagnostics-color=always"] = true
|
||||
}
|
||||
}
|
||||
69
.xmake/windows/x64/cache/history
vendored
Normal file
69
.xmake/windows/x64/cache/history
vendored
Normal file
@@ -0,0 +1,69 @@
|
||||
{
|
||||
cmdlines = {
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
[[xmake l c:\Users\anonymous\.vscode\extensions\tboox.xmake-vscode-2.4.1\assets\explorer.lua]],
|
||||
"xmake check",
|
||||
[[xmake l c:\Users\anonymous\.vscode\extensions\tboox.xmake-vscode-2.4.1\assets\config.lua]],
|
||||
"xmake f -c",
|
||||
"xmake f --toolchain=mingw64",
|
||||
"xmake ",
|
||||
[[xmake lua "C:\\Program Files\\xmake\\modules\\private\\utils\\statistics.lua"]],
|
||||
[[xmake lua "C:\\Program Files\\xmake\\actions\\build\\cleaner.lua"]],
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
[[xmake l c:\Users\anonymous\.vscode\extensions\tboox.xmake-vscode-2.4.1\assets\explorer.lua]],
|
||||
[[xmake l c:\Users\anonymous\.vscode\extensions\tboox.xmake-vscode-2.4.1\assets\config.lua]],
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake ",
|
||||
"xmake "
|
||||
}
|
||||
}
|
||||
1
.xmake/windows/x64/cache/option
vendored
Normal file
1
.xmake/windows/x64/cache/option
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{ }
|
||||
1
.xmake/windows/x64/cache/package
vendored
Normal file
1
.xmake/windows/x64/cache/package
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{ }
|
||||
1
.xmake/windows/x64/cache/project
vendored
Normal file
1
.xmake/windows/x64/cache/project
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{ }
|
||||
38
.xmake/windows/x64/cache/toolchain
vendored
Normal file
38
.xmake/windows/x64/cache/toolchain
vendored
Normal file
@@ -0,0 +1,38 @@
|
||||
{
|
||||
tool_target_UniversalCanCore_windows_x64_ld = {
|
||||
program = "c:/applications/program custom/msys2/mingw64/bin/g++.exe",
|
||||
toolchain_info = {
|
||||
cachekey = "mingw64_arch_x64_plat_windows",
|
||||
plat = "windows",
|
||||
name = "mingw64",
|
||||
arch = "x64"
|
||||
},
|
||||
toolname = "gxx"
|
||||
},
|
||||
mingw64_arch_x64_plat_windows = {
|
||||
__global = true,
|
||||
plat = "windows",
|
||||
arch = "x64",
|
||||
__checked = true
|
||||
},
|
||||
tool_target_UniversalCanCore_windows_x64_cxx = {
|
||||
program = "c:/applications/program custom/msys2/mingw64/bin/g++.exe",
|
||||
toolchain_info = {
|
||||
cachekey = "mingw64_arch_x64_plat_windows",
|
||||
plat = "windows",
|
||||
name = "mingw64",
|
||||
arch = "x64"
|
||||
},
|
||||
toolname = "gxx"
|
||||
},
|
||||
tool_target_UniversalCanCore_windows_x64_cc = {
|
||||
program = "c:/applications/program custom/msys2/mingw64/bin/gcc.exe",
|
||||
toolchain_info = {
|
||||
cachekey = "mingw64_arch_x64_plat_windows",
|
||||
plat = "windows",
|
||||
name = "mingw64",
|
||||
arch = "x64"
|
||||
},
|
||||
toolname = "gcc"
|
||||
}
|
||||
}
|
||||
0
.xmake/windows/x64/project.lock
Normal file
0
.xmake/windows/x64/project.lock
Normal file
14
.xmake/windows/x64/xmake.conf
Normal file
14
.xmake/windows/x64/xmake.conf
Normal file
@@ -0,0 +1,14 @@
|
||||
{
|
||||
__toolchains_windows_x64 = {
|
||||
"mingw64"
|
||||
},
|
||||
arch = "x64",
|
||||
builddir = "build",
|
||||
ccache = true,
|
||||
host = "windows",
|
||||
kind = "static",
|
||||
mode = "release",
|
||||
ndk_stdcxx = true,
|
||||
plat = "windows",
|
||||
toolchain = "mingw64"
|
||||
}
|
||||
6
Inc/CanReceiveTask.h
Normal file
6
Inc/CanReceiveTask.h
Normal file
@@ -0,0 +1,6 @@
|
||||
#ifndef __CAN_RECEIVE_TASK_H__
|
||||
#define __CAN_RECEIVE_TASK_H__
|
||||
|
||||
#include "System.h"
|
||||
|
||||
#endif
|
||||
8
Inc/SocketApiProtocol.h
Normal file
8
Inc/SocketApiProtocol.h
Normal file
@@ -0,0 +1,8 @@
|
||||
#ifndef __SOCKET_API_PROTOCOL_H__
|
||||
#define __SOCKET_API_PROTOCOL_H__
|
||||
|
||||
#include "System.h"
|
||||
|
||||
void SocketApiProtocolInit(uint32_t SocketPort);
|
||||
|
||||
#endif
|
||||
36
Inc/System.h
Normal file
36
Inc/System.h
Normal file
@@ -0,0 +1,36 @@
|
||||
#ifndef __SYSTEM_H__
|
||||
#define __SYSTEM_H__
|
||||
|
||||
#include "asio.hpp"
|
||||
#include <thread>
|
||||
#include <chrono>
|
||||
#include <iostream>
|
||||
#include <fstream>
|
||||
#include <atomic>
|
||||
#include <stdint.h>
|
||||
|
||||
using TickType_t = uint32_t; //类似FreeRTOS的ms时间数
|
||||
|
||||
#define DISABLE 0x00
|
||||
#define ENABLE 0x01
|
||||
|
||||
#define PRODUCT_SC_HHS_USB_CAN_II 0 //四川和华盛USB-CAN-II
|
||||
#define PRODUCT_ZLG_USB_CAN_II 1 //zlg的USB-CAN-II
|
||||
#define PRODUCT_GC_USB_CAN_II 2 //GC的USB-CAN-II
|
||||
|
||||
typedef struct
|
||||
{
|
||||
int ProductInfo; //产品信息
|
||||
int logEn; //日志记录开关
|
||||
int CanOpenStatus[2]; //CAN通道状态
|
||||
}SystemConfig;
|
||||
|
||||
extern SystemConfig SystemCall;
|
||||
|
||||
void logAdd(const std::string& filename, const std::string& content);
|
||||
void SystemCallInit(void);
|
||||
void vTaskDelay(TickType_t ms);
|
||||
|
||||
|
||||
|
||||
#endif
|
||||
4
Packages/asio-1.36.0/COPYING
vendored
Normal file
4
Packages/asio-1.36.0/COPYING
vendored
Normal file
@@ -0,0 +1,4 @@
|
||||
Copyright (c) 2003-2025 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)
|
||||
5
Packages/asio-1.36.0/INSTALL
vendored
Normal file
5
Packages/asio-1.36.0/INSTALL
vendored
Normal file
@@ -0,0 +1,5 @@
|
||||
See doc/index.html for information on:
|
||||
- External dependencies
|
||||
- Using, building, and configuring Asio
|
||||
- Supported platforms
|
||||
- How to build the tests and examples
|
||||
23
Packages/asio-1.36.0/LICENSE_1_0.txt
vendored
Normal file
23
Packages/asio-1.36.0/LICENSE_1_0.txt
vendored
Normal file
@@ -0,0 +1,23 @@
|
||||
Boost Software License - Version 1.0 - August 17th, 2003
|
||||
|
||||
Permission is hereby granted, free of charge, to any person or organization
|
||||
obtaining a copy of the software and accompanying documentation covered by
|
||||
this license (the "Software") to use, reproduce, display, distribute,
|
||||
execute, and transmit the Software, and to prepare derivative works of the
|
||||
Software, and to permit third-parties to whom the Software is furnished to
|
||||
do so, all subject to the following:
|
||||
|
||||
The copyright notices in the Software and this entire statement, including
|
||||
the above license grant, this restriction and the following disclaimer,
|
||||
must be included in all copies of the Software, in whole or in part, and
|
||||
all derivative works of the Software, unless such copies or derivative
|
||||
works are solely in the form of machine-executable object code generated by
|
||||
a source language processor.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
|
||||
SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
|
||||
FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
|
||||
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
||||
DEALINGS IN THE SOFTWARE.
|
||||
22
Packages/asio-1.36.0/Makefile.am
vendored
Normal file
22
Packages/asio-1.36.0/Makefile.am
vendored
Normal file
@@ -0,0 +1,22 @@
|
||||
AUTOMAKE_OPTIONS = foreign dist-bzip2 dist-zip parallel-tests
|
||||
|
||||
noarch_pkgconfigdir = $(datadir)/pkgconfig
|
||||
noarch_pkgconfig_DATA = asio.pc
|
||||
|
||||
SUBDIRS = include src
|
||||
|
||||
MAINTAINERCLEANFILES = \
|
||||
$(srcdir)/aclocal.m4 \
|
||||
$(srcdir)/configure \
|
||||
$(srcdir)/config.guess \
|
||||
$(srcdir)/config.sub \
|
||||
$(srcdir)/depcomp \
|
||||
$(srcdir)/install-sh \
|
||||
$(srcdir)/missing \
|
||||
$(srcdir)/mkinstalldirs \
|
||||
$(srcdir)/Makefile.in \
|
||||
asio-*.tar.gz
|
||||
|
||||
EXTRA_DIST = \
|
||||
LICENSE_1_0.txt \
|
||||
doc
|
||||
857
Packages/asio-1.36.0/Makefile.in
vendored
Normal file
857
Packages/asio-1.36.0/Makefile.in
vendored
Normal file
@@ -0,0 +1,857 @@
|
||||
# Makefile.in generated by automake 1.17 from Makefile.am.
|
||||
# @configure_input@
|
||||
|
||||
# Copyright (C) 1994-2024 Free Software Foundation, Inc.
|
||||
|
||||
# This Makefile.in is free software; the Free Software Foundation
|
||||
# gives unlimited permission to copy and/or distribute it,
|
||||
# with or without modifications, as long as this notice is preserved.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
|
||||
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
|
||||
# PARTICULAR PURPOSE.
|
||||
|
||||
@SET_MAKE@
|
||||
|
||||
VPATH = @srcdir@
|
||||
am__is_gnu_make = { \
|
||||
if test -z '$(MAKELEVEL)'; then \
|
||||
false; \
|
||||
elif test -n '$(MAKE_HOST)'; then \
|
||||
true; \
|
||||
elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
|
||||
true; \
|
||||
else \
|
||||
false; \
|
||||
fi; \
|
||||
}
|
||||
am__make_running_with_option = \
|
||||
case $${target_option-} in \
|
||||
?) ;; \
|
||||
*) echo "am__make_running_with_option: internal error: invalid" \
|
||||
"target option '$${target_option-}' specified" >&2; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
has_opt=no; \
|
||||
sane_makeflags=$$MAKEFLAGS; \
|
||||
if $(am__is_gnu_make); then \
|
||||
sane_makeflags=$$MFLAGS; \
|
||||
else \
|
||||
case $$MAKEFLAGS in \
|
||||
*\\[\ \ ]*) \
|
||||
bs=\\; \
|
||||
sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \
|
||||
| sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \
|
||||
esac; \
|
||||
fi; \
|
||||
skip_next=no; \
|
||||
strip_trailopt () \
|
||||
{ \
|
||||
flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \
|
||||
}; \
|
||||
for flg in $$sane_makeflags; do \
|
||||
test $$skip_next = yes && { skip_next=no; continue; }; \
|
||||
case $$flg in \
|
||||
*=*|--*) continue;; \
|
||||
-*I) strip_trailopt 'I'; skip_next=yes;; \
|
||||
-*I?*) strip_trailopt 'I';; \
|
||||
-*O) strip_trailopt 'O'; skip_next=yes;; \
|
||||
-*O?*) strip_trailopt 'O';; \
|
||||
-*l) strip_trailopt 'l'; skip_next=yes;; \
|
||||
-*l?*) strip_trailopt 'l';; \
|
||||
-[dEDm]) skip_next=yes;; \
|
||||
-[JT]) skip_next=yes;; \
|
||||
esac; \
|
||||
case $$flg in \
|
||||
*$$target_option*) has_opt=yes; break;; \
|
||||
esac; \
|
||||
done; \
|
||||
test $$has_opt = yes
|
||||
am__make_dryrun = (target_option=n; $(am__make_running_with_option))
|
||||
am__make_keepgoing = (target_option=k; $(am__make_running_with_option))
|
||||
am__rm_f = rm -f $(am__rm_f_notfound)
|
||||
am__rm_rf = rm -rf $(am__rm_f_notfound)
|
||||
pkgdatadir = $(datadir)/@PACKAGE@
|
||||
pkgincludedir = $(includedir)/@PACKAGE@
|
||||
pkglibdir = $(libdir)/@PACKAGE@
|
||||
pkglibexecdir = $(libexecdir)/@PACKAGE@
|
||||
am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
|
||||
install_sh_DATA = $(install_sh) -c -m 644
|
||||
install_sh_PROGRAM = $(install_sh) -c
|
||||
install_sh_SCRIPT = $(install_sh) -c
|
||||
INSTALL_HEADER = $(INSTALL_DATA)
|
||||
transform = $(program_transform_name)
|
||||
NORMAL_INSTALL = :
|
||||
PRE_INSTALL = :
|
||||
POST_INSTALL = :
|
||||
NORMAL_UNINSTALL = :
|
||||
PRE_UNINSTALL = :
|
||||
POST_UNINSTALL = :
|
||||
build_triplet = @build@
|
||||
host_triplet = @host@
|
||||
subdir = .
|
||||
ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
|
||||
am__aclocal_m4_deps = $(top_srcdir)/configure.ac
|
||||
am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
|
||||
$(ACLOCAL_M4)
|
||||
DIST_COMMON = $(srcdir)/Makefile.am $(top_srcdir)/configure \
|
||||
$(am__configure_deps) $(am__DIST_COMMON)
|
||||
am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \
|
||||
configure.lineno config.status.lineno
|
||||
mkinstalldirs = $(install_sh) -d
|
||||
CONFIG_CLEAN_FILES = asio.pc
|
||||
CONFIG_CLEAN_VPATH_FILES =
|
||||
AM_V_P = $(am__v_P_@AM_V@)
|
||||
am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
|
||||
am__v_P_0 = false
|
||||
am__v_P_1 = :
|
||||
AM_V_GEN = $(am__v_GEN_@AM_V@)
|
||||
am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
|
||||
am__v_GEN_0 = @echo " GEN " $@;
|
||||
am__v_GEN_1 =
|
||||
AM_V_at = $(am__v_at_@AM_V@)
|
||||
am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
|
||||
am__v_at_0 = @
|
||||
am__v_at_1 =
|
||||
SOURCES =
|
||||
DIST_SOURCES =
|
||||
RECURSIVE_TARGETS = all-recursive check-recursive cscopelist-recursive \
|
||||
ctags-recursive dvi-recursive html-recursive info-recursive \
|
||||
install-data-recursive install-dvi-recursive \
|
||||
install-exec-recursive install-html-recursive \
|
||||
install-info-recursive install-pdf-recursive \
|
||||
install-ps-recursive install-recursive installcheck-recursive \
|
||||
installdirs-recursive pdf-recursive ps-recursive \
|
||||
tags-recursive uninstall-recursive
|
||||
am__can_run_installinfo = \
|
||||
case $$AM_UPDATE_INFO_DIR in \
|
||||
n|no|NO) false;; \
|
||||
*) (install-info --version) >/dev/null 2>&1;; \
|
||||
esac
|
||||
am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
|
||||
am__vpath_adj = case $$p in \
|
||||
$(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
|
||||
*) f=$$p;; \
|
||||
esac;
|
||||
am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
|
||||
am__install_max = 40
|
||||
am__nobase_strip_setup = \
|
||||
srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
|
||||
am__nobase_strip = \
|
||||
for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
|
||||
am__nobase_list = $(am__nobase_strip_setup); \
|
||||
for p in $$list; do echo "$$p $$p"; done | \
|
||||
sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
|
||||
$(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
|
||||
if (++n[$$2] == $(am__install_max)) \
|
||||
{ print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
|
||||
END { for (dir in files) print dir, files[dir] }'
|
||||
am__base_list = \
|
||||
sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
|
||||
sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
|
||||
am__uninstall_files_from_dir = { \
|
||||
{ test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
|
||||
|| { echo " ( cd '$$dir' && rm -f" $$files ")"; \
|
||||
$(am__cd) "$$dir" && echo $$files | $(am__xargs_n) 40 $(am__rm_f); }; \
|
||||
}
|
||||
am__installdirs = "$(DESTDIR)$(noarch_pkgconfigdir)"
|
||||
DATA = $(noarch_pkgconfig_DATA)
|
||||
RECURSIVE_CLEAN_TARGETS = mostlyclean-recursive clean-recursive \
|
||||
distclean-recursive maintainer-clean-recursive
|
||||
am__recursive_targets = \
|
||||
$(RECURSIVE_TARGETS) \
|
||||
$(RECURSIVE_CLEAN_TARGETS) \
|
||||
$(am__extra_recursive_targets)
|
||||
AM_RECURSIVE_TARGETS = $(am__recursive_targets:-recursive=) TAGS CTAGS \
|
||||
cscope distdir distdir-am dist dist-all distcheck
|
||||
am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
|
||||
# Read a list of newline-separated strings from the standard input,
|
||||
# and print each of them once, without duplicates. Input order is
|
||||
# *not* preserved.
|
||||
am__uniquify_input = $(AWK) '\
|
||||
BEGIN { nonempty = 0; } \
|
||||
{ items[$$0] = 1; nonempty = 1; } \
|
||||
END { if (nonempty) { for (i in items) print i; }; } \
|
||||
'
|
||||
# Make sure the list of sources is unique. This is necessary because,
|
||||
# e.g., the same source file might be shared among _SOURCES variables
|
||||
# for different programs/libraries.
|
||||
am__define_uniq_tagged_files = \
|
||||
list='$(am__tagged_files)'; \
|
||||
unique=`for i in $$list; do \
|
||||
if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
|
||||
done | $(am__uniquify_input)`
|
||||
DIST_SUBDIRS = $(SUBDIRS)
|
||||
am__DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/asio.pc.in COPYING \
|
||||
INSTALL README compile config.guess config.sub depcomp \
|
||||
install-sh missing
|
||||
DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
|
||||
distdir = $(PACKAGE)-$(VERSION)
|
||||
top_distdir = $(distdir)
|
||||
am__remove_distdir = \
|
||||
if test -d "$(distdir)"; then \
|
||||
find "$(distdir)" -type d ! -perm -700 -exec chmod u+rwx {} ';' \
|
||||
; rm -rf "$(distdir)" \
|
||||
|| { sleep 5 && rm -rf "$(distdir)"; }; \
|
||||
else :; fi
|
||||
am__post_remove_distdir = $(am__remove_distdir)
|
||||
am__relativize = \
|
||||
dir0=`pwd`; \
|
||||
sed_first='s,^\([^/]*\)/.*$$,\1,'; \
|
||||
sed_rest='s,^[^/]*/*,,'; \
|
||||
sed_last='s,^.*/\([^/]*\)$$,\1,'; \
|
||||
sed_butlast='s,/*[^/]*$$,,'; \
|
||||
while test -n "$$dir1"; do \
|
||||
first=`echo "$$dir1" | sed -e "$$sed_first"`; \
|
||||
if test "$$first" != "."; then \
|
||||
if test "$$first" = ".."; then \
|
||||
dir2=`echo "$$dir0" | sed -e "$$sed_last"`/"$$dir2"; \
|
||||
dir0=`echo "$$dir0" | sed -e "$$sed_butlast"`; \
|
||||
else \
|
||||
first2=`echo "$$dir2" | sed -e "$$sed_first"`; \
|
||||
if test "$$first2" = "$$first"; then \
|
||||
dir2=`echo "$$dir2" | sed -e "$$sed_rest"`; \
|
||||
else \
|
||||
dir2="../$$dir2"; \
|
||||
fi; \
|
||||
dir0="$$dir0"/"$$first"; \
|
||||
fi; \
|
||||
fi; \
|
||||
dir1=`echo "$$dir1" | sed -e "$$sed_rest"`; \
|
||||
done; \
|
||||
reldir="$$dir2"
|
||||
DIST_ARCHIVES = $(distdir).tar.gz $(distdir).tar.bz2 $(distdir).zip
|
||||
GZIP_ENV = -9
|
||||
DIST_TARGETS = dist-bzip2 dist-gzip dist-zip
|
||||
# Exists only to be overridden by the user if desired.
|
||||
AM_DISTCHECK_DVI_TARGET = dvi
|
||||
distuninstallcheck_listfiles = find . -type f -print
|
||||
am__distuninstallcheck_listfiles = $(distuninstallcheck_listfiles) \
|
||||
| sed 's|^\./|$(prefix)/|' | grep -v '$(infodir)/dir$$'
|
||||
distcleancheck_listfiles = \
|
||||
find . \( -type f -a \! \
|
||||
\( -name .nfs* -o -name .smb* -o -name .__afs* \) \) -print
|
||||
ACLOCAL = @ACLOCAL@
|
||||
AMTAR = @AMTAR@
|
||||
AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
|
||||
AUTOCONF = @AUTOCONF@
|
||||
AUTOHEADER = @AUTOHEADER@
|
||||
AUTOMAKE = @AUTOMAKE@
|
||||
AWK = @AWK@
|
||||
CC = @CC@
|
||||
CCDEPMODE = @CCDEPMODE@
|
||||
CFLAGS = @CFLAGS@
|
||||
CPPFLAGS = @CPPFLAGS@
|
||||
CSCOPE = @CSCOPE@
|
||||
CTAGS = @CTAGS@
|
||||
CXX = @CXX@
|
||||
CXXDEPMODE = @CXXDEPMODE@
|
||||
CXXFLAGS = @CXXFLAGS@
|
||||
CYGPATH_W = @CYGPATH_W@
|
||||
DEFS = @DEFS@
|
||||
DEPDIR = @DEPDIR@
|
||||
ECHO_C = @ECHO_C@
|
||||
ECHO_N = @ECHO_N@
|
||||
ECHO_T = @ECHO_T@
|
||||
ETAGS = @ETAGS@
|
||||
EXEEXT = @EXEEXT@
|
||||
INSTALL = @INSTALL@
|
||||
INSTALL_DATA = @INSTALL_DATA@
|
||||
INSTALL_PROGRAM = @INSTALL_PROGRAM@
|
||||
INSTALL_SCRIPT = @INSTALL_SCRIPT@
|
||||
INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
|
||||
LDFLAGS = @LDFLAGS@
|
||||
LIBOBJS = @LIBOBJS@
|
||||
LIBS = @LIBS@
|
||||
LTLIBOBJS = @LTLIBOBJS@
|
||||
MAINT = @MAINT@
|
||||
MAKEINFO = @MAKEINFO@
|
||||
MKDIR_P = @MKDIR_P@
|
||||
OBJEXT = @OBJEXT@
|
||||
PACKAGE = @PACKAGE@
|
||||
PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
|
||||
PACKAGE_NAME = @PACKAGE_NAME@
|
||||
PACKAGE_STRING = @PACKAGE_STRING@
|
||||
PACKAGE_TARNAME = @PACKAGE_TARNAME@
|
||||
PACKAGE_URL = @PACKAGE_URL@
|
||||
PACKAGE_VERSION = @PACKAGE_VERSION@
|
||||
PATH_SEPARATOR = @PATH_SEPARATOR@
|
||||
RANLIB = @RANLIB@
|
||||
SET_MAKE = @SET_MAKE@
|
||||
SHELL = @SHELL@
|
||||
STRIP = @STRIP@
|
||||
VERSION = @VERSION@
|
||||
abs_builddir = @abs_builddir@
|
||||
abs_srcdir = @abs_srcdir@
|
||||
abs_top_builddir = @abs_top_builddir@
|
||||
abs_top_srcdir = @abs_top_srcdir@
|
||||
ac_ct_CC = @ac_ct_CC@
|
||||
ac_ct_CXX = @ac_ct_CXX@
|
||||
am__include = @am__include@
|
||||
am__leading_dot = @am__leading_dot@
|
||||
am__quote = @am__quote@
|
||||
am__rm_f_notfound = @am__rm_f_notfound@
|
||||
am__tar = @am__tar@
|
||||
am__untar = @am__untar@
|
||||
am__xargs_n = @am__xargs_n@
|
||||
bindir = @bindir@
|
||||
build = @build@
|
||||
build_alias = @build_alias@
|
||||
build_cpu = @build_cpu@
|
||||
build_os = @build_os@
|
||||
build_vendor = @build_vendor@
|
||||
builddir = @builddir@
|
||||
datadir = @datadir@
|
||||
datarootdir = @datarootdir@
|
||||
docdir = @docdir@
|
||||
dvidir = @dvidir@
|
||||
exec_prefix = @exec_prefix@
|
||||
host = @host@
|
||||
host_alias = @host_alias@
|
||||
host_cpu = @host_cpu@
|
||||
host_os = @host_os@
|
||||
host_vendor = @host_vendor@
|
||||
htmldir = @htmldir@
|
||||
includedir = @includedir@
|
||||
infodir = @infodir@
|
||||
install_sh = @install_sh@
|
||||
libdir = @libdir@
|
||||
libexecdir = @libexecdir@
|
||||
localedir = @localedir@
|
||||
localstatedir = @localstatedir@
|
||||
mandir = @mandir@
|
||||
mkdir_p = @mkdir_p@
|
||||
oldincludedir = @oldincludedir@
|
||||
pdfdir = @pdfdir@
|
||||
prefix = @prefix@
|
||||
program_transform_name = @program_transform_name@
|
||||
psdir = @psdir@
|
||||
runstatedir = @runstatedir@
|
||||
sbindir = @sbindir@
|
||||
sharedstatedir = @sharedstatedir@
|
||||
srcdir = @srcdir@
|
||||
sysconfdir = @sysconfdir@
|
||||
target_alias = @target_alias@
|
||||
top_build_prefix = @top_build_prefix@
|
||||
top_builddir = @top_builddir@
|
||||
top_srcdir = @top_srcdir@
|
||||
AUTOMAKE_OPTIONS = foreign dist-bzip2 dist-zip parallel-tests
|
||||
noarch_pkgconfigdir = $(datadir)/pkgconfig
|
||||
noarch_pkgconfig_DATA = asio.pc
|
||||
SUBDIRS = include src
|
||||
MAINTAINERCLEANFILES = \
|
||||
$(srcdir)/aclocal.m4 \
|
||||
$(srcdir)/configure \
|
||||
$(srcdir)/config.guess \
|
||||
$(srcdir)/config.sub \
|
||||
$(srcdir)/depcomp \
|
||||
$(srcdir)/install-sh \
|
||||
$(srcdir)/missing \
|
||||
$(srcdir)/mkinstalldirs \
|
||||
$(srcdir)/Makefile.in \
|
||||
asio-*.tar.gz
|
||||
|
||||
EXTRA_DIST = \
|
||||
LICENSE_1_0.txt \
|
||||
doc
|
||||
|
||||
all: all-recursive
|
||||
|
||||
.SUFFIXES:
|
||||
am--refresh: Makefile
|
||||
@:
|
||||
$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps)
|
||||
@for dep in $?; do \
|
||||
case '$(am__configure_deps)' in \
|
||||
*$$dep*) \
|
||||
echo ' cd $(srcdir) && $(AUTOMAKE) --foreign'; \
|
||||
$(am__cd) $(srcdir) && $(AUTOMAKE) --foreign \
|
||||
&& exit 0; \
|
||||
exit 1;; \
|
||||
esac; \
|
||||
done; \
|
||||
echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign Makefile'; \
|
||||
$(am__cd) $(top_srcdir) && \
|
||||
$(AUTOMAKE) --foreign Makefile
|
||||
Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
|
||||
@case '$?' in \
|
||||
*config.status*) \
|
||||
echo ' $(SHELL) ./config.status'; \
|
||||
$(SHELL) ./config.status;; \
|
||||
*) \
|
||||
echo ' cd $(top_builddir) && $(SHELL) ./config.status $@ $(am__maybe_remake_depfiles)'; \
|
||||
cd $(top_builddir) && $(SHELL) ./config.status $@ $(am__maybe_remake_depfiles);; \
|
||||
esac;
|
||||
|
||||
$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
|
||||
$(SHELL) ./config.status --recheck
|
||||
|
||||
$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
|
||||
$(am__cd) $(srcdir) && $(AUTOCONF)
|
||||
$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
|
||||
$(am__cd) $(srcdir) && $(ACLOCAL) $(ACLOCAL_AMFLAGS)
|
||||
$(am__aclocal_m4_deps):
|
||||
asio.pc: $(top_builddir)/config.status $(srcdir)/asio.pc.in
|
||||
cd $(top_builddir) && $(SHELL) ./config.status $@
|
||||
install-noarch_pkgconfigDATA: $(noarch_pkgconfig_DATA)
|
||||
@$(NORMAL_INSTALL)
|
||||
@list='$(noarch_pkgconfig_DATA)'; test -n "$(noarch_pkgconfigdir)" || list=; \
|
||||
if test -n "$$list"; then \
|
||||
echo " $(MKDIR_P) '$(DESTDIR)$(noarch_pkgconfigdir)'"; \
|
||||
$(MKDIR_P) "$(DESTDIR)$(noarch_pkgconfigdir)" || exit 1; \
|
||||
fi; \
|
||||
for p in $$list; do \
|
||||
if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \
|
||||
echo "$$d$$p"; \
|
||||
done | $(am__base_list) | \
|
||||
while read files; do \
|
||||
echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(noarch_pkgconfigdir)'"; \
|
||||
$(INSTALL_DATA) $$files "$(DESTDIR)$(noarch_pkgconfigdir)" || exit $$?; \
|
||||
done
|
||||
|
||||
uninstall-noarch_pkgconfigDATA:
|
||||
@$(NORMAL_UNINSTALL)
|
||||
@list='$(noarch_pkgconfig_DATA)'; test -n "$(noarch_pkgconfigdir)" || list=; \
|
||||
files=`for p in $$list; do echo $$p; done | sed -e 's|^.*/||'`; \
|
||||
dir='$(DESTDIR)$(noarch_pkgconfigdir)'; $(am__uninstall_files_from_dir)
|
||||
|
||||
# This directory's subdirectories are mostly independent; you can cd
|
||||
# into them and run 'make' without going through this Makefile.
|
||||
# To change the values of 'make' variables: instead of editing Makefiles,
|
||||
# (1) if the variable is set in 'config.status', edit 'config.status'
|
||||
# (which will cause the Makefiles to be regenerated when you run 'make');
|
||||
# (2) otherwise, pass the desired values on the 'make' command line.
|
||||
$(am__recursive_targets):
|
||||
@fail=; \
|
||||
if $(am__make_keepgoing); then \
|
||||
failcom='fail=yes'; \
|
||||
else \
|
||||
failcom='exit 1'; \
|
||||
fi; \
|
||||
dot_seen=no; \
|
||||
target=`echo $@ | sed s/-recursive//`; \
|
||||
case "$@" in \
|
||||
distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \
|
||||
*) list='$(SUBDIRS)' ;; \
|
||||
esac; \
|
||||
for subdir in $$list; do \
|
||||
echo "Making $$target in $$subdir"; \
|
||||
if test "$$subdir" = "."; then \
|
||||
dot_seen=yes; \
|
||||
local_target="$$target-am"; \
|
||||
else \
|
||||
local_target="$$target"; \
|
||||
fi; \
|
||||
($(am__cd) $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
|
||||
|| eval $$failcom; \
|
||||
done; \
|
||||
if test "$$dot_seen" = "no"; then \
|
||||
$(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \
|
||||
fi; test -z "$$fail"
|
||||
|
||||
ID: $(am__tagged_files)
|
||||
$(am__define_uniq_tagged_files); mkid -fID $$unique
|
||||
tags: tags-recursive
|
||||
TAGS: tags
|
||||
|
||||
tags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files)
|
||||
set x; \
|
||||
here=`pwd`; \
|
||||
if ($(ETAGS) --etags-include --version) >/dev/null 2>&1; then \
|
||||
include_option=--etags-include; \
|
||||
empty_fix=.; \
|
||||
else \
|
||||
include_option=--include; \
|
||||
empty_fix=; \
|
||||
fi; \
|
||||
list='$(SUBDIRS)'; for subdir in $$list; do \
|
||||
if test "$$subdir" = .; then :; else \
|
||||
test ! -f $$subdir/TAGS || \
|
||||
set "$$@" "$$include_option=$$here/$$subdir/TAGS"; \
|
||||
fi; \
|
||||
done; \
|
||||
$(am__define_uniq_tagged_files); \
|
||||
shift; \
|
||||
if test -z "$(ETAGS_ARGS)$$*$$unique"; then :; else \
|
||||
test -n "$$unique" || unique=$$empty_fix; \
|
||||
if test $$# -gt 0; then \
|
||||
$(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
|
||||
"$$@" $$unique; \
|
||||
else \
|
||||
$(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
|
||||
$$unique; \
|
||||
fi; \
|
||||
fi
|
||||
ctags: ctags-recursive
|
||||
|
||||
CTAGS: ctags
|
||||
ctags-am: $(TAGS_DEPENDENCIES) $(am__tagged_files)
|
||||
$(am__define_uniq_tagged_files); \
|
||||
test -z "$(CTAGS_ARGS)$$unique" \
|
||||
|| $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
|
||||
$$unique
|
||||
|
||||
GTAGS:
|
||||
here=`$(am__cd) $(top_builddir) && pwd` \
|
||||
&& $(am__cd) $(top_srcdir) \
|
||||
&& gtags -i $(GTAGS_ARGS) "$$here"
|
||||
cscope: cscope.files
|
||||
test ! -s cscope.files \
|
||||
|| $(CSCOPE) -b -q $(AM_CSCOPEFLAGS) $(CSCOPEFLAGS) -i cscope.files $(CSCOPE_ARGS)
|
||||
clean-cscope:
|
||||
-rm -f cscope.files
|
||||
cscope.files: clean-cscope cscopelist
|
||||
cscopelist: cscopelist-recursive
|
||||
|
||||
cscopelist-am: $(am__tagged_files)
|
||||
list='$(am__tagged_files)'; \
|
||||
case "$(srcdir)" in \
|
||||
[\\/]* | ?:[\\/]*) sdir="$(srcdir)" ;; \
|
||||
*) sdir=$(subdir)/$(srcdir) ;; \
|
||||
esac; \
|
||||
for i in $$list; do \
|
||||
if test -f "$$i"; then \
|
||||
echo "$(subdir)/$$i"; \
|
||||
else \
|
||||
echo "$$sdir/$$i"; \
|
||||
fi; \
|
||||
done >> $(top_builddir)/cscope.files
|
||||
|
||||
distclean-tags:
|
||||
-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
|
||||
-rm -f cscope.out cscope.in.out cscope.po.out cscope.files
|
||||
distdir: $(BUILT_SOURCES)
|
||||
$(MAKE) $(AM_MAKEFLAGS) distdir-am
|
||||
|
||||
distdir-am: $(DISTFILES)
|
||||
$(am__remove_distdir)
|
||||
$(AM_V_at)$(MKDIR_P) "$(distdir)"
|
||||
@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
|
||||
list='$(DISTFILES)'; \
|
||||
dist_files=`for file in $$list; do echo $$file; done | \
|
||||
sed -e "s|^$$srcdirstrip/||;t" \
|
||||
-e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
|
||||
case $$dist_files in \
|
||||
*/*) $(MKDIR_P) `echo "$$dist_files" | \
|
||||
sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
|
||||
sort -u` ;; \
|
||||
esac; \
|
||||
for file in $$dist_files; do \
|
||||
if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
|
||||
if test -d $$d/$$file; then \
|
||||
dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
|
||||
if test -d "$(distdir)/$$file"; then \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
|
||||
cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
|
||||
find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
|
||||
fi; \
|
||||
cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
|
||||
else \
|
||||
test -f "$(distdir)/$$file" \
|
||||
|| cp -p $$d/$$file "$(distdir)/$$file" \
|
||||
|| exit 1; \
|
||||
fi; \
|
||||
done
|
||||
@list='$(DIST_SUBDIRS)'; for subdir in $$list; do \
|
||||
if test "$$subdir" = .; then :; else \
|
||||
$(am__make_dryrun) \
|
||||
|| test -d "$(distdir)/$$subdir" \
|
||||
|| $(MKDIR_P) "$(distdir)/$$subdir" \
|
||||
|| exit 1; \
|
||||
dir1=$$subdir; dir2="$(distdir)/$$subdir"; \
|
||||
$(am__relativize); \
|
||||
new_distdir=$$reldir; \
|
||||
dir1=$$subdir; dir2="$(top_distdir)"; \
|
||||
$(am__relativize); \
|
||||
new_top_distdir=$$reldir; \
|
||||
echo " (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) top_distdir="$$new_top_distdir" distdir="$$new_distdir" \\"; \
|
||||
echo " am__remove_distdir=: am__skip_length_check=: am__skip_mode_fix=: distdir)"; \
|
||||
($(am__cd) $$subdir && \
|
||||
$(MAKE) $(AM_MAKEFLAGS) \
|
||||
top_distdir="$$new_top_distdir" \
|
||||
distdir="$$new_distdir" \
|
||||
am__remove_distdir=: \
|
||||
am__skip_length_check=: \
|
||||
am__skip_mode_fix=: \
|
||||
distdir) \
|
||||
|| exit 1; \
|
||||
fi; \
|
||||
done
|
||||
-test -n "$(am__skip_mode_fix)" \
|
||||
|| find "$(distdir)" -type d ! -perm -755 \
|
||||
-exec chmod u+rwx,go+rx {} \; -o \
|
||||
! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
|
||||
! -type d ! -perm -400 -exec chmod a+r {} \; -o \
|
||||
! -type d ! -perm -444 -exec $(install_sh) -c -m a+r {} {} \; \
|
||||
|| chmod -R a+r "$(distdir)"
|
||||
dist-gzip: distdir
|
||||
tardir=$(distdir) && $(am__tar) | eval GZIP= gzip $(GZIP_ENV) -c >$(distdir).tar.gz
|
||||
$(am__post_remove_distdir)
|
||||
dist-bzip2: distdir
|
||||
tardir=$(distdir) && $(am__tar) | BZIP2=$${BZIP2--9} bzip2 -c >$(distdir).tar.bz2
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
dist-lzip: distdir
|
||||
tardir=$(distdir) && $(am__tar) | lzip -c $${LZIP_OPT--9} >$(distdir).tar.lz
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
dist-xz: distdir
|
||||
tardir=$(distdir) && $(am__tar) | XZ_OPT=$${XZ_OPT--e} xz -c >$(distdir).tar.xz
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
dist-zstd: distdir
|
||||
tardir=$(distdir) && $(am__tar) | zstd -c $${ZSTD_CLEVEL-$${ZSTD_OPT--19}} >$(distdir).tar.zst
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
dist-tarZ: distdir
|
||||
@echo WARNING: "Support for distribution archives compressed with" \
|
||||
"legacy program 'compress' is deprecated." >&2
|
||||
@echo WARNING: "It will be removed altogether in Automake 2.0" >&2
|
||||
tardir=$(distdir) && $(am__tar) | compress -c >$(distdir).tar.Z
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
dist-shar: distdir
|
||||
@echo WARNING: "Support for shar distribution archives is" \
|
||||
"deprecated." >&2
|
||||
@echo WARNING: "It will be removed altogether in Automake 2.0" >&2
|
||||
shar $(distdir) | eval GZIP= gzip $(GZIP_ENV) -c >$(distdir).shar.gz
|
||||
$(am__post_remove_distdir)
|
||||
dist-zip: distdir
|
||||
-rm -f $(distdir).zip
|
||||
zip -rq $(distdir).zip $(distdir)
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
dist dist-all:
|
||||
$(MAKE) $(AM_MAKEFLAGS) $(DIST_TARGETS) am__post_remove_distdir='@:'
|
||||
$(am__post_remove_distdir)
|
||||
|
||||
# This target untars the dist file and tries a VPATH configuration. Then
|
||||
# it guarantees that the distribution is self-contained by making another
|
||||
# tarfile.
|
||||
distcheck: dist
|
||||
case '$(DIST_ARCHIVES)' in \
|
||||
*.tar.gz*) \
|
||||
eval GZIP= gzip -dc $(distdir).tar.gz | $(am__untar) ;;\
|
||||
*.tar.bz2*) \
|
||||
bzip2 -dc $(distdir).tar.bz2 | $(am__untar) ;;\
|
||||
*.tar.lz*) \
|
||||
lzip -dc $(distdir).tar.lz | $(am__untar) ;;\
|
||||
*.tar.xz*) \
|
||||
xz -dc $(distdir).tar.xz | $(am__untar) ;;\
|
||||
*.tar.Z*) \
|
||||
uncompress -c $(distdir).tar.Z | $(am__untar) ;;\
|
||||
*.shar.gz*) \
|
||||
eval GZIP= gzip -dc $(distdir).shar.gz | unshar ;;\
|
||||
*.zip*) \
|
||||
unzip $(distdir).zip ;;\
|
||||
*.tar.zst*) \
|
||||
zstd -dc $(distdir).tar.zst | $(am__untar) ;;\
|
||||
esac
|
||||
chmod -R a-w $(distdir)
|
||||
chmod u+w $(distdir)
|
||||
mkdir $(distdir)/_build $(distdir)/_build/sub $(distdir)/_inst
|
||||
chmod a-w $(distdir)
|
||||
test -d $(distdir)/_build || exit 0; \
|
||||
dc_install_base=`$(am__cd) $(distdir)/_inst && pwd | sed -e 's,^[^:\\/]:[\\/],/,'` \
|
||||
&& dc_destdir="$${TMPDIR-/tmp}/am-dc-$$$$/" \
|
||||
&& am__cwd=`pwd` \
|
||||
&& $(am__cd) $(distdir)/_build/sub \
|
||||
&& ../../configure \
|
||||
$(AM_DISTCHECK_CONFIGURE_FLAGS) \
|
||||
$(DISTCHECK_CONFIGURE_FLAGS) \
|
||||
--srcdir=../.. --prefix="$$dc_install_base" \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) $(AM_DISTCHECK_DVI_TARGET) \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) check \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) install \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) installcheck \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) uninstall \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) distuninstallcheck_dir="$$dc_install_base" \
|
||||
distuninstallcheck \
|
||||
&& chmod -R a-w "$$dc_install_base" \
|
||||
&& ({ \
|
||||
(cd ../.. && umask 077 && mkdir "$$dc_destdir") \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) DESTDIR="$$dc_destdir" install \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) DESTDIR="$$dc_destdir" uninstall \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) DESTDIR="$$dc_destdir" \
|
||||
distuninstallcheck_dir="$$dc_destdir" distuninstallcheck; \
|
||||
} || { rm -rf "$$dc_destdir"; exit 1; }) \
|
||||
&& rm -rf "$$dc_destdir" \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) dist \
|
||||
&& rm -rf $(DIST_ARCHIVES) \
|
||||
&& $(MAKE) $(AM_MAKEFLAGS) distcleancheck \
|
||||
&& cd "$$am__cwd" \
|
||||
|| exit 1
|
||||
$(am__post_remove_distdir)
|
||||
@(echo "$(distdir) archives ready for distribution: "; \
|
||||
list='$(DIST_ARCHIVES)'; for i in $$list; do echo $$i; done) | \
|
||||
sed -e 1h -e 1s/./=/g -e 1p -e 1x -e '$$p' -e '$$x'
|
||||
distuninstallcheck:
|
||||
@test -n '$(distuninstallcheck_dir)' || { \
|
||||
echo 'ERROR: trying to run $@ with an empty' \
|
||||
'$$(distuninstallcheck_dir)' >&2; \
|
||||
exit 1; \
|
||||
}; \
|
||||
$(am__cd) '$(distuninstallcheck_dir)' || { \
|
||||
echo 'ERROR: cannot chdir into $(distuninstallcheck_dir)' >&2; \
|
||||
exit 1; \
|
||||
}; \
|
||||
test `$(am__distuninstallcheck_listfiles) | wc -l` -eq 0 \
|
||||
|| { echo "ERROR: files left after uninstall:" ; \
|
||||
if test -n "$(DESTDIR)"; then \
|
||||
echo " (check DESTDIR support)"; \
|
||||
fi ; \
|
||||
$(distuninstallcheck_listfiles) ; \
|
||||
exit 1; } >&2
|
||||
distcleancheck: distclean
|
||||
@if test '$(srcdir)' = . ; then \
|
||||
echo "ERROR: distcleancheck can only run from a VPATH build" ; \
|
||||
exit 1 ; \
|
||||
fi
|
||||
@test `$(distcleancheck_listfiles) | wc -l` -eq 0 \
|
||||
|| { echo "ERROR: files left in build directory after distclean:" ; \
|
||||
$(distcleancheck_listfiles) ; \
|
||||
exit 1; } >&2
|
||||
check-am: all-am
|
||||
check: check-recursive
|
||||
all-am: Makefile $(DATA)
|
||||
installdirs: installdirs-recursive
|
||||
installdirs-am:
|
||||
for dir in "$(DESTDIR)$(noarch_pkgconfigdir)"; do \
|
||||
test -z "$$dir" || $(MKDIR_P) "$$dir"; \
|
||||
done
|
||||
install: install-recursive
|
||||
install-exec: install-exec-recursive
|
||||
install-data: install-data-recursive
|
||||
uninstall: uninstall-recursive
|
||||
|
||||
install-am: all-am
|
||||
@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
|
||||
|
||||
installcheck: installcheck-recursive
|
||||
install-strip:
|
||||
if test -z '$(STRIP)'; then \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
install; \
|
||||
else \
|
||||
$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
|
||||
install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
|
||||
"INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
|
||||
fi
|
||||
mostlyclean-generic:
|
||||
|
||||
clean-generic:
|
||||
|
||||
distclean-generic:
|
||||
-$(am__rm_f) $(CONFIG_CLEAN_FILES)
|
||||
-test . = "$(srcdir)" || $(am__rm_f) $(CONFIG_CLEAN_VPATH_FILES)
|
||||
|
||||
maintainer-clean-generic:
|
||||
@echo "This command is intended for maintainers to use"
|
||||
@echo "it deletes files that may require special tools to rebuild."
|
||||
-$(am__rm_f) $(MAINTAINERCLEANFILES)
|
||||
clean: clean-recursive
|
||||
|
||||
clean-am: clean-generic mostlyclean-am
|
||||
|
||||
distclean: distclean-recursive
|
||||
-rm -f $(am__CONFIG_DISTCLEAN_FILES)
|
||||
-rm -f Makefile
|
||||
distclean-am: clean-am distclean-generic distclean-tags
|
||||
|
||||
dvi: dvi-recursive
|
||||
|
||||
dvi-am:
|
||||
|
||||
html: html-recursive
|
||||
|
||||
html-am:
|
||||
|
||||
info: info-recursive
|
||||
|
||||
info-am:
|
||||
|
||||
install-data-am: install-noarch_pkgconfigDATA
|
||||
|
||||
install-dvi: install-dvi-recursive
|
||||
|
||||
install-dvi-am:
|
||||
|
||||
install-exec-am:
|
||||
|
||||
install-html: install-html-recursive
|
||||
|
||||
install-html-am:
|
||||
|
||||
install-info: install-info-recursive
|
||||
|
||||
install-info-am:
|
||||
|
||||
install-man:
|
||||
|
||||
install-pdf: install-pdf-recursive
|
||||
|
||||
install-pdf-am:
|
||||
|
||||
install-ps: install-ps-recursive
|
||||
|
||||
install-ps-am:
|
||||
|
||||
installcheck-am:
|
||||
|
||||
maintainer-clean: maintainer-clean-recursive
|
||||
-rm -f $(am__CONFIG_DISTCLEAN_FILES)
|
||||
-rm -rf $(top_srcdir)/autom4te.cache
|
||||
-rm -f Makefile
|
||||
maintainer-clean-am: distclean-am maintainer-clean-generic
|
||||
|
||||
mostlyclean: mostlyclean-recursive
|
||||
|
||||
mostlyclean-am: mostlyclean-generic
|
||||
|
||||
pdf: pdf-recursive
|
||||
|
||||
pdf-am:
|
||||
|
||||
ps: ps-recursive
|
||||
|
||||
ps-am:
|
||||
|
||||
uninstall-am: uninstall-noarch_pkgconfigDATA
|
||||
|
||||
.MAKE: $(am__recursive_targets) install-am install-strip
|
||||
|
||||
.PHONY: $(am__recursive_targets) CTAGS GTAGS TAGS all all-am \
|
||||
am--refresh check check-am clean clean-cscope clean-generic \
|
||||
cscope cscopelist-am ctags ctags-am dist dist-all dist-bzip2 \
|
||||
dist-gzip dist-lzip dist-shar dist-tarZ dist-xz dist-zip \
|
||||
dist-zstd distcheck distclean distclean-generic distclean-tags \
|
||||
distcleancheck distdir distuninstallcheck dvi dvi-am html \
|
||||
html-am info info-am install install-am install-data \
|
||||
install-data-am install-dvi install-dvi-am install-exec \
|
||||
install-exec-am install-html install-html-am install-info \
|
||||
install-info-am install-man install-noarch_pkgconfigDATA \
|
||||
install-pdf install-pdf-am install-ps install-ps-am \
|
||||
install-strip installcheck installcheck-am installdirs \
|
||||
installdirs-am maintainer-clean maintainer-clean-generic \
|
||||
mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags \
|
||||
tags-am uninstall uninstall-am uninstall-noarch_pkgconfigDATA
|
||||
|
||||
.PRECIOUS: Makefile
|
||||
|
||||
|
||||
# Tell versions [3.59,3.63) of GNU make to not export all variables.
|
||||
# Otherwise a system limit (for SysV at least) may be exceeded.
|
||||
.NOEXPORT:
|
||||
|
||||
# Tell GNU make to disable its built-in pattern rules.
|
||||
%:: %,v
|
||||
%:: RCS/%,v
|
||||
%:: RCS/%
|
||||
%:: s.%
|
||||
%:: SCCS/s.%
|
||||
4
Packages/asio-1.36.0/README
vendored
Normal file
4
Packages/asio-1.36.0/README
vendored
Normal file
@@ -0,0 +1,4 @@
|
||||
asio version 1.36.0
|
||||
Released Saturday, 16 August 2025.
|
||||
|
||||
See doc/index.html for API documentation and a tutorial.
|
||||
1343
Packages/asio-1.36.0/aclocal.m4
vendored
Normal file
1343
Packages/asio-1.36.0/aclocal.m4
vendored
Normal file
File diff suppressed because it is too large
Load Diff
11
Packages/asio-1.36.0/asio.pc.in
vendored
Normal file
11
Packages/asio-1.36.0/asio.pc.in
vendored
Normal file
@@ -0,0 +1,11 @@
|
||||
prefix=@prefix@
|
||||
exec_prefix=@exec_prefix@
|
||||
includedir=@includedir@
|
||||
|
||||
Name: @PACKAGE_NAME@
|
||||
Description: A cross-platform C++ library for network and low-level I/O programming that provides developers with a consistent asynchronous model using a modern C++ approach.
|
||||
Version: @PACKAGE_VERSION@
|
||||
Cflags: -I${includedir}
|
||||
Lflags:
|
||||
Requires:
|
||||
Requires.private:
|
||||
351
Packages/asio-1.36.0/compile
vendored
Normal file
351
Packages/asio-1.36.0/compile
vendored
Normal file
@@ -0,0 +1,351 @@
|
||||
#! /bin/sh
|
||||
# Wrapper for compilers which do not understand '-c -o'.
|
||||
|
||||
scriptversion=2024-06-19.01; # UTC
|
||||
|
||||
# Copyright (C) 1999-2024 Free Software Foundation, Inc.
|
||||
# Written by Tom Tromey <tromey@cygnus.com>.
|
||||
#
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; either version 2, or (at your option)
|
||||
# any later version.
|
||||
#
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
#
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
# As a special exception to the GNU General Public License, if you
|
||||
# distribute this file as part of a program that contains a
|
||||
# configuration script generated by Autoconf, you may include it under
|
||||
# the same distribution terms that you use for the rest of that program.
|
||||
|
||||
# This file is maintained in Automake, please report
|
||||
# bugs to <bug-automake@gnu.org> or send patches to
|
||||
# <automake-patches@gnu.org>.
|
||||
|
||||
nl='
|
||||
'
|
||||
|
||||
# We need space, tab and new line, in precisely that order. Quoting is
|
||||
# there to prevent tools from complaining about whitespace usage.
|
||||
IFS=" "" $nl"
|
||||
|
||||
file_conv=
|
||||
|
||||
# func_file_conv build_file lazy
|
||||
# Convert a $build file to $host form and store it in $file
|
||||
# Currently only supports Windows hosts. If the determined conversion
|
||||
# type is listed in (the comma separated) LAZY, no conversion will
|
||||
# take place.
|
||||
func_file_conv ()
|
||||
{
|
||||
file=$1
|
||||
case $file in
|
||||
/ | /[!/]*) # absolute file, and not a UNC file
|
||||
if test -z "$file_conv"; then
|
||||
# lazily determine how to convert abs files
|
||||
case `uname -s` in
|
||||
MINGW*)
|
||||
file_conv=mingw
|
||||
;;
|
||||
CYGWIN* | MSYS*)
|
||||
file_conv=cygwin
|
||||
;;
|
||||
*)
|
||||
file_conv=wine
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
case $file_conv/,$2, in
|
||||
*,$file_conv,*)
|
||||
;;
|
||||
mingw/*)
|
||||
file=`cmd //C echo "$file " | sed -e 's/"\(.*\) " *$/\1/'`
|
||||
;;
|
||||
cygwin/* | msys/*)
|
||||
file=`cygpath -m "$file" || echo "$file"`
|
||||
;;
|
||||
wine/*)
|
||||
file=`winepath -w "$file" || echo "$file"`
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
# func_cl_dashL linkdir
|
||||
# Make cl look for libraries in LINKDIR
|
||||
func_cl_dashL ()
|
||||
{
|
||||
func_file_conv "$1"
|
||||
if test -z "$lib_path"; then
|
||||
lib_path=$file
|
||||
else
|
||||
lib_path="$lib_path;$file"
|
||||
fi
|
||||
linker_opts="$linker_opts -LIBPATH:$file"
|
||||
}
|
||||
|
||||
# func_cl_dashl library
|
||||
# Do a library search-path lookup for cl
|
||||
func_cl_dashl ()
|
||||
{
|
||||
lib=$1
|
||||
found=no
|
||||
save_IFS=$IFS
|
||||
IFS=';'
|
||||
for dir in $lib_path $LIB
|
||||
do
|
||||
IFS=$save_IFS
|
||||
if $shared && test -f "$dir/$lib.dll.lib"; then
|
||||
found=yes
|
||||
lib=$dir/$lib.dll.lib
|
||||
break
|
||||
fi
|
||||
if test -f "$dir/$lib.lib"; then
|
||||
found=yes
|
||||
lib=$dir/$lib.lib
|
||||
break
|
||||
fi
|
||||
if test -f "$dir/lib$lib.a"; then
|
||||
found=yes
|
||||
lib=$dir/lib$lib.a
|
||||
break
|
||||
fi
|
||||
done
|
||||
IFS=$save_IFS
|
||||
|
||||
if test "$found" != yes; then
|
||||
lib=$lib.lib
|
||||
fi
|
||||
}
|
||||
|
||||
# func_cl_wrapper cl arg...
|
||||
# Adjust compile command to suit cl
|
||||
func_cl_wrapper ()
|
||||
{
|
||||
# Assume a capable shell
|
||||
lib_path=
|
||||
shared=:
|
||||
linker_opts=
|
||||
for arg
|
||||
do
|
||||
if test -n "$eat"; then
|
||||
eat=
|
||||
else
|
||||
case $1 in
|
||||
-o)
|
||||
# configure might choose to run compile as 'compile cc -o foo foo.c'.
|
||||
eat=1
|
||||
case $2 in
|
||||
*.o | *.lo | *.[oO][bB][jJ])
|
||||
func_file_conv "$2"
|
||||
set x "$@" -Fo"$file"
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
func_file_conv "$2"
|
||||
set x "$@" -Fe"$file"
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
-I)
|
||||
eat=1
|
||||
func_file_conv "$2" mingw
|
||||
set x "$@" -I"$file"
|
||||
shift
|
||||
;;
|
||||
-I*)
|
||||
func_file_conv "${1#-I}" mingw
|
||||
set x "$@" -I"$file"
|
||||
shift
|
||||
;;
|
||||
-l)
|
||||
eat=1
|
||||
func_cl_dashl "$2"
|
||||
set x "$@" "$lib"
|
||||
shift
|
||||
;;
|
||||
-l*)
|
||||
func_cl_dashl "${1#-l}"
|
||||
set x "$@" "$lib"
|
||||
shift
|
||||
;;
|
||||
-L)
|
||||
eat=1
|
||||
func_cl_dashL "$2"
|
||||
;;
|
||||
-L*)
|
||||
func_cl_dashL "${1#-L}"
|
||||
;;
|
||||
-static)
|
||||
shared=false
|
||||
;;
|
||||
-Wl,*)
|
||||
arg=${1#-Wl,}
|
||||
save_ifs="$IFS"; IFS=','
|
||||
for flag in $arg; do
|
||||
IFS="$save_ifs"
|
||||
linker_opts="$linker_opts $flag"
|
||||
done
|
||||
IFS="$save_ifs"
|
||||
;;
|
||||
-Xlinker)
|
||||
eat=1
|
||||
linker_opts="$linker_opts $2"
|
||||
;;
|
||||
-*)
|
||||
set x "$@" "$1"
|
||||
shift
|
||||
;;
|
||||
*.cc | *.CC | *.cxx | *.CXX | *.[cC]++)
|
||||
func_file_conv "$1"
|
||||
set x "$@" -Tp"$file"
|
||||
shift
|
||||
;;
|
||||
*.c | *.cpp | *.CPP | *.lib | *.LIB | *.Lib | *.OBJ | *.obj | *.[oO])
|
||||
func_file_conv "$1" mingw
|
||||
set x "$@" "$file"
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
set x "$@" "$1"
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
shift
|
||||
done
|
||||
if test -n "$linker_opts"; then
|
||||
linker_opts="-link$linker_opts"
|
||||
fi
|
||||
exec "$@" $linker_opts
|
||||
exit 1
|
||||
}
|
||||
|
||||
eat=
|
||||
|
||||
case $1 in
|
||||
'')
|
||||
echo "$0: No command. Try '$0 --help' for more information." 1>&2
|
||||
exit 1;
|
||||
;;
|
||||
-h | --h*)
|
||||
cat <<\EOF
|
||||
Usage: compile [--help] [--version] PROGRAM [ARGS]
|
||||
|
||||
Wrapper for compilers which do not understand '-c -o'.
|
||||
Remove '-o dest.o' from ARGS, run PROGRAM with the remaining
|
||||
arguments, and rename the output as expected.
|
||||
|
||||
If you are trying to build a whole package this is not the
|
||||
right script to run: please start by reading the file 'INSTALL'.
|
||||
|
||||
Report bugs to <bug-automake@gnu.org>.
|
||||
GNU Automake home page: <https://www.gnu.org/software/automake/>.
|
||||
General help using GNU software: <https://www.gnu.org/gethelp/>.
|
||||
EOF
|
||||
exit $?
|
||||
;;
|
||||
-v | --v*)
|
||||
echo "compile (GNU Automake) $scriptversion"
|
||||
exit $?
|
||||
;;
|
||||
cl | *[/\\]cl | cl.exe | *[/\\]cl.exe | \
|
||||
clang-cl | *[/\\]clang-cl | clang-cl.exe | *[/\\]clang-cl.exe | \
|
||||
icl | *[/\\]icl | icl.exe | *[/\\]icl.exe )
|
||||
func_cl_wrapper "$@" # Doesn't return...
|
||||
;;
|
||||
esac
|
||||
|
||||
ofile=
|
||||
cfile=
|
||||
|
||||
for arg
|
||||
do
|
||||
if test -n "$eat"; then
|
||||
eat=
|
||||
else
|
||||
case $1 in
|
||||
-o)
|
||||
# configure might choose to run compile as 'compile cc -o foo foo.c'.
|
||||
# So we strip '-o arg' only if arg is an object.
|
||||
eat=1
|
||||
case $2 in
|
||||
*.o | *.obj)
|
||||
ofile=$2
|
||||
;;
|
||||
*)
|
||||
set x "$@" -o "$2"
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
;;
|
||||
*.c)
|
||||
cfile=$1
|
||||
set x "$@" "$1"
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
set x "$@" "$1"
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
fi
|
||||
shift
|
||||
done
|
||||
|
||||
if test -z "$ofile" || test -z "$cfile"; then
|
||||
# If no '-o' option was seen then we might have been invoked from a
|
||||
# pattern rule where we don't need one. That is ok -- this is a
|
||||
# normal compilation that the losing compiler can handle. If no
|
||||
# '.c' file was seen then we are probably linking. That is also
|
||||
# ok.
|
||||
exec "$@"
|
||||
fi
|
||||
|
||||
# Name of file we expect compiler to create.
|
||||
cofile=`echo "$cfile" | sed 's|^.*[\\/]||; s|^[a-zA-Z]:||; s/\.c$/.o/'`
|
||||
|
||||
# Create the lock directory.
|
||||
# Note: use '[/\\:.-]' here to ensure that we don't use the same name
|
||||
# that we are using for the .o file. Also, base the name on the expected
|
||||
# object file name, since that is what matters with a parallel build.
|
||||
lockdir=`echo "$cofile" | sed -e 's|[/\\:.-]|_|g'`.d
|
||||
while true; do
|
||||
if mkdir "$lockdir" >/dev/null 2>&1; then
|
||||
break
|
||||
fi
|
||||
sleep 1
|
||||
done
|
||||
# FIXME: race condition here if user kills between mkdir and trap.
|
||||
trap "rmdir '$lockdir'; exit 1" 1 2 15
|
||||
|
||||
# Run the compile.
|
||||
"$@"
|
||||
ret=$?
|
||||
|
||||
if test -f "$cofile"; then
|
||||
test "$cofile" = "$ofile" || mv "$cofile" "$ofile"
|
||||
elif test -f "${cofile}bj"; then
|
||||
test "${cofile}bj" = "$ofile" || mv "${cofile}bj" "$ofile"
|
||||
fi
|
||||
|
||||
rmdir "$lockdir"
|
||||
exit $ret
|
||||
|
||||
# Local Variables:
|
||||
# mode: shell-script
|
||||
# sh-indentation: 2
|
||||
# eval: (add-hook 'before-save-hook 'time-stamp)
|
||||
# time-stamp-start: "scriptversion="
|
||||
# time-stamp-format: "%:y-%02m-%02d.%02H"
|
||||
# time-stamp-time-zone: "UTC0"
|
||||
# time-stamp-end: "; # UTC"
|
||||
# End:
|
||||
1812
Packages/asio-1.36.0/config.guess
vendored
Normal file
1812
Packages/asio-1.36.0/config.guess
vendored
Normal file
File diff suppressed because it is too large
Load Diff
1971
Packages/asio-1.36.0/config.sub
vendored
Normal file
1971
Packages/asio-1.36.0/config.sub
vendored
Normal file
File diff suppressed because it is too large
Load Diff
7352
Packages/asio-1.36.0/configure
vendored
Normal file
7352
Packages/asio-1.36.0/configure
vendored
Normal file
File diff suppressed because it is too large
Load Diff
259
Packages/asio-1.36.0/configure.ac
vendored
Normal file
259
Packages/asio-1.36.0/configure.ac
vendored
Normal file
@@ -0,0 +1,259 @@
|
||||
AC_INIT([asio],[1.36.0])
|
||||
AC_CONFIG_SRCDIR(include/asio.hpp)
|
||||
AM_MAINTAINER_MODE
|
||||
AM_INIT_AUTOMAKE([tar-pax])
|
||||
|
||||
AC_CANONICAL_HOST
|
||||
AM_PROG_CC_C_O
|
||||
AC_PROG_CXX
|
||||
AC_LANG(C++)
|
||||
AC_PROG_RANLIB
|
||||
PKG_NOARCH_INSTALLDIR
|
||||
|
||||
AC_DEFINE(_REENTRANT, [1], [Define this])
|
||||
|
||||
AC_ARG_WITH(boost,
|
||||
AS_HELP_STRING([--with-boost=DIR],[location of boost distribution]),
|
||||
[
|
||||
if test "${withval}" = no; then
|
||||
STANDALONE="yes"
|
||||
else
|
||||
if test "${withval}" != system; then
|
||||
CPPFLAGS="$CPPFLAGS -I${withval}"
|
||||
LIBS="$LIBS -L${withval}/stage/lib"
|
||||
fi
|
||||
CPPFLAGS="$CPPFLAGS -DASIO_ENABLE_BOOST -DBOOST_CHRONO_HEADER_ONLY -DBOOST_CHRONO_DONT_PROVIDE_HYBRID_ERROR_HANDLING"
|
||||
fi
|
||||
],
|
||||
[
|
||||
STANDALONE="yes"
|
||||
])
|
||||
|
||||
AC_ARG_ENABLE(separate-compilation,
|
||||
[ --enable-separate-compilation separate compilation of asio source],
|
||||
[
|
||||
SEPARATE_COMPILATION=yes
|
||||
])
|
||||
|
||||
AC_ARG_ENABLE(boost-coroutine,
|
||||
[ --enable-boost-coroutine use Boost.Coroutine to implement stackful coroutines],
|
||||
[
|
||||
HAVE_BOOST_COROUTINE=yes
|
||||
])
|
||||
|
||||
if test "$STANDALONE" != yes; then
|
||||
AC_CHECK_HEADER([boost/noncopyable.hpp],,
|
||||
[
|
||||
echo "Can't find boost headers. Please check the location of the boost"
|
||||
echo "distribution and rerun configure using the --with-boost=DIR option."
|
||||
echo "Alternatively, run with --without-boost to enable standalone build."
|
||||
exit 1
|
||||
],[])
|
||||
fi
|
||||
|
||||
AC_ARG_WITH(openssl,
|
||||
AS_HELP_STRING([--with-openssl=DIR],[location of openssl]),
|
||||
[
|
||||
CPPFLAGS="$CPPFLAGS -I${withval}/include"
|
||||
LIBS="$LIBS -L${withval}/lib"
|
||||
],[])
|
||||
|
||||
AC_CHECK_HEADER([openssl/ssl.h],,
|
||||
[
|
||||
OPENSSL_FOUND=no
|
||||
],[])
|
||||
|
||||
if test x$OPENSSL_FOUND != xno; then
|
||||
LIBS="$LIBS -lssl -lcrypto"
|
||||
fi
|
||||
|
||||
AM_CONDITIONAL(HAVE_OPENSSL,test x$OPENSSL_FOUND != xno)
|
||||
|
||||
WINDOWS=no
|
||||
case $host in
|
||||
*-*-linux*)
|
||||
CXXFLAGS="$CXXFLAGS -pthread"
|
||||
LDFLAGS="$LDFLAGS -pthread"
|
||||
LIBS="$LIBS -lrt"
|
||||
;;
|
||||
*-*-solaris*)
|
||||
if test "$GXX" = yes; then
|
||||
CXXFLAGS="$CXXFLAGS -D_PTHREADS"
|
||||
else
|
||||
# We'll assume Sun's CC.
|
||||
CXXFLAGS="$CXXFLAGS -mt"
|
||||
fi
|
||||
LIBS="$LIBS -lsocket -lnsl -lpthread"
|
||||
;;
|
||||
*-*-mingw32*)
|
||||
CXXFLAGS="$CXXFLAGS -mthreads"
|
||||
LDFLAGS="$LDFLAGS -mthreads"
|
||||
LIBS="$LIBS -lws2_32 -lmswsock"
|
||||
WINDOWS=yes
|
||||
;;
|
||||
*-*-mingw64*)
|
||||
CXXFLAGS="$CXXFLAGS -mthreads"
|
||||
LDFLAGS="$LDFLAGS -mthreads"
|
||||
LIBS="$LIBS -lws2_32 -lmswsock"
|
||||
WINDOWS=yes
|
||||
;;
|
||||
*-pc-cygwin*)
|
||||
CXXFLAGS="$CXXFLAGS -D__USE_W32_SOCKETS -D_WIN32_WINNT=0x0601"
|
||||
LIBS="$LIBS -lws2_32 -lmswsock"
|
||||
WINDOWS=yes
|
||||
;;
|
||||
*-apple-darwin*)
|
||||
CXXFLAGS="$CXXFLAGS"
|
||||
LDFLAGS="$LDFLAGS"
|
||||
;;
|
||||
*-*-freebsd*)
|
||||
CXXFLAGS="$CXXFLAGS -pthread"
|
||||
LDFLAGS="$LDFLAGS -pthread"
|
||||
;;
|
||||
*-*-netbsd*)
|
||||
CXXFLAGS="$CXXFLAGS -pthread"
|
||||
LDFLAGS="$LDFLAGS -pthread"
|
||||
;;
|
||||
*-*-haiku*)
|
||||
CXXFLAGS="$CXXFLAGS -lnetwork"
|
||||
LDFLAGS="$LDFLAGS -lnetwork"
|
||||
|
||||
esac
|
||||
|
||||
if test "$GXX" = yes; then
|
||||
CXXFLAGS="$CXXFLAGS -ftemplate-depth-256"
|
||||
fi
|
||||
|
||||
if test "$STANDALONE" = yes; then
|
||||
CPPFLAGS="$CPPFLAGS -DASIO_STANDALONE"
|
||||
fi
|
||||
|
||||
if test "$SEPARATE_COMPILATION" = yes; then
|
||||
CPPFLAGS="$CPPFLAGS -DASIO_SEPARATE_COMPILATION"
|
||||
fi
|
||||
|
||||
AC_MSG_CHECKING([whether C++11 is enabled])
|
||||
AC_COMPILE_IFELSE(
|
||||
[AC_LANG_PROGRAM(
|
||||
[[#if __cplusplus < 201103L]]
|
||||
[[#error C++11 not available]]
|
||||
[[#endif]])],
|
||||
[AC_MSG_RESULT([yes])
|
||||
HAVE_CXX11=yes;],
|
||||
[AC_MSG_RESULT([no])
|
||||
HAVE_CXX11=no;])
|
||||
|
||||
AC_MSG_CHECKING([whether C++14 is enabled])
|
||||
AC_COMPILE_IFELSE(
|
||||
[AC_LANG_PROGRAM(
|
||||
[[#if defined(__GNUC__) && !defined(__clang__)]]
|
||||
[[# if (__GNUC__ <= 6)]]
|
||||
[[# error C++14 support on this compiler not sufficiently compliant]]
|
||||
[[# endif]]
|
||||
[[#endif]]
|
||||
[[#if __cplusplus < 201402L]]
|
||||
[[#error C++14 not available]]
|
||||
[[#endif]])],
|
||||
[AC_MSG_RESULT([yes])
|
||||
HAVE_CXX14=yes;],
|
||||
[AC_MSG_RESULT([no])
|
||||
HAVE_CXX14=no;])
|
||||
|
||||
AC_MSG_CHECKING([whether C++17 is enabled])
|
||||
AC_COMPILE_IFELSE(
|
||||
[AC_LANG_PROGRAM(
|
||||
[[#if __cplusplus < 201703L]]
|
||||
[[#error C++17 not available]]
|
||||
[[#endif]])],
|
||||
[AC_MSG_RESULT([yes])
|
||||
HAVE_CXX17=yes;],
|
||||
[AC_MSG_RESULT([no])
|
||||
HAVE_CXX17=no;])
|
||||
|
||||
AC_MSG_CHECKING([whether C++20 is enabled])
|
||||
AC_COMPILE_IFELSE(
|
||||
[AC_LANG_PROGRAM(
|
||||
[[#if __cplusplus < 202002L]]
|
||||
[[#error C++20 not available]]
|
||||
[[#endif]])],
|
||||
[AC_MSG_RESULT([yes])
|
||||
HAVE_CXX20=yes;],
|
||||
[AC_MSG_RESULT([no])
|
||||
HAVE_CXX20=no;])
|
||||
|
||||
AC_MSG_CHECKING([whether coroutines are enabled])
|
||||
AC_COMPILE_IFELSE(
|
||||
[AC_LANG_PROGRAM(
|
||||
[[#if defined(__clang__)]]
|
||||
[[# if (__clang_major__ >= 14)]]
|
||||
[[# if (__cplusplus >= 202002) && (__cpp_impl_coroutine >= 201902)]]
|
||||
[[# if __has_include(<coroutine>)]]
|
||||
[[# define ASIO_HAS_CO_AWAIT 1]]
|
||||
[[# endif]]
|
||||
[[# elif (__cplusplus >= 201703) && (__cpp_coroutines >= 201703)]]
|
||||
[[# if __has_include(<experimental/coroutine>)]]
|
||||
[[# define ASIO_HAS_CO_AWAIT 1]]
|
||||
[[# endif]]
|
||||
[[# endif]]
|
||||
[[# else]]
|
||||
[[# if (__cplusplus >= 201703) && (__cpp_coroutines >= 201703)]]
|
||||
[[# if __has_include(<experimental/coroutine>)]]
|
||||
[[# define ASIO_HAS_CO_AWAIT 1]]
|
||||
[[# endif]]
|
||||
[[# endif]]
|
||||
[[# endif]]
|
||||
[[#elif defined(__GNUC__)]]
|
||||
[[# if (__cplusplus >= 201709) && (__cpp_impl_coroutine >= 201902)]]
|
||||
[[# if __has_include(<coroutine>)]]
|
||||
[[# define ASIO_HAS_CO_AWAIT 1]]
|
||||
[[# endif]]
|
||||
[[# endif]]
|
||||
[[#endif]]
|
||||
[[#ifndef ASIO_HAS_CO_AWAIT]]
|
||||
[[# error coroutines not available]]
|
||||
[[#endif]])],
|
||||
[AC_MSG_RESULT([yes])
|
||||
HAVE_COROUTINES=yes;],
|
||||
[AC_MSG_RESULT([no])
|
||||
HAVE_COROUTINES=no;])
|
||||
|
||||
if test "$GXX" = yes; then
|
||||
if test "$STANDALONE" = yes; then
|
||||
if test "$HAVE_CXX11" = no; then
|
||||
HAVE_CXX11=yes
|
||||
CPPFLAGS="-std=c++0x $CPPFLAGS"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
AM_CONDITIONAL(STANDALONE,test x$STANDALONE = xyes)
|
||||
|
||||
AM_CONDITIONAL(SEPARATE_COMPILATION,test x$SEPARATE_COMPILATION = xyes)
|
||||
|
||||
AM_CONDITIONAL(HAVE_BOOST_COROUTINE,test x$HAVE_BOOST_COROUTINE = xyes)
|
||||
|
||||
AM_CONDITIONAL(WINDOWS_TARGET,test x$WINDOWS != xno)
|
||||
|
||||
AM_CONDITIONAL(HAVE_CXX11,test x$HAVE_CXX11 = xyes)
|
||||
|
||||
AM_CONDITIONAL(HAVE_CXX14,test x$HAVE_CXX14 = xyes)
|
||||
|
||||
AM_CONDITIONAL(HAVE_CXX17,test x$HAVE_CXX17 = xyes)
|
||||
|
||||
AM_CONDITIONAL(HAVE_CXX20,test x$HAVE_CXX20 = xyes)
|
||||
|
||||
AM_CONDITIONAL(HAVE_COROUTINES,test x$HAVE_COROUTINES = xyes)
|
||||
|
||||
AC_CONFIG_FILES([asio.pc])
|
||||
|
||||
AC_CONFIG_FILES([
|
||||
Makefile
|
||||
include/Makefile
|
||||
src/Makefile
|
||||
src/tests/Makefile
|
||||
src/tests/properties/Makefile
|
||||
src/examples/cpp11/Makefile
|
||||
src/examples/cpp14/Makefile
|
||||
src/examples/cpp17/Makefile
|
||||
src/examples/cpp20/Makefile])
|
||||
AC_OUTPUT
|
||||
792
Packages/asio-1.36.0/depcomp
vendored
Normal file
792
Packages/asio-1.36.0/depcomp
vendored
Normal file
@@ -0,0 +1,792 @@
|
||||
#! /bin/sh
|
||||
# depcomp - compile a program generating dependencies as side-effects
|
||||
|
||||
scriptversion=2024-06-19.01; # UTC
|
||||
|
||||
# Copyright (C) 1999-2024 Free Software Foundation, Inc.
|
||||
|
||||
# This program is free software; you can redistribute it and/or modify
|
||||
# it under the terms of the GNU General Public License as published by
|
||||
# the Free Software Foundation; either version 2, or (at your option)
|
||||
# any later version.
|
||||
|
||||
# This program is distributed in the hope that it will be useful,
|
||||
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
# GNU General Public License for more details.
|
||||
|
||||
# You should have received a copy of the GNU General Public License
|
||||
# along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
# As a special exception to the GNU General Public License, if you
|
||||
# distribute this file as part of a program that contains a
|
||||
# configuration script generated by Autoconf, you may include it under
|
||||
# the same distribution terms that you use for the rest of that program.
|
||||
|
||||
# Originally written by Alexandre Oliva <oliva@dcc.unicamp.br>.
|
||||
|
||||
case $1 in
|
||||
'')
|
||||
echo "$0: No command. Try '$0 --help' for more information." 1>&2
|
||||
exit 1;
|
||||
;;
|
||||
-h | --h*)
|
||||
cat <<\EOF
|
||||
Usage: depcomp [--help] [--version] PROGRAM [ARGS]
|
||||
|
||||
Run PROGRAMS ARGS to compile a file, generating dependencies
|
||||
as side-effects.
|
||||
|
||||
Environment variables:
|
||||
depmode Dependency tracking mode.
|
||||
source Source file read by 'PROGRAMS ARGS'.
|
||||
object Object file output by 'PROGRAMS ARGS'.
|
||||
DEPDIR directory where to store dependencies.
|
||||
depfile Dependency file to output.
|
||||
tmpdepfile Temporary file to use when outputting dependencies.
|
||||
libtool Whether libtool is used (yes/no).
|
||||
|
||||
Report bugs to <bug-automake@gnu.org>.
|
||||
GNU Automake home page: <https://www.gnu.org/software/automake/>.
|
||||
General help using GNU software: <https://www.gnu.org/gethelp/>.
|
||||
EOF
|
||||
exit $?
|
||||
;;
|
||||
-v | --v*)
|
||||
echo "depcomp (GNU Automake) $scriptversion"
|
||||
exit $?
|
||||
;;
|
||||
esac
|
||||
|
||||
# Get the directory component of the given path, and save it in the
|
||||
# global variables '$dir'. Note that this directory component will
|
||||
# be either empty or ending with a '/' character. This is deliberate.
|
||||
set_dir_from ()
|
||||
{
|
||||
case $1 in
|
||||
*/*) dir=`echo "$1" | sed -e 's|/[^/]*$|/|'`;;
|
||||
*) dir=;;
|
||||
esac
|
||||
}
|
||||
|
||||
# Get the suffix-stripped basename of the given path, and save it the
|
||||
# global variable '$base'.
|
||||
set_base_from ()
|
||||
{
|
||||
base=`echo "$1" | sed -e 's|^.*/||' -e 's/\.[^.]*$//'`
|
||||
}
|
||||
|
||||
# If no dependency file was actually created by the compiler invocation,
|
||||
# we still have to create a dummy depfile, to avoid errors with the
|
||||
# Makefile "include basename.Plo" scheme.
|
||||
make_dummy_depfile ()
|
||||
{
|
||||
echo "#dummy" > "$depfile"
|
||||
}
|
||||
|
||||
# Factor out some common post-processing of the generated depfile.
|
||||
# Requires the auxiliary global variable '$tmpdepfile' to be set.
|
||||
aix_post_process_depfile ()
|
||||
{
|
||||
# If the compiler actually managed to produce a dependency file,
|
||||
# post-process it.
|
||||
if test -f "$tmpdepfile"; then
|
||||
# Each line is of the form 'foo.o: dependency.h'.
|
||||
# Do two passes, one to just change these to
|
||||
# $object: dependency.h
|
||||
# and one to simply output
|
||||
# dependency.h:
|
||||
# which is needed to avoid the deleted-header problem.
|
||||
{ sed -e "s,^.*\.[$lower]*:,$object:," < "$tmpdepfile"
|
||||
sed -e "s,^.*\.[$lower]*:[$tab ]*,," -e 's,$,:,' < "$tmpdepfile"
|
||||
} > "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
else
|
||||
make_dummy_depfile
|
||||
fi
|
||||
}
|
||||
|
||||
# A tabulation character.
|
||||
tab=' '
|
||||
# A newline character.
|
||||
nl='
|
||||
'
|
||||
# Character ranges might be problematic outside the C locale.
|
||||
# These definitions help.
|
||||
upper=ABCDEFGHIJKLMNOPQRSTUVWXYZ
|
||||
lower=abcdefghijklmnopqrstuvwxyz
|
||||
alpha=${upper}${lower}
|
||||
|
||||
if test -z "$depmode" || test -z "$source" || test -z "$object"; then
|
||||
echo "depcomp: Variables source, object and depmode must be set" 1>&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Dependencies for sub/bar.o or sub/bar.obj go into sub/.deps/bar.Po.
|
||||
depfile=${depfile-`echo "$object" |
|
||||
sed 's|[^\\/]*$|'${DEPDIR-.deps}'/&|;s|\.\([^.]*\)$|.P\1|;s|Pobj$|Po|'`}
|
||||
tmpdepfile=${tmpdepfile-`echo "$depfile" | sed 's/\.\([^.]*\)$/.T\1/'`}
|
||||
|
||||
rm -f "$tmpdepfile"
|
||||
|
||||
# Avoid interference from the environment.
|
||||
gccflag= dashmflag=
|
||||
|
||||
# Some modes work just like other modes, but use different flags. We
|
||||
# parameterize here, but still list the modes in the big case below,
|
||||
# to make depend.m4 easier to write. Note that we *cannot* use a case
|
||||
# here, because this file can only contain one case statement.
|
||||
if test "$depmode" = hp; then
|
||||
# HP compiler uses -M and no extra arg.
|
||||
gccflag=-M
|
||||
depmode=gcc
|
||||
fi
|
||||
|
||||
if test "$depmode" = dashXmstdout; then
|
||||
# This is just like dashmstdout with a different argument.
|
||||
dashmflag=-xM
|
||||
depmode=dashmstdout
|
||||
fi
|
||||
|
||||
cygpath_u="cygpath -u -f -"
|
||||
if test "$depmode" = msvcmsys; then
|
||||
# This is just like msvisualcpp but w/o cygpath translation.
|
||||
# Just convert the backslash-escaped backslashes to single forward
|
||||
# slashes to satisfy depend.m4
|
||||
cygpath_u='sed s,\\\\,/,g'
|
||||
depmode=msvisualcpp
|
||||
fi
|
||||
|
||||
if test "$depmode" = msvc7msys; then
|
||||
# This is just like msvc7 but w/o cygpath translation.
|
||||
# Just convert the backslash-escaped backslashes to single forward
|
||||
# slashes to satisfy depend.m4
|
||||
cygpath_u='sed s,\\\\,/,g'
|
||||
depmode=msvc7
|
||||
fi
|
||||
|
||||
if test "$depmode" = xlc; then
|
||||
# IBM C/C++ Compilers xlc/xlC can output gcc-like dependency information.
|
||||
gccflag=-qmakedep=gcc,-MF
|
||||
depmode=gcc
|
||||
fi
|
||||
|
||||
case "$depmode" in
|
||||
gcc3)
|
||||
## gcc 3 implements dependency tracking that does exactly what
|
||||
## we want. Yay! Note: for some reason libtool 1.4 doesn't like
|
||||
## it if -MD -MP comes after the -MF stuff. Hmm.
|
||||
## Unfortunately, FreeBSD c89 acceptance of flags depends upon
|
||||
## the command line argument order; so add the flags where they
|
||||
## appear in depend2.am. Note that the slowdown incurred here
|
||||
## affects only configure: in makefiles, %FASTDEP% shortcuts this.
|
||||
for arg
|
||||
do
|
||||
case $arg in
|
||||
-c) set fnord "$@" -MT "$object" -MD -MP -MF "$tmpdepfile" "$arg" ;;
|
||||
*) set fnord "$@" "$arg" ;;
|
||||
esac
|
||||
shift # fnord
|
||||
shift # $arg
|
||||
done
|
||||
"$@"
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile"
|
||||
exit $stat
|
||||
fi
|
||||
mv "$tmpdepfile" "$depfile"
|
||||
;;
|
||||
|
||||
gcc)
|
||||
## Note that this doesn't just cater to obsolete pre-3.x GCC compilers.
|
||||
## but also to in-use compilers like IBM xlc/xlC and the HP C compiler.
|
||||
## (see the conditional assignment to $gccflag above).
|
||||
## There are various ways to get dependency output from gcc. Here's
|
||||
## why we pick this rather obscure method:
|
||||
## - Don't want to use -MD because we'd like the dependencies to end
|
||||
## up in a subdir. Having to rename by hand is ugly.
|
||||
## (We might end up doing this anyway to support other compilers.)
|
||||
## - The DEPENDENCIES_OUTPUT environment variable makes gcc act like
|
||||
## -MM, not -M (despite what the docs say). Also, it might not be
|
||||
## supported by the other compilers which use the 'gcc' depmode.
|
||||
## - Using -M directly means running the compiler twice (even worse
|
||||
## than renaming).
|
||||
if test -z "$gccflag"; then
|
||||
gccflag=-MD,
|
||||
fi
|
||||
"$@" -Wp,"$gccflag$tmpdepfile"
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile"
|
||||
exit $stat
|
||||
fi
|
||||
rm -f "$depfile"
|
||||
echo "$object : \\" > "$depfile"
|
||||
# The second -e expression handles DOS-style file names with drive
|
||||
# letters.
|
||||
sed -e 's/^[^:]*: / /' \
|
||||
-e 's/^['$alpha']:\/[^:]*: / /' < "$tmpdepfile" >> "$depfile"
|
||||
## This next piece of magic avoids the "deleted header file" problem.
|
||||
## The problem is that when a header file which appears in a .P file
|
||||
## is deleted, the dependency causes make to die (because there is
|
||||
## typically no way to rebuild the header). We avoid this by adding
|
||||
## dummy dependencies for each header file. Too bad gcc doesn't do
|
||||
## this for us directly.
|
||||
## Some versions of gcc put a space before the ':'. On the theory
|
||||
## that the space means something, we add a space to the output as
|
||||
## well. hp depmode also adds that space, but also prefixes the VPATH
|
||||
## to the object. Take care to not repeat it in the output.
|
||||
## Some versions of the HPUX 10.20 sed can't process this invocation
|
||||
## correctly. Breaking it into two sed invocations is a workaround.
|
||||
tr ' ' "$nl" < "$tmpdepfile" \
|
||||
| sed -e 's/^\\$//' -e '/^$/d' -e "s|.*$object$||" -e '/:$/d' \
|
||||
| sed -e 's/$/ :/' >> "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
hp)
|
||||
# This case exists only to let depend.m4 do its work. It works by
|
||||
# looking at the text of this script. This case will never be run,
|
||||
# since it is checked for above.
|
||||
exit 1
|
||||
;;
|
||||
|
||||
sgi)
|
||||
if test "$libtool" = yes; then
|
||||
"$@" "-Wp,-MDupdate,$tmpdepfile"
|
||||
else
|
||||
"$@" -MDupdate "$tmpdepfile"
|
||||
fi
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile"
|
||||
exit $stat
|
||||
fi
|
||||
rm -f "$depfile"
|
||||
|
||||
if test -f "$tmpdepfile"; then # yes, the sourcefile depend on other files
|
||||
echo "$object : \\" > "$depfile"
|
||||
# Clip off the initial element (the dependent). Don't try to be
|
||||
# clever and replace this with sed code, as IRIX sed won't handle
|
||||
# lines with more than a fixed number of characters (4096 in
|
||||
# IRIX 6.2 sed, 8192 in IRIX 6.5). We also remove comment lines;
|
||||
# the IRIX cc adds comments like '#:fec' to the end of the
|
||||
# dependency line.
|
||||
tr ' ' "$nl" < "$tmpdepfile" \
|
||||
| sed -e 's/^.*\.o://' -e 's/#.*$//' -e '/^$/ d' \
|
||||
| tr "$nl" ' ' >> "$depfile"
|
||||
echo >> "$depfile"
|
||||
# The second pass generates a dummy entry for each header file.
|
||||
tr ' ' "$nl" < "$tmpdepfile" \
|
||||
| sed -e 's/^.*\.o://' -e 's/#.*$//' -e '/^$/ d' -e 's/$/:/' \
|
||||
>> "$depfile"
|
||||
else
|
||||
make_dummy_depfile
|
||||
fi
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
xlc)
|
||||
# This case exists only to let depend.m4 do its work. It works by
|
||||
# looking at the text of this script. This case will never be run,
|
||||
# since it is checked for above.
|
||||
exit 1
|
||||
;;
|
||||
|
||||
aix)
|
||||
# The C for AIX Compiler uses -M and outputs the dependencies
|
||||
# in a .u file. In older versions, this file always lives in the
|
||||
# current directory. Also, the AIX compiler puts '$object:' at the
|
||||
# start of each line; $object doesn't have directory information.
|
||||
# Version 6 uses the directory in both cases.
|
||||
set_dir_from "$object"
|
||||
set_base_from "$object"
|
||||
if test "$libtool" = yes; then
|
||||
tmpdepfile1=$dir$base.u
|
||||
tmpdepfile2=$base.u
|
||||
tmpdepfile3=$dir.libs/$base.u
|
||||
"$@" -Wc,-M
|
||||
else
|
||||
tmpdepfile1=$dir$base.u
|
||||
tmpdepfile2=$dir$base.u
|
||||
tmpdepfile3=$dir$base.u
|
||||
"$@" -M
|
||||
fi
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile1" "$tmpdepfile2" "$tmpdepfile3"
|
||||
exit $stat
|
||||
fi
|
||||
|
||||
for tmpdepfile in "$tmpdepfile1" "$tmpdepfile2" "$tmpdepfile3"
|
||||
do
|
||||
test -f "$tmpdepfile" && break
|
||||
done
|
||||
aix_post_process_depfile
|
||||
;;
|
||||
|
||||
tcc)
|
||||
# tcc (Tiny C Compiler) understand '-MD -MF file' since version 0.9.26
|
||||
# FIXME: That version still under development at the moment of writing.
|
||||
# Make that this statement remains true also for stable, released
|
||||
# versions.
|
||||
# It will wrap lines (doesn't matter whether long or short) with a
|
||||
# trailing '\', as in:
|
||||
#
|
||||
# foo.o : \
|
||||
# foo.c \
|
||||
# foo.h \
|
||||
#
|
||||
# It will put a trailing '\' even on the last line, and will use leading
|
||||
# spaces rather than leading tabs (at least since its commit 0394caf7
|
||||
# "Emit spaces for -MD").
|
||||
"$@" -MD -MF "$tmpdepfile"
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile"
|
||||
exit $stat
|
||||
fi
|
||||
rm -f "$depfile"
|
||||
# Each non-empty line is of the form 'foo.o : \' or ' dep.h \'.
|
||||
# We have to change lines of the first kind to '$object: \'.
|
||||
sed -e "s|.*:|$object :|" < "$tmpdepfile" > "$depfile"
|
||||
# And for each line of the second kind, we have to emit a 'dep.h:'
|
||||
# dummy dependency, to avoid the deleted-header problem.
|
||||
sed -n -e 's|^ *\(.*\) *\\$|\1:|p' < "$tmpdepfile" >> "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
## The order of this option in the case statement is important, since the
|
||||
## shell code in configure will try each of these formats in the order
|
||||
## listed in this file. A plain '-MD' option would be understood by many
|
||||
## compilers, so we must ensure this comes after the gcc and icc options.
|
||||
pgcc)
|
||||
# Portland's C compiler understands '-MD'.
|
||||
# Will always output deps to 'file.d' where file is the root name of the
|
||||
# source file under compilation, even if file resides in a subdirectory.
|
||||
# The object file name does not affect the name of the '.d' file.
|
||||
# pgcc 10.2 will output
|
||||
# foo.o: sub/foo.c sub/foo.h
|
||||
# and will wrap long lines using '\' :
|
||||
# foo.o: sub/foo.c ... \
|
||||
# sub/foo.h ... \
|
||||
# ...
|
||||
set_dir_from "$object"
|
||||
# Use the source, not the object, to determine the base name, since
|
||||
# that's sadly what pgcc will do too.
|
||||
set_base_from "$source"
|
||||
tmpdepfile=$base.d
|
||||
|
||||
# For projects that build the same source file twice into different object
|
||||
# files, the pgcc approach of using the *source* file root name can cause
|
||||
# problems in parallel builds. Use a locking strategy to avoid stomping on
|
||||
# the same $tmpdepfile.
|
||||
lockdir=$base.d-lock
|
||||
trap "
|
||||
echo '$0: caught signal, cleaning up...' >&2
|
||||
rmdir '$lockdir'
|
||||
exit 1
|
||||
" 1 2 13 15
|
||||
numtries=100
|
||||
i=$numtries
|
||||
while test $i -gt 0; do
|
||||
# mkdir is a portable test-and-set.
|
||||
if mkdir "$lockdir" 2>/dev/null; then
|
||||
# This process acquired the lock.
|
||||
"$@" -MD
|
||||
stat=$?
|
||||
# Release the lock.
|
||||
rmdir "$lockdir"
|
||||
break
|
||||
else
|
||||
# If the lock is being held by a different process, wait
|
||||
# until the winning process is done or we timeout.
|
||||
while test -d "$lockdir" && test $i -gt 0; do
|
||||
sleep 1
|
||||
i=`expr $i - 1`
|
||||
done
|
||||
fi
|
||||
i=`expr $i - 1`
|
||||
done
|
||||
trap - 1 2 13 15
|
||||
if test $i -le 0; then
|
||||
echo "$0: failed to acquire lock after $numtries attempts" >&2
|
||||
echo "$0: check lockdir '$lockdir'" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile"
|
||||
exit $stat
|
||||
fi
|
||||
rm -f "$depfile"
|
||||
# Each line is of the form `foo.o: dependent.h',
|
||||
# or `foo.o: dep1.h dep2.h \', or ` dep3.h dep4.h \'.
|
||||
# Do two passes, one to just change these to
|
||||
# `$object: dependent.h' and one to simply `dependent.h:'.
|
||||
sed "s,^[^:]*:,$object :," < "$tmpdepfile" > "$depfile"
|
||||
# Some versions of the HPUX 10.20 sed can't process this invocation
|
||||
# correctly. Breaking it into two sed invocations is a workaround.
|
||||
sed 's,^[^:]*: \(.*\)$,\1,;s/^\\$//;/^$/d;/:$/d' < "$tmpdepfile" \
|
||||
| sed -e 's/$/ :/' >> "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
hp2)
|
||||
# The "hp" stanza above does not work with aCC (C++) and HP's ia64
|
||||
# compilers, which have integrated preprocessors. The correct option
|
||||
# to use with these is +Maked; it writes dependencies to a file named
|
||||
# 'foo.d', which lands next to the object file, wherever that
|
||||
# happens to be.
|
||||
# Much of this is similar to the tru64 case; see comments there.
|
||||
set_dir_from "$object"
|
||||
set_base_from "$object"
|
||||
if test "$libtool" = yes; then
|
||||
tmpdepfile1=$dir$base.d
|
||||
tmpdepfile2=$dir.libs/$base.d
|
||||
"$@" -Wc,+Maked
|
||||
else
|
||||
tmpdepfile1=$dir$base.d
|
||||
tmpdepfile2=$dir$base.d
|
||||
"$@" +Maked
|
||||
fi
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile1" "$tmpdepfile2"
|
||||
exit $stat
|
||||
fi
|
||||
|
||||
for tmpdepfile in "$tmpdepfile1" "$tmpdepfile2"
|
||||
do
|
||||
test -f "$tmpdepfile" && break
|
||||
done
|
||||
if test -f "$tmpdepfile"; then
|
||||
sed -e "s,^.*\.[$lower]*:,$object:," "$tmpdepfile" > "$depfile"
|
||||
# Add 'dependent.h:' lines.
|
||||
sed -ne '2,${
|
||||
s/^ *//
|
||||
s/ \\*$//
|
||||
s/$/:/
|
||||
p
|
||||
}' "$tmpdepfile" >> "$depfile"
|
||||
else
|
||||
make_dummy_depfile
|
||||
fi
|
||||
rm -f "$tmpdepfile" "$tmpdepfile2"
|
||||
;;
|
||||
|
||||
tru64)
|
||||
# The Tru64 compiler uses -MD to generate dependencies as a side
|
||||
# effect. 'cc -MD -o foo.o ...' puts the dependencies into 'foo.o.d'.
|
||||
# At least on Alpha/Redhat 6.1, Compaq CCC V6.2-504 seems to put
|
||||
# dependencies in 'foo.d' instead, so we check for that too.
|
||||
# Subdirectories are respected.
|
||||
set_dir_from "$object"
|
||||
set_base_from "$object"
|
||||
|
||||
if test "$libtool" = yes; then
|
||||
# Libtool generates 2 separate objects for the 2 libraries. These
|
||||
# two compilations output dependencies in $dir.libs/$base.o.d and
|
||||
# in $dir$base.o.d. We have to check for both files, because
|
||||
# one of the two compilations can be disabled. We should prefer
|
||||
# $dir$base.o.d over $dir.libs/$base.o.d because the latter is
|
||||
# automatically cleaned when .libs/ is deleted, while ignoring
|
||||
# the former would cause a distcleancheck panic.
|
||||
tmpdepfile1=$dir$base.o.d # libtool 1.5
|
||||
tmpdepfile2=$dir.libs/$base.o.d # Likewise.
|
||||
tmpdepfile3=$dir.libs/$base.d # Compaq CCC V6.2-504
|
||||
"$@" -Wc,-MD
|
||||
else
|
||||
tmpdepfile1=$dir$base.d
|
||||
tmpdepfile2=$dir$base.d
|
||||
tmpdepfile3=$dir$base.d
|
||||
"$@" -MD
|
||||
fi
|
||||
|
||||
stat=$?
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile1" "$tmpdepfile2" "$tmpdepfile3"
|
||||
exit $stat
|
||||
fi
|
||||
|
||||
for tmpdepfile in "$tmpdepfile1" "$tmpdepfile2" "$tmpdepfile3"
|
||||
do
|
||||
test -f "$tmpdepfile" && break
|
||||
done
|
||||
# Same post-processing that is required for AIX mode.
|
||||
aix_post_process_depfile
|
||||
;;
|
||||
|
||||
msvc7)
|
||||
if test "$libtool" = yes; then
|
||||
showIncludes=-Wc,-showIncludes
|
||||
else
|
||||
showIncludes=-showIncludes
|
||||
fi
|
||||
"$@" $showIncludes > "$tmpdepfile"
|
||||
stat=$?
|
||||
grep -v '^Note: including file: ' "$tmpdepfile"
|
||||
if test $stat -ne 0; then
|
||||
rm -f "$tmpdepfile"
|
||||
exit $stat
|
||||
fi
|
||||
rm -f "$depfile"
|
||||
echo "$object : \\" > "$depfile"
|
||||
# The first sed program below extracts the file names and escapes
|
||||
# backslashes for cygpath. The second sed program outputs the file
|
||||
# name when reading, but also accumulates all include files in the
|
||||
# hold buffer in order to output them again at the end. This only
|
||||
# works with sed implementations that can handle large buffers.
|
||||
sed < "$tmpdepfile" -n '
|
||||
/^Note: including file: *\(.*\)/ {
|
||||
s//\1/
|
||||
s/\\/\\\\/g
|
||||
p
|
||||
}' | $cygpath_u | sort -u | sed -n '
|
||||
s/ /\\ /g
|
||||
s/\(.*\)/'"$tab"'\1 \\/p
|
||||
s/.\(.*\) \\/\1:/
|
||||
H
|
||||
$ {
|
||||
s/.*/'"$tab"'/
|
||||
G
|
||||
p
|
||||
}' >> "$depfile"
|
||||
echo >> "$depfile" # make sure the fragment doesn't end with a backslash
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
msvc7msys)
|
||||
# This case exists only to let depend.m4 do its work. It works by
|
||||
# looking at the text of this script. This case will never be run,
|
||||
# since it is checked for above.
|
||||
exit 1
|
||||
;;
|
||||
|
||||
#nosideeffect)
|
||||
# This comment above is used by automake to tell side-effect
|
||||
# dependency tracking mechanisms from slower ones.
|
||||
|
||||
dashmstdout)
|
||||
# Important note: in order to support this mode, a compiler *must*
|
||||
# always write the preprocessed file to stdout, regardless of -o.
|
||||
"$@" || exit $?
|
||||
|
||||
# Remove the call to Libtool.
|
||||
if test "$libtool" = yes; then
|
||||
while test "X$1" != 'X--mode=compile'; do
|
||||
shift
|
||||
done
|
||||
shift
|
||||
fi
|
||||
|
||||
# Remove '-o $object'.
|
||||
IFS=" "
|
||||
for arg
|
||||
do
|
||||
case $arg in
|
||||
-o)
|
||||
shift
|
||||
;;
|
||||
$object)
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
set fnord "$@" "$arg"
|
||||
shift # fnord
|
||||
shift # $arg
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
test -z "$dashmflag" && dashmflag=-M
|
||||
# Require at least two characters before searching for ':'
|
||||
# in the target name. This is to cope with DOS-style filenames:
|
||||
# a dependency such as 'c:/foo/bar' could be seen as target 'c' otherwise.
|
||||
"$@" $dashmflag |
|
||||
sed "s|^[$tab ]*[^:$tab ][^:][^:]*:[$tab ]*|$object: |" > "$tmpdepfile"
|
||||
rm -f "$depfile"
|
||||
cat < "$tmpdepfile" > "$depfile"
|
||||
# Some versions of the HPUX 10.20 sed can't process this sed invocation
|
||||
# correctly. Breaking it into two sed invocations is a workaround.
|
||||
tr ' ' "$nl" < "$tmpdepfile" \
|
||||
| sed -e 's/^\\$//' -e '/^$/d' -e '/:$/d' \
|
||||
| sed -e 's/$/ :/' >> "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
dashXmstdout)
|
||||
# This case only exists to satisfy depend.m4. It is never actually
|
||||
# run, as this mode is specially recognized in the preamble.
|
||||
exit 1
|
||||
;;
|
||||
|
||||
makedepend)
|
||||
"$@" || exit $?
|
||||
# Remove any Libtool call
|
||||
if test "$libtool" = yes; then
|
||||
while test "X$1" != 'X--mode=compile'; do
|
||||
shift
|
||||
done
|
||||
shift
|
||||
fi
|
||||
# X makedepend
|
||||
shift
|
||||
cleared=no eat=no
|
||||
for arg
|
||||
do
|
||||
case $cleared in
|
||||
no)
|
||||
set ""; shift
|
||||
cleared=yes ;;
|
||||
esac
|
||||
if test $eat = yes; then
|
||||
eat=no
|
||||
continue
|
||||
fi
|
||||
case "$arg" in
|
||||
-D*|-I*)
|
||||
set fnord "$@" "$arg"; shift ;;
|
||||
# Strip any option that makedepend may not understand. Remove
|
||||
# the object too, otherwise makedepend will parse it as a source file.
|
||||
-arch)
|
||||
eat=yes ;;
|
||||
-*|$object)
|
||||
;;
|
||||
*)
|
||||
set fnord "$@" "$arg"; shift ;;
|
||||
esac
|
||||
done
|
||||
obj_suffix=`echo "$object" | sed 's/^.*\././'`
|
||||
touch "$tmpdepfile"
|
||||
${MAKEDEPEND-makedepend} -o"$obj_suffix" -f"$tmpdepfile" "$@"
|
||||
rm -f "$depfile"
|
||||
# makedepend may prepend the VPATH from the source file name to the object.
|
||||
# No need to regex-escape $object, excess matching of '.' is harmless.
|
||||
sed "s|^.*\($object *:\)|\1|" "$tmpdepfile" > "$depfile"
|
||||
# Some versions of the HPUX 10.20 sed can't process the last invocation
|
||||
# correctly. Breaking it into two sed invocations is a workaround.
|
||||
sed '1,2d' "$tmpdepfile" \
|
||||
| tr ' ' "$nl" \
|
||||
| sed -e 's/^\\$//' -e '/^$/d' -e '/:$/d' \
|
||||
| sed -e 's/$/ :/' >> "$depfile"
|
||||
rm -f "$tmpdepfile" "$tmpdepfile".bak
|
||||
;;
|
||||
|
||||
cpp)
|
||||
# Important note: in order to support this mode, a compiler *must*
|
||||
# always write the preprocessed file to stdout.
|
||||
"$@" || exit $?
|
||||
|
||||
# Remove the call to Libtool.
|
||||
if test "$libtool" = yes; then
|
||||
while test "X$1" != 'X--mode=compile'; do
|
||||
shift
|
||||
done
|
||||
shift
|
||||
fi
|
||||
|
||||
# Remove '-o $object'.
|
||||
IFS=" "
|
||||
for arg
|
||||
do
|
||||
case $arg in
|
||||
-o)
|
||||
shift
|
||||
;;
|
||||
$object)
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
set fnord "$@" "$arg"
|
||||
shift # fnord
|
||||
shift # $arg
|
||||
;;
|
||||
esac
|
||||
done
|
||||
|
||||
"$@" -E \
|
||||
| sed -n -e '/^# [0-9][0-9]* "\([^"]*\)".*/ s:: \1 \\:p' \
|
||||
-e '/^#line [0-9][0-9]* "\([^"]*\)".*/ s:: \1 \\:p' \
|
||||
| sed '$ s: \\$::' > "$tmpdepfile"
|
||||
rm -f "$depfile"
|
||||
echo "$object : \\" > "$depfile"
|
||||
cat < "$tmpdepfile" >> "$depfile"
|
||||
sed < "$tmpdepfile" '/^$/d;s/^ //;s/ \\$//;s/$/ :/' >> "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
msvisualcpp)
|
||||
# Important note: in order to support this mode, a compiler *must*
|
||||
# always write the preprocessed file to stdout.
|
||||
"$@" || exit $?
|
||||
|
||||
# Remove the call to Libtool.
|
||||
if test "$libtool" = yes; then
|
||||
while test "X$1" != 'X--mode=compile'; do
|
||||
shift
|
||||
done
|
||||
shift
|
||||
fi
|
||||
|
||||
IFS=" "
|
||||
for arg
|
||||
do
|
||||
case "$arg" in
|
||||
-o)
|
||||
shift
|
||||
;;
|
||||
$object)
|
||||
shift
|
||||
;;
|
||||
"-Gm"|"/Gm"|"-Gi"|"/Gi"|"-ZI"|"/ZI")
|
||||
set fnord "$@"
|
||||
shift
|
||||
shift
|
||||
;;
|
||||
*)
|
||||
set fnord "$@" "$arg"
|
||||
shift
|
||||
shift
|
||||
;;
|
||||
esac
|
||||
done
|
||||
"$@" -E 2>/dev/null |
|
||||
sed -n '/^#line [0-9][0-9]* "\([^"]*\)"/ s::\1:p' | $cygpath_u | sort -u > "$tmpdepfile"
|
||||
rm -f "$depfile"
|
||||
echo "$object : \\" > "$depfile"
|
||||
sed < "$tmpdepfile" -n -e 's% %\\ %g' -e '/^\(.*\)$/ s::'"$tab"'\1 \\:p' >> "$depfile"
|
||||
echo "$tab" >> "$depfile"
|
||||
sed < "$tmpdepfile" -n -e 's% %\\ %g' -e '/^\(.*\)$/ s::\1\::p' >> "$depfile"
|
||||
rm -f "$tmpdepfile"
|
||||
;;
|
||||
|
||||
msvcmsys)
|
||||
# This case exists only to let depend.m4 do its work. It works by
|
||||
# looking at the text of this script. This case will never be run,
|
||||
# since it is checked for above.
|
||||
exit 1
|
||||
;;
|
||||
|
||||
none)
|
||||
exec "$@"
|
||||
;;
|
||||
|
||||
*)
|
||||
echo "Unknown depmode $depmode" 1>&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
||||
exit 0
|
||||
|
||||
# Local Variables:
|
||||
# mode: shell-script
|
||||
# sh-indentation: 2
|
||||
# eval: (add-hook 'before-save-hook 'time-stamp)
|
||||
# time-stamp-start: "scriptversion="
|
||||
# time-stamp-format: "%:y-%02m-%02d.%02H"
|
||||
# time-stamp-time-zone: "UTC0"
|
||||
# time-stamp-end: "; # UTC"
|
||||
# End:
|
||||
632
Packages/asio-1.36.0/include/Makefile.am
vendored
Normal file
632
Packages/asio-1.36.0/include/Makefile.am
vendored
Normal file
@@ -0,0 +1,632 @@
|
||||
# find . -name "*.*pp" | sed -e 's/^\.\///' | sed -e 's/^.*$/ & \\/' | sort
|
||||
nobase_include_HEADERS = \
|
||||
asio/any_completion_executor.hpp \
|
||||
asio/any_completion_handler.hpp \
|
||||
asio/any_io_executor.hpp \
|
||||
asio/append.hpp \
|
||||
asio/as_tuple.hpp \
|
||||
asio/associated_allocator.hpp \
|
||||
asio/associated_cancellation_slot.hpp \
|
||||
asio/associated_executor.hpp \
|
||||
asio/associated_immediate_executor.hpp \
|
||||
asio/associator.hpp \
|
||||
asio/async_result.hpp \
|
||||
asio/awaitable.hpp \
|
||||
asio/basic_datagram_socket.hpp \
|
||||
asio/basic_deadline_timer.hpp \
|
||||
asio/basic_file.hpp \
|
||||
asio/basic_io_object.hpp \
|
||||
asio/basic_random_access_file.hpp \
|
||||
asio/basic_raw_socket.hpp \
|
||||
asio/basic_readable_pipe.hpp \
|
||||
asio/basic_seq_packet_socket.hpp \
|
||||
asio/basic_serial_port.hpp \
|
||||
asio/basic_signal_set.hpp \
|
||||
asio/basic_socket_acceptor.hpp \
|
||||
asio/basic_socket.hpp \
|
||||
asio/basic_socket_iostream.hpp \
|
||||
asio/basic_socket_streambuf.hpp \
|
||||
asio/basic_streambuf_fwd.hpp \
|
||||
asio/basic_streambuf.hpp \
|
||||
asio/basic_stream_file.hpp \
|
||||
asio/basic_stream_socket.hpp \
|
||||
asio/basic_waitable_timer.hpp \
|
||||
asio/basic_writable_pipe.hpp \
|
||||
asio/bind_allocator.hpp \
|
||||
asio/bind_cancellation_slot.hpp \
|
||||
asio/bind_executor.hpp \
|
||||
asio/bind_immediate_executor.hpp \
|
||||
asio/buffered_read_stream_fwd.hpp \
|
||||
asio/buffered_read_stream.hpp \
|
||||
asio/buffered_stream_fwd.hpp \
|
||||
asio/buffered_stream.hpp \
|
||||
asio/buffered_write_stream_fwd.hpp \
|
||||
asio/buffered_write_stream.hpp \
|
||||
asio/buffer.hpp \
|
||||
asio/buffer_registration.hpp \
|
||||
asio/buffers_iterator.hpp \
|
||||
asio/cancel_after.hpp \
|
||||
asio/cancel_at.hpp \
|
||||
asio/cancellation_signal.hpp \
|
||||
asio/cancellation_state.hpp \
|
||||
asio/cancellation_type.hpp \
|
||||
asio/co_composed.hpp \
|
||||
asio/co_spawn.hpp \
|
||||
asio/completion_condition.hpp \
|
||||
asio/compose.hpp \
|
||||
asio/composed.hpp \
|
||||
asio/config.hpp \
|
||||
asio/connect.hpp \
|
||||
asio/connect_pipe.hpp \
|
||||
asio/consign.hpp \
|
||||
asio/coroutine.hpp \
|
||||
asio/deadline_timer.hpp \
|
||||
asio/defer.hpp \
|
||||
asio/deferred.hpp \
|
||||
asio/default_completion_token.hpp \
|
||||
asio/detached.hpp \
|
||||
asio/detail/array_fwd.hpp \
|
||||
asio/detail/array.hpp \
|
||||
asio/detail/assert.hpp \
|
||||
asio/detail/atomic_count.hpp \
|
||||
asio/detail/base_from_cancellation_state.hpp \
|
||||
asio/detail/base_from_completion_cond.hpp \
|
||||
asio/detail/bind_handler.hpp \
|
||||
asio/detail/blocking_executor_op.hpp \
|
||||
asio/detail/buffered_stream_storage.hpp \
|
||||
asio/detail/buffer_resize_guard.hpp \
|
||||
asio/detail/buffer_sequence_adapter.hpp \
|
||||
asio/detail/call_stack.hpp \
|
||||
asio/detail/chrono.hpp \
|
||||
asio/detail/chrono_time_traits.hpp \
|
||||
asio/detail/completion_handler.hpp \
|
||||
asio/detail/completion_message.hpp \
|
||||
asio/detail/completion_payload.hpp \
|
||||
asio/detail/completion_payload_handler.hpp \
|
||||
asio/detail/composed_work.hpp \
|
||||
asio/detail/concurrency_hint.hpp \
|
||||
asio/detail/conditionally_enabled_event.hpp \
|
||||
asio/detail/conditionally_enabled_mutex.hpp \
|
||||
asio/detail/config.hpp \
|
||||
asio/detail/consuming_buffers.hpp \
|
||||
asio/detail/cstddef.hpp \
|
||||
asio/detail/cstdint.hpp \
|
||||
asio/detail/date_time_fwd.hpp \
|
||||
asio/detail/deadline_timer_service.hpp \
|
||||
asio/detail/dependent_type.hpp \
|
||||
asio/detail/descriptor_ops.hpp \
|
||||
asio/detail/descriptor_read_op.hpp \
|
||||
asio/detail/descriptor_write_op.hpp \
|
||||
asio/detail/dev_poll_reactor.hpp \
|
||||
asio/detail/epoll_reactor.hpp \
|
||||
asio/detail/eventfd_select_interrupter.hpp \
|
||||
asio/detail/event.hpp \
|
||||
asio/detail/exception.hpp \
|
||||
asio/detail/executor_function.hpp \
|
||||
asio/detail/executor_op.hpp \
|
||||
asio/detail/fd_set_adapter.hpp \
|
||||
asio/detail/fenced_block.hpp \
|
||||
asio/detail/functional.hpp \
|
||||
asio/detail/future.hpp \
|
||||
asio/detail/global.hpp \
|
||||
asio/detail/handler_alloc_helpers.hpp \
|
||||
asio/detail/handler_cont_helpers.hpp \
|
||||
asio/detail/handler_tracking.hpp \
|
||||
asio/detail/handler_type_requirements.hpp \
|
||||
asio/detail/handler_work.hpp \
|
||||
asio/detail/hash_map.hpp \
|
||||
asio/detail/impl/buffer_sequence_adapter.ipp \
|
||||
asio/detail/impl/descriptor_ops.ipp \
|
||||
asio/detail/impl/dev_poll_reactor.hpp \
|
||||
asio/detail/impl/dev_poll_reactor.ipp \
|
||||
asio/detail/impl/epoll_reactor.hpp \
|
||||
asio/detail/impl/epoll_reactor.ipp \
|
||||
asio/detail/impl/eventfd_select_interrupter.ipp \
|
||||
asio/detail/impl/handler_tracking.ipp \
|
||||
asio/detail/impl/io_uring_descriptor_service.ipp \
|
||||
asio/detail/impl/io_uring_file_service.ipp \
|
||||
asio/detail/impl/io_uring_service.hpp \
|
||||
asio/detail/impl/io_uring_service.ipp \
|
||||
asio/detail/impl/io_uring_socket_service_base.ipp \
|
||||
asio/detail/impl/kqueue_reactor.hpp \
|
||||
asio/detail/impl/kqueue_reactor.ipp \
|
||||
asio/detail/impl/null_event.ipp \
|
||||
asio/detail/impl/pipe_select_interrupter.ipp \
|
||||
asio/detail/impl/posix_event.ipp \
|
||||
asio/detail/impl/posix_mutex.ipp \
|
||||
asio/detail/impl/posix_serial_port_service.ipp \
|
||||
asio/detail/impl/posix_thread.ipp \
|
||||
asio/detail/impl/posix_tss_ptr.ipp \
|
||||
asio/detail/impl/reactive_descriptor_service.ipp \
|
||||
asio/detail/impl/reactive_socket_service_base.ipp \
|
||||
asio/detail/impl/resolver_service_base.ipp \
|
||||
asio/detail/impl/resolver_thread_pool.ipp \
|
||||
asio/detail/impl/scheduler.ipp \
|
||||
asio/detail/impl/select_reactor.hpp \
|
||||
asio/detail/impl/select_reactor.ipp \
|
||||
asio/detail/impl/service_registry.hpp \
|
||||
asio/detail/impl/service_registry.ipp \
|
||||
asio/detail/impl/signal_set_service.ipp \
|
||||
asio/detail/impl/socket_ops.ipp \
|
||||
asio/detail/impl/socket_select_interrupter.ipp \
|
||||
asio/detail/impl/strand_executor_service.hpp \
|
||||
asio/detail/impl/strand_executor_service.ipp \
|
||||
asio/detail/impl/strand_service.hpp \
|
||||
asio/detail/impl/strand_service.ipp \
|
||||
asio/detail/impl/thread_context.ipp \
|
||||
asio/detail/impl/throw_error.ipp \
|
||||
asio/detail/impl/timer_queue_set.ipp \
|
||||
asio/detail/impl/win_event.ipp \
|
||||
asio/detail/impl/win_iocp_file_service.ipp \
|
||||
asio/detail/impl/win_iocp_handle_service.ipp \
|
||||
asio/detail/impl/win_iocp_io_context.hpp \
|
||||
asio/detail/impl/win_iocp_io_context.ipp \
|
||||
asio/detail/impl/win_iocp_serial_port_service.ipp \
|
||||
asio/detail/impl/win_iocp_socket_service_base.ipp \
|
||||
asio/detail/impl/win_mutex.ipp \
|
||||
asio/detail/impl/win_object_handle_service.ipp \
|
||||
asio/detail/impl/winrt_ssocket_service_base.ipp \
|
||||
asio/detail/impl/winrt_timer_scheduler.hpp \
|
||||
asio/detail/impl/winrt_timer_scheduler.ipp \
|
||||
asio/detail/impl/winsock_init.ipp \
|
||||
asio/detail/impl/win_static_mutex.ipp \
|
||||
asio/detail/impl/win_thread.ipp \
|
||||
asio/detail/impl/win_tss_ptr.ipp \
|
||||
asio/detail/initiate_defer.hpp \
|
||||
asio/detail/initiate_dispatch.hpp \
|
||||
asio/detail/initiate_post.hpp \
|
||||
asio/detail/initiation_base.hpp \
|
||||
asio/detail/io_control.hpp \
|
||||
asio/detail/io_object_impl.hpp \
|
||||
asio/detail/io_uring_descriptor_read_at_op.hpp \
|
||||
asio/detail/io_uring_descriptor_read_op.hpp \
|
||||
asio/detail/io_uring_descriptor_service.hpp \
|
||||
asio/detail/io_uring_descriptor_write_at_op.hpp \
|
||||
asio/detail/io_uring_descriptor_write_op.hpp \
|
||||
asio/detail/io_uring_file_service.hpp \
|
||||
asio/detail/io_uring_null_buffers_op.hpp \
|
||||
asio/detail/io_uring_operation.hpp \
|
||||
asio/detail/io_uring_service.hpp \
|
||||
asio/detail/io_uring_socket_accept_op.hpp \
|
||||
asio/detail/io_uring_socket_connect_op.hpp \
|
||||
asio/detail/io_uring_socket_recvfrom_op.hpp \
|
||||
asio/detail/io_uring_socket_recvmsg_op.hpp \
|
||||
asio/detail/io_uring_socket_recv_op.hpp \
|
||||
asio/detail/io_uring_socket_send_op.hpp \
|
||||
asio/detail/io_uring_socket_sendto_op.hpp \
|
||||
asio/detail/io_uring_socket_service_base.hpp \
|
||||
asio/detail/io_uring_socket_service.hpp \
|
||||
asio/detail/io_uring_wait_op.hpp \
|
||||
asio/detail/is_buffer_sequence.hpp \
|
||||
asio/detail/is_executor.hpp \
|
||||
asio/detail/keyword_tss_ptr.hpp \
|
||||
asio/detail/kqueue_reactor.hpp \
|
||||
asio/detail/limits.hpp \
|
||||
asio/detail/local_free_on_block_exit.hpp \
|
||||
asio/detail/memory.hpp \
|
||||
asio/detail/mutex.hpp \
|
||||
asio/detail/non_const_lvalue.hpp \
|
||||
asio/detail/noncopyable.hpp \
|
||||
asio/detail/null_event.hpp \
|
||||
asio/detail/null_fenced_block.hpp \
|
||||
asio/detail/null_global.hpp \
|
||||
asio/detail/null_mutex.hpp \
|
||||
asio/detail/null_reactor.hpp \
|
||||
asio/detail/null_signal_blocker.hpp \
|
||||
asio/detail/null_socket_service.hpp \
|
||||
asio/detail/null_static_mutex.hpp \
|
||||
asio/detail/null_thread.hpp \
|
||||
asio/detail/null_tss_ptr.hpp \
|
||||
asio/detail/object_pool.hpp \
|
||||
asio/detail/old_win_sdk_compat.hpp \
|
||||
asio/detail/operation.hpp \
|
||||
asio/detail/op_queue.hpp \
|
||||
asio/detail/pipe_select_interrupter.hpp \
|
||||
asio/detail/pop_options.hpp \
|
||||
asio/detail/posix_event.hpp \
|
||||
asio/detail/posix_fd_set_adapter.hpp \
|
||||
asio/detail/posix_global.hpp \
|
||||
asio/detail/posix_mutex.hpp \
|
||||
asio/detail/posix_serial_port_service.hpp \
|
||||
asio/detail/posix_signal_blocker.hpp \
|
||||
asio/detail/posix_static_mutex.hpp \
|
||||
asio/detail/posix_thread.hpp \
|
||||
asio/detail/posix_tss_ptr.hpp \
|
||||
asio/detail/push_options.hpp \
|
||||
asio/detail/reactive_descriptor_service.hpp \
|
||||
asio/detail/reactive_null_buffers_op.hpp \
|
||||
asio/detail/reactive_socket_accept_op.hpp \
|
||||
asio/detail/reactive_socket_connect_op.hpp \
|
||||
asio/detail/reactive_socket_recvfrom_op.hpp \
|
||||
asio/detail/reactive_socket_recvmsg_op.hpp \
|
||||
asio/detail/reactive_socket_recv_op.hpp \
|
||||
asio/detail/reactive_socket_send_op.hpp \
|
||||
asio/detail/reactive_socket_sendto_op.hpp \
|
||||
asio/detail/reactive_socket_service_base.hpp \
|
||||
asio/detail/reactive_socket_service.hpp \
|
||||
asio/detail/reactive_wait_op.hpp \
|
||||
asio/detail/reactor.hpp \
|
||||
asio/detail/reactor_op.hpp \
|
||||
asio/detail/reactor_op_queue.hpp \
|
||||
asio/detail/recycling_allocator.hpp \
|
||||
asio/detail/regex_fwd.hpp \
|
||||
asio/detail/resolve_endpoint_op.hpp \
|
||||
asio/detail/resolve_op.hpp \
|
||||
asio/detail/resolve_query_op.hpp \
|
||||
asio/detail/resolver_service_base.hpp \
|
||||
asio/detail/resolver_thread_pool.hpp \
|
||||
asio/detail/resolver_service.hpp \
|
||||
asio/detail/scheduler.hpp \
|
||||
asio/detail/scheduler_operation.hpp \
|
||||
asio/detail/scheduler_task.hpp \
|
||||
asio/detail/scheduler_thread_info.hpp \
|
||||
asio/detail/scoped_lock.hpp \
|
||||
asio/detail/scoped_ptr.hpp \
|
||||
asio/detail/select_interrupter.hpp \
|
||||
asio/detail/select_reactor.hpp \
|
||||
asio/detail/service_registry.hpp \
|
||||
asio/detail/signal_blocker.hpp \
|
||||
asio/detail/signal_handler.hpp \
|
||||
asio/detail/signal_init.hpp \
|
||||
asio/detail/signal_op.hpp \
|
||||
asio/detail/signal_set_service.hpp \
|
||||
asio/detail/socket_holder.hpp \
|
||||
asio/detail/socket_ops.hpp \
|
||||
asio/detail/socket_option.hpp \
|
||||
asio/detail/socket_select_interrupter.hpp \
|
||||
asio/detail/socket_types.hpp \
|
||||
asio/detail/source_location.hpp \
|
||||
asio/detail/static_mutex.hpp \
|
||||
asio/detail/std_event.hpp \
|
||||
asio/detail/std_fenced_block.hpp \
|
||||
asio/detail/std_global.hpp \
|
||||
asio/detail/std_mutex.hpp \
|
||||
asio/detail/std_static_mutex.hpp \
|
||||
asio/detail/std_thread.hpp \
|
||||
asio/detail/strand_executor_service.hpp \
|
||||
asio/detail/strand_service.hpp \
|
||||
asio/detail/string_view.hpp \
|
||||
asio/detail/thread_context.hpp \
|
||||
asio/detail/thread_group.hpp \
|
||||
asio/detail/thread.hpp \
|
||||
asio/detail/thread_info_base.hpp \
|
||||
asio/detail/throw_error.hpp \
|
||||
asio/detail/throw_exception.hpp \
|
||||
asio/detail/timed_cancel_op.hpp \
|
||||
asio/detail/timer_queue_base.hpp \
|
||||
asio/detail/timer_queue.hpp \
|
||||
asio/detail/timer_queue_set.hpp \
|
||||
asio/detail/timer_scheduler_fwd.hpp \
|
||||
asio/detail/timer_scheduler.hpp \
|
||||
asio/detail/tss_ptr.hpp \
|
||||
asio/detail/type_traits.hpp \
|
||||
asio/detail/utility.hpp \
|
||||
asio/detail/wait_handler.hpp \
|
||||
asio/detail/wait_op.hpp \
|
||||
asio/detail/winapp_thread.hpp \
|
||||
asio/detail/wince_thread.hpp \
|
||||
asio/detail/win_event.hpp \
|
||||
asio/detail/win_fd_set_adapter.hpp \
|
||||
asio/detail/win_global.hpp \
|
||||
asio/detail/win_iocp_file_service.hpp \
|
||||
asio/detail/win_iocp_handle_read_op.hpp \
|
||||
asio/detail/win_iocp_handle_service.hpp \
|
||||
asio/detail/win_iocp_handle_write_op.hpp \
|
||||
asio/detail/win_iocp_io_context.hpp \
|
||||
asio/detail/win_iocp_null_buffers_op.hpp \
|
||||
asio/detail/win_iocp_operation.hpp \
|
||||
asio/detail/win_iocp_overlapped_op.hpp \
|
||||
asio/detail/win_iocp_overlapped_ptr.hpp \
|
||||
asio/detail/win_iocp_serial_port_service.hpp \
|
||||
asio/detail/win_iocp_socket_accept_op.hpp \
|
||||
asio/detail/win_iocp_socket_connect_op.hpp \
|
||||
asio/detail/win_iocp_socket_recvfrom_op.hpp \
|
||||
asio/detail/win_iocp_socket_recvmsg_op.hpp \
|
||||
asio/detail/win_iocp_socket_recv_op.hpp \
|
||||
asio/detail/win_iocp_socket_send_op.hpp \
|
||||
asio/detail/win_iocp_socket_service_base.hpp \
|
||||
asio/detail/win_iocp_socket_service.hpp \
|
||||
asio/detail/win_iocp_thread_info.hpp \
|
||||
asio/detail/win_iocp_wait_op.hpp \
|
||||
asio/detail/win_mutex.hpp \
|
||||
asio/detail/win_object_handle_service.hpp \
|
||||
asio/detail/winrt_async_manager.hpp \
|
||||
asio/detail/winrt_async_op.hpp \
|
||||
asio/detail/winrt_resolve_op.hpp \
|
||||
asio/detail/winrt_resolver_service.hpp \
|
||||
asio/detail/winrt_socket_connect_op.hpp \
|
||||
asio/detail/winrt_socket_recv_op.hpp \
|
||||
asio/detail/winrt_socket_send_op.hpp \
|
||||
asio/detail/winrt_ssocket_service_base.hpp \
|
||||
asio/detail/winrt_ssocket_service.hpp \
|
||||
asio/detail/winrt_timer_scheduler.hpp \
|
||||
asio/detail/winrt_utils.hpp \
|
||||
asio/detail/winsock_init.hpp \
|
||||
asio/detail/win_static_mutex.hpp \
|
||||
asio/detail/win_thread.hpp \
|
||||
asio/detail/win_tss_ptr.hpp \
|
||||
asio/detail/work_dispatcher.hpp \
|
||||
asio/detail/wrapped_handler.hpp \
|
||||
asio/dispatch.hpp \
|
||||
asio/disposition.hpp \
|
||||
asio/error_code.hpp \
|
||||
asio/error.hpp \
|
||||
asio/execution.hpp \
|
||||
asio/execution_context.hpp \
|
||||
asio/execution/allocator.hpp \
|
||||
asio/execution/any_executor.hpp \
|
||||
asio/execution/bad_executor.hpp \
|
||||
asio/execution/blocking.hpp \
|
||||
asio/execution/blocking_adaptation.hpp \
|
||||
asio/execution/context.hpp \
|
||||
asio/execution/context_as.hpp \
|
||||
asio/execution/executor.hpp \
|
||||
asio/execution/impl/bad_executor.ipp \
|
||||
asio/execution/invocable_archetype.hpp \
|
||||
asio/execution/mapping.hpp \
|
||||
asio/execution/occupancy.hpp \
|
||||
asio/execution/outstanding_work.hpp \
|
||||
asio/execution/prefer_only.hpp \
|
||||
asio/execution/relationship.hpp \
|
||||
asio/executor.hpp \
|
||||
asio/executor_work_guard.hpp \
|
||||
asio/experimental/as_single.hpp \
|
||||
asio/experimental/awaitable_operators.hpp \
|
||||
asio/experimental/basic_channel.hpp \
|
||||
asio/experimental/basic_concurrent_channel.hpp \
|
||||
asio/experimental/cancellation_condition.hpp \
|
||||
asio/experimental/channel.hpp \
|
||||
asio/experimental/channel_error.hpp \
|
||||
asio/experimental/channel_traits.hpp \
|
||||
asio/experimental/co_composed.hpp \
|
||||
asio/experimental/co_spawn.hpp \
|
||||
asio/experimental/concurrent_channel.hpp \
|
||||
asio/experimental/coro.hpp \
|
||||
asio/experimental/coro_traits.hpp \
|
||||
asio/experimental/detail/channel_operation.hpp \
|
||||
asio/experimental/detail/channel_receive_op.hpp \
|
||||
asio/experimental/detail/channel_send_functions.hpp \
|
||||
asio/experimental/detail/channel_send_op.hpp \
|
||||
asio/experimental/detail/channel_service.hpp \
|
||||
asio/experimental/detail/coro_completion_handler.hpp \
|
||||
asio/experimental/detail/coro_promise_allocator.hpp \
|
||||
asio/experimental/detail/has_signature.hpp \
|
||||
asio/experimental/detail/impl/channel_service.hpp \
|
||||
asio/experimental/detail/partial_promise.hpp \
|
||||
asio/experimental/impl/as_single.hpp \
|
||||
asio/experimental/impl/channel_error.ipp \
|
||||
asio/experimental/impl/coro.hpp \
|
||||
asio/experimental/impl/parallel_group.hpp \
|
||||
asio/experimental/impl/promise.hpp \
|
||||
asio/experimental/impl/use_coro.hpp \
|
||||
asio/experimental/impl/use_promise.hpp \
|
||||
asio/experimental/parallel_group.hpp \
|
||||
asio/experimental/promise.hpp \
|
||||
asio/experimental/use_coro.hpp \
|
||||
asio/experimental/use_promise.hpp \
|
||||
asio/file_base.hpp \
|
||||
asio/generic/basic_endpoint.hpp \
|
||||
asio/generic/datagram_protocol.hpp \
|
||||
asio/generic/detail/endpoint.hpp \
|
||||
asio/generic/detail/impl/endpoint.ipp \
|
||||
asio/generic/raw_protocol.hpp \
|
||||
asio/generic/seq_packet_protocol.hpp \
|
||||
asio/generic/stream_protocol.hpp \
|
||||
asio/handler_continuation_hook.hpp \
|
||||
asio/high_resolution_timer.hpp \
|
||||
asio.hpp \
|
||||
asio/immediate.hpp \
|
||||
asio/impl/any_completion_executor.ipp \
|
||||
asio/impl/any_io_executor.ipp \
|
||||
asio/impl/append.hpp \
|
||||
asio/impl/as_tuple.hpp \
|
||||
asio/impl/awaitable.hpp \
|
||||
asio/impl/awaitable.ipp \
|
||||
asio/impl/buffered_read_stream.hpp \
|
||||
asio/impl/buffered_write_stream.hpp \
|
||||
asio/impl/cancel_after.hpp \
|
||||
asio/impl/cancel_at.hpp \
|
||||
asio/impl/cancellation_signal.ipp \
|
||||
asio/impl/co_spawn.hpp \
|
||||
asio/impl/config.hpp \
|
||||
asio/impl/config.ipp \
|
||||
asio/impl/connect.hpp \
|
||||
asio/impl/connect_pipe.hpp \
|
||||
asio/impl/connect_pipe.ipp \
|
||||
asio/impl/consign.hpp \
|
||||
asio/impl/deferred.hpp \
|
||||
asio/impl/detached.hpp \
|
||||
asio/impl/error_code.ipp \
|
||||
asio/impl/error.ipp \
|
||||
asio/impl/execution_context.hpp \
|
||||
asio/impl/execution_context.ipp \
|
||||
asio/impl/executor.hpp \
|
||||
asio/impl/executor.ipp \
|
||||
asio/impl/io_context.hpp \
|
||||
asio/impl/io_context.ipp \
|
||||
asio/impl/multiple_exceptions.ipp \
|
||||
asio/impl/prepend.hpp \
|
||||
asio/impl/read_at.hpp \
|
||||
asio/impl/read.hpp \
|
||||
asio/impl/read_until.hpp \
|
||||
asio/impl/redirect_error.hpp \
|
||||
asio/impl/serial_port_base.hpp \
|
||||
asio/impl/serial_port_base.ipp \
|
||||
asio/impl/spawn.hpp \
|
||||
asio/impl/src.hpp \
|
||||
asio/impl/system_context.hpp \
|
||||
asio/impl/system_context.ipp \
|
||||
asio/impl/system_executor.hpp \
|
||||
asio/impl/thread_pool.hpp \
|
||||
asio/impl/thread_pool.ipp \
|
||||
asio/impl/use_awaitable.hpp \
|
||||
asio/impl/use_future.hpp \
|
||||
asio/impl/write_at.hpp \
|
||||
asio/impl/write.hpp \
|
||||
asio/io_context.hpp \
|
||||
asio/io_context_strand.hpp \
|
||||
asio/ip/address.hpp \
|
||||
asio/ip/address_v4.hpp \
|
||||
asio/ip/address_v4_iterator.hpp \
|
||||
asio/ip/address_v4_range.hpp \
|
||||
asio/ip/address_v6.hpp \
|
||||
asio/ip/address_v6_iterator.hpp \
|
||||
asio/ip/address_v6_range.hpp \
|
||||
asio/ip/bad_address_cast.hpp \
|
||||
asio/ip/basic_endpoint.hpp \
|
||||
asio/ip/basic_resolver_entry.hpp \
|
||||
asio/ip/basic_resolver.hpp \
|
||||
asio/ip/basic_resolver_iterator.hpp \
|
||||
asio/ip/basic_resolver_query.hpp \
|
||||
asio/ip/basic_resolver_results.hpp \
|
||||
asio/ip/detail/endpoint.hpp \
|
||||
asio/ip/detail/impl/endpoint.ipp \
|
||||
asio/ip/detail/socket_option.hpp \
|
||||
asio/ip/host_name.hpp \
|
||||
asio/ip/icmp.hpp \
|
||||
asio/ip/impl/address.hpp \
|
||||
asio/ip/impl/address.ipp \
|
||||
asio/ip/impl/address_v4.hpp \
|
||||
asio/ip/impl/address_v4.ipp \
|
||||
asio/ip/impl/address_v6.hpp \
|
||||
asio/ip/impl/address_v6.ipp \
|
||||
asio/ip/impl/basic_endpoint.hpp \
|
||||
asio/ip/impl/host_name.ipp \
|
||||
asio/ip/impl/network_v4.hpp \
|
||||
asio/ip/impl/network_v4.ipp \
|
||||
asio/ip/impl/network_v6.hpp \
|
||||
asio/ip/impl/network_v6.ipp \
|
||||
asio/ip/multicast.hpp \
|
||||
asio/ip/network_v4.hpp \
|
||||
asio/ip/network_v6.hpp \
|
||||
asio/ip/resolver_base.hpp \
|
||||
asio/ip/resolver_query_base.hpp \
|
||||
asio/ip/tcp.hpp \
|
||||
asio/ip/udp.hpp \
|
||||
asio/ip/unicast.hpp \
|
||||
asio/ip/v6_only.hpp \
|
||||
asio/is_applicable_property.hpp \
|
||||
asio/is_contiguous_iterator.hpp \
|
||||
asio/is_executor.hpp \
|
||||
asio/is_read_buffered.hpp \
|
||||
asio/is_write_buffered.hpp \
|
||||
asio/local/basic_endpoint.hpp \
|
||||
asio/local/connect_pair.hpp \
|
||||
asio/local/datagram_protocol.hpp \
|
||||
asio/local/detail/endpoint.hpp \
|
||||
asio/local/detail/impl/endpoint.ipp \
|
||||
asio/local/seq_packet_protocol.hpp \
|
||||
asio/local/stream_protocol.hpp \
|
||||
asio/multiple_exceptions.hpp \
|
||||
asio/packaged_task.hpp \
|
||||
asio/placeholders.hpp \
|
||||
asio/posix/basic_descriptor.hpp \
|
||||
asio/posix/basic_stream_descriptor.hpp \
|
||||
asio/posix/descriptor_base.hpp \
|
||||
asio/posix/descriptor.hpp \
|
||||
asio/posix/stream_descriptor.hpp \
|
||||
asio/post.hpp \
|
||||
asio/prefer.hpp \
|
||||
asio/prepend.hpp \
|
||||
asio/query.hpp \
|
||||
asio/random_access_file.hpp \
|
||||
asio/read_at.hpp \
|
||||
asio/read.hpp \
|
||||
asio/read_until.hpp \
|
||||
asio/readable_pipe.hpp \
|
||||
asio/recycling_allocator.hpp \
|
||||
asio/redirect_error.hpp \
|
||||
asio/registered_buffer.hpp \
|
||||
asio/require.hpp \
|
||||
asio/require_concept.hpp \
|
||||
asio/serial_port_base.hpp \
|
||||
asio/serial_port.hpp \
|
||||
asio/signal_set_base.hpp \
|
||||
asio/signal_set.hpp \
|
||||
asio/socket_base.hpp \
|
||||
asio/spawn.hpp \
|
||||
asio/ssl/context_base.hpp \
|
||||
asio/ssl/context.hpp \
|
||||
asio/ssl/detail/buffered_handshake_op.hpp \
|
||||
asio/ssl/detail/engine.hpp \
|
||||
asio/ssl/detail/handshake_op.hpp \
|
||||
asio/ssl/detail/impl/engine.ipp \
|
||||
asio/ssl/detail/impl/openssl_init.ipp \
|
||||
asio/ssl/detail/io.hpp \
|
||||
asio/ssl/detail/openssl_init.hpp \
|
||||
asio/ssl/detail/openssl_types.hpp \
|
||||
asio/ssl/detail/password_callback.hpp \
|
||||
asio/ssl/detail/read_op.hpp \
|
||||
asio/ssl/detail/shutdown_op.hpp \
|
||||
asio/ssl/detail/stream_core.hpp \
|
||||
asio/ssl/detail/verify_callback.hpp \
|
||||
asio/ssl/detail/write_op.hpp \
|
||||
asio/ssl/error.hpp \
|
||||
asio/ssl.hpp \
|
||||
asio/ssl/host_name_verification.hpp \
|
||||
asio/ssl/impl/context.hpp \
|
||||
asio/ssl/impl/context.ipp \
|
||||
asio/ssl/impl/error.ipp \
|
||||
asio/ssl/impl/host_name_verification.ipp \
|
||||
asio/ssl/impl/src.hpp \
|
||||
asio/ssl/stream_base.hpp \
|
||||
asio/ssl/stream.hpp \
|
||||
asio/ssl/verify_context.hpp \
|
||||
asio/ssl/verify_mode.hpp \
|
||||
asio/static_thread_pool.hpp \
|
||||
asio/steady_timer.hpp \
|
||||
asio/strand.hpp \
|
||||
asio/streambuf.hpp \
|
||||
asio/stream_file.hpp \
|
||||
asio/system_context.hpp \
|
||||
asio/system_error.hpp \
|
||||
asio/system_executor.hpp \
|
||||
asio/system_timer.hpp \
|
||||
asio/this_coro.hpp \
|
||||
asio/thread.hpp \
|
||||
asio/thread_pool.hpp \
|
||||
asio/time_traits.hpp \
|
||||
asio/traits/equality_comparable.hpp \
|
||||
asio/traits/execute_member.hpp \
|
||||
asio/traits/prefer_free.hpp \
|
||||
asio/traits/prefer_member.hpp \
|
||||
asio/traits/query_free.hpp \
|
||||
asio/traits/query_member.hpp \
|
||||
asio/traits/query_static_constexpr_member.hpp \
|
||||
asio/traits/require_concept_free.hpp \
|
||||
asio/traits/require_concept_member.hpp \
|
||||
asio/traits/require_free.hpp \
|
||||
asio/traits/require_member.hpp \
|
||||
asio/traits/static_query.hpp \
|
||||
asio/traits/static_require.hpp \
|
||||
asio/traits/static_require_concept.hpp \
|
||||
asio/ts/buffer.hpp \
|
||||
asio/ts/executor.hpp \
|
||||
asio/ts/internet.hpp \
|
||||
asio/ts/io_context.hpp \
|
||||
asio/ts/netfwd.hpp \
|
||||
asio/ts/net.hpp \
|
||||
asio/ts/socket.hpp \
|
||||
asio/ts/timer.hpp \
|
||||
asio/unyield.hpp \
|
||||
asio/use_awaitable.hpp \
|
||||
asio/use_future.hpp \
|
||||
asio/uses_executor.hpp \
|
||||
asio/version.hpp \
|
||||
asio/wait_traits.hpp \
|
||||
asio/windows/basic_object_handle.hpp \
|
||||
asio/windows/basic_overlapped_handle.hpp \
|
||||
asio/windows/basic_random_access_handle.hpp \
|
||||
asio/windows/basic_stream_handle.hpp \
|
||||
asio/windows/object_handle.hpp \
|
||||
asio/windows/overlapped_handle.hpp \
|
||||
asio/windows/overlapped_ptr.hpp \
|
||||
asio/windows/random_access_handle.hpp \
|
||||
asio/windows/stream_handle.hpp \
|
||||
asio/writable_pipe.hpp \
|
||||
asio/write_at.hpp \
|
||||
asio/write.hpp \
|
||||
asio/yield.hpp
|
||||
|
||||
MAINTAINERCLEANFILES = \
|
||||
$(srcdir)/Makefile.in
|
||||
1179
Packages/asio-1.36.0/include/Makefile.in
vendored
Normal file
1179
Packages/asio-1.36.0/include/Makefile.in
vendored
Normal file
File diff suppressed because it is too large
Load Diff
202
Packages/asio-1.36.0/include/asio.hpp
vendored
Normal file
202
Packages/asio-1.36.0/include/asio.hpp
vendored
Normal file
@@ -0,0 +1,202 @@
|
||||
//
|
||||
// asio.hpp
|
||||
// ~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_cancellation_slot.hpp"
|
||||
#include "asio/associated_executor.hpp"
|
||||
#include "asio/associated_immediate_executor.hpp"
|
||||
#include "asio/associator.hpp"
|
||||
#include "asio/async_result.hpp"
|
||||
#include "asio/awaitable.hpp"
|
||||
#include "asio/basic_datagram_socket.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/bind_immediate_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/cancel_after.hpp"
|
||||
#include "asio/cancel_at.hpp"
|
||||
#include "asio/cancellation_signal.hpp"
|
||||
#include "asio/cancellation_state.hpp"
|
||||
#include "asio/cancellation_type.hpp"
|
||||
#include "asio/co_composed.hpp"
|
||||
#include "asio/co_spawn.hpp"
|
||||
#include "asio/completion_condition.hpp"
|
||||
#include "asio/compose.hpp"
|
||||
#include "asio/composed.hpp"
|
||||
#include "asio/config.hpp"
|
||||
#include "asio/connect.hpp"
|
||||
#include "asio/connect_pipe.hpp"
|
||||
#include "asio/consign.hpp"
|
||||
#include "asio/coroutine.hpp"
|
||||
#include "asio/defer.hpp"
|
||||
#include "asio/deferred.hpp"
|
||||
#include "asio/default_completion_token.hpp"
|
||||
#include "asio/detached.hpp"
|
||||
#include "asio/dispatch.hpp"
|
||||
#include "asio/disposition.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/context.hpp"
|
||||
#include "asio/execution/context_as.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/outstanding_work.hpp"
|
||||
#include "asio/execution/prefer_only.hpp"
|
||||
#include "asio/execution/relationship.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_continuation_hook.hpp"
|
||||
#include "asio/high_resolution_timer.hpp"
|
||||
#include "asio/immediate.hpp"
|
||||
#include "asio/io_context.hpp"
|
||||
#include "asio/io_context_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/seq_packet_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/signal_set_base.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/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
|
||||
336
Packages/asio-1.36.0/include/asio/any_completion_executor.hpp
vendored
Normal file
336
Packages/asio-1.36.0/include/asio/any_completion_executor.hpp
vendored
Normal file
@@ -0,0 +1,336 @@
|
||||
//
|
||||
// any_completion_executor.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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() noexcept;
|
||||
|
||||
/// Construct in an empty state. Equivalent effects to default constructor.
|
||||
ASIO_DECL any_completion_executor(nullptr_t) noexcept;
|
||||
|
||||
/// Copy constructor.
|
||||
ASIO_DECL any_completion_executor(
|
||||
const any_completion_executor& e) noexcept;
|
||||
|
||||
/// Move constructor.
|
||||
ASIO_DECL any_completion_executor(
|
||||
any_completion_executor&& e) noexcept;
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
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
|
||||
> = 0)
|
||||
: base_type(static_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,
|
||||
constraint_t<
|
||||
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
|
||||
> = 0) noexcept
|
||||
: base_type(std::nothrow, static_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) noexcept;
|
||||
|
||||
/// Construct to point to the same target as another any_executor.
|
||||
ASIO_DECL any_completion_executor(std::nothrow_t,
|
||||
any_completion_executor&& e) noexcept;
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
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
|
||||
> = 0)
|
||||
: base_type(static_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,
|
||||
constraint_t<
|
||||
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
|
||||
> = 0) noexcept
|
||||
: base_type(std::nothrow, static_cast<Executor&&>(e))
|
||||
{
|
||||
}
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Assignment operator.
|
||||
ASIO_DECL any_completion_executor& operator=(
|
||||
const any_completion_executor& e) noexcept;
|
||||
|
||||
/// Move assignment operator.
|
||||
ASIO_DECL any_completion_executor& operator=(
|
||||
any_completion_executor&& e) noexcept;
|
||||
|
||||
/// 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) 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,
|
||||
constraint_t<
|
||||
traits::require_member<const base_type&, const Property&>::is_valid
|
||||
> = 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,
|
||||
constraint_t<
|
||||
traits::prefer_member<const base_type&, const Property&>::is_valid
|
||||
> = 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
|
||||
822
Packages/asio-1.36.0/include/asio/any_completion_handler.hpp
vendored
Normal file
822
Packages/asio-1.36.0/include/asio/any_completion_handler.hpp
vendored
Normal file
@@ -0,0 +1,822 @@
|
||||
//
|
||||
// any_completion_handler.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#include <cstring>
|
||||
#include <functional>
|
||||
#include <memory>
|
||||
#include <utility>
|
||||
#include "asio/any_completion_executor.hpp"
|
||||
#include "asio/any_io_executor.hpp"
|
||||
#include "asio/associated_allocator.hpp"
|
||||
#include "asio/associated_cancellation_slot.hpp"
|
||||
#include "asio/associated_executor.hpp"
|
||||
#include "asio/associated_immediate_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_(static_cast<S&&>(slot), enable_total_cancellation())
|
||||
{
|
||||
}
|
||||
|
||||
cancellation_slot get_cancellation_slot() const 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(static_cast<S&&>(slot)),
|
||||
handler_(static_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(
|
||||
static_cast<S&&>(slot), static_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 noexcept
|
||||
{
|
||||
return any_completion_executor(std::nothrow,
|
||||
(get_associated_executor)(handler_, candidate));
|
||||
}
|
||||
|
||||
any_completion_executor immediate_executor(
|
||||
const any_io_executor& candidate) const noexcept
|
||||
{
|
||||
return any_completion_executor(std::nothrow,
|
||||
(get_associated_immediate_executor)(handler_, candidate));
|
||||
}
|
||||
|
||||
void* allocate(std::size_t size, std::size_t align_size) 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_size - 1;
|
||||
unsigned char* base =
|
||||
std::allocator_traits<decltype(alloc)>::allocate(
|
||||
alloc, space + sizeof(std::ptrdiff_t));
|
||||
|
||||
void* p = base;
|
||||
if (detail::align(align_size, 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(static_cast<Handler&&>(handler_));
|
||||
ptr.reset();
|
||||
|
||||
static_cast<Handler&&>(handler)(
|
||||
static_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, static_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(
|
||||
static_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_immediate_executor_fn
|
||||
{
|
||||
public:
|
||||
using type = any_completion_executor(*)(
|
||||
any_completion_handler_impl_base*, const any_io_executor&);
|
||||
|
||||
constexpr any_completion_handler_immediate_executor_fn(type fn)
|
||||
: immediate_executor_fn_(fn)
|
||||
{
|
||||
}
|
||||
|
||||
any_completion_executor immediate_executor(
|
||||
any_completion_handler_impl_base* impl,
|
||||
const any_io_executor& candidate) const
|
||||
{
|
||||
return immediate_executor_fn_(impl, candidate);
|
||||
}
|
||||
|
||||
template <typename Handler>
|
||||
static any_completion_executor impl(any_completion_handler_impl_base* impl,
|
||||
const any_io_executor& candidate)
|
||||
{
|
||||
return static_cast<any_completion_handler_impl<Handler>*>(
|
||||
impl)->immediate_executor(candidate);
|
||||
}
|
||||
|
||||
private:
|
||||
type immediate_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_immediate_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_immediate_executor_fn::type immediate_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_immediate_executor_fn(immediate_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_immediate_executor_fn::immediate_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_immediate_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;
|
||||
|
||||
/// An allocator type that forwards memory allocation operations through an
|
||||
/// instance of @c 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) noexcept
|
||||
: fn_table_(h.fn_table_),
|
||||
impl_(h.impl_)
|
||||
{
|
||||
}
|
||||
|
||||
public:
|
||||
/// The type of objects that may be allocated by the allocator.
|
||||
typedef T value_type;
|
||||
|
||||
/// Rebinds an allocator to another value type.
|
||||
template <typename U>
|
||||
struct rebind
|
||||
{
|
||||
/// Specifies the type of the rebound allocator.
|
||||
typedef any_completion_handler_allocator<U, Signatures...> other;
|
||||
};
|
||||
|
||||
/// Construct from another @c any_completion_handler_allocator.
|
||||
template <typename U>
|
||||
constexpr any_completion_handler_allocator(
|
||||
const any_completion_handler_allocator<U, Signatures...>& a)
|
||||
noexcept
|
||||
: fn_table_(a.fn_table_),
|
||||
impl_(a.impl_)
|
||||
{
|
||||
}
|
||||
|
||||
/// Equality operator.
|
||||
constexpr bool operator==(
|
||||
const any_completion_handler_allocator& other) const noexcept
|
||||
{
|
||||
return fn_table_ == other.fn_table_ && impl_ == other.impl_;
|
||||
}
|
||||
|
||||
/// Inequality operator.
|
||||
constexpr bool operator!=(
|
||||
const any_completion_handler_allocator& other) const noexcept
|
||||
{
|
||||
return fn_table_ != other.fn_table_ || impl_ != other.impl_;
|
||||
}
|
||||
|
||||
/// Allocate space for @c n objects of the allocator's value type.
|
||||
T* allocate(std::size_t n) const
|
||||
{
|
||||
if (fn_table_)
|
||||
{
|
||||
return static_cast<T*>(
|
||||
fn_table_->allocate(
|
||||
impl_, sizeof(T) * n, alignof(T)));
|
||||
}
|
||||
std::bad_alloc ex;
|
||||
asio::detail::throw_exception(ex);
|
||||
return nullptr;
|
||||
}
|
||||
|
||||
/// Deallocate space for @c n objects of the allocator's value type.
|
||||
void deallocate(T* p, std::size_t n) const
|
||||
{
|
||||
fn_table_->deallocate(impl_, p, sizeof(T) * n, alignof(T));
|
||||
}
|
||||
};
|
||||
|
||||
/// A protoco-allocator type that may be rebound to obtain an allocator that
|
||||
/// forwards memory allocation operations through an instance of
|
||||
/// @c any_completion_handler.
|
||||
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) noexcept
|
||||
: fn_table_(h.fn_table_),
|
||||
impl_(h.impl_)
|
||||
{
|
||||
}
|
||||
|
||||
public:
|
||||
/// @c void as no objects can be allocated through a proto-allocator.
|
||||
typedef void value_type;
|
||||
|
||||
/// Rebinds an allocator to another value type.
|
||||
template <typename U>
|
||||
struct rebind
|
||||
{
|
||||
/// Specifies the type of the rebound allocator.
|
||||
typedef any_completion_handler_allocator<U, Signatures...> other;
|
||||
};
|
||||
|
||||
/// Construct from another @c any_completion_handler_allocator.
|
||||
template <typename U>
|
||||
constexpr any_completion_handler_allocator(
|
||||
const any_completion_handler_allocator<U, Signatures...>& a)
|
||||
noexcept
|
||||
: fn_table_(a.fn_table_),
|
||||
impl_(a.impl_)
|
||||
{
|
||||
}
|
||||
|
||||
/// Equality operator.
|
||||
constexpr bool operator==(
|
||||
const any_completion_handler_allocator& other) const noexcept
|
||||
{
|
||||
return fn_table_ == other.fn_table_ && impl_ == other.impl_;
|
||||
}
|
||||
|
||||
/// Inequality operator.
|
||||
constexpr bool operator!=(
|
||||
const any_completion_handler_allocator& other) const noexcept
|
||||
{
|
||||
return fn_table_ != other.fn_table_ || impl_ != other.impl_;
|
||||
}
|
||||
};
|
||||
|
||||
/// Polymorphic wrapper for completion handlers.
|
||||
/**
|
||||
* The @c any_completion_handler class template is a polymorphic wrapper for
|
||||
* completion handlers that propagates the associated executor, associated
|
||||
* allocator, and associated cancellation slot through a type-erasing interface.
|
||||
*
|
||||
* When using @c any_completion_handler, specify one or more completion
|
||||
* signatures as template parameters. These will dictate the arguments that may
|
||||
* be passed to the handler through the polymorphic interface.
|
||||
*
|
||||
* Typical uses for @c any_completion_handler include:
|
||||
*
|
||||
* @li Separate compilation of asynchronous operation implementations.
|
||||
*
|
||||
* @li Enabling interoperability between asynchronous operations and virtual
|
||||
* functions.
|
||||
*/
|
||||
template <typename... Signatures>
|
||||
class any_completion_handler
|
||||
{
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
private:
|
||||
template <typename, typename...>
|
||||
friend class any_completion_handler_allocator;
|
||||
|
||||
template <typename, typename>
|
||||
friend struct associated_executor;
|
||||
|
||||
template <typename, typename>
|
||||
friend struct associated_immediate_executor;
|
||||
|
||||
const detail::any_completion_handler_fn_table<Signatures...>* fn_table_;
|
||||
detail::any_completion_handler_impl_base* impl_;
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
public:
|
||||
/// The associated allocator type.
|
||||
using allocator_type = any_completion_handler_allocator<void, Signatures...>;
|
||||
|
||||
/// The associated cancellation slot type.
|
||||
using cancellation_slot_type = cancellation_slot;
|
||||
|
||||
/// Construct an @c any_completion_handler in an empty state, without a target
|
||||
/// object.
|
||||
constexpr any_completion_handler()
|
||||
: fn_table_(nullptr),
|
||||
impl_(nullptr)
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct an @c any_completion_handler in an empty state, without a target
|
||||
/// object.
|
||||
constexpr any_completion_handler(nullptr_t)
|
||||
: fn_table_(nullptr),
|
||||
impl_(nullptr)
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct an @c any_completion_handler to contain the specified target.
|
||||
template <typename H, typename Handler = decay_t<H>>
|
||||
any_completion_handler(H&& h,
|
||||
constraint_t<
|
||||
!is_same<decay_t<H>, any_completion_handler>::value
|
||||
> = 0)
|
||||
: 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), static_cast<H&&>(h)))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move-construct an @c any_completion_handler from another.
|
||||
/**
|
||||
* After the operation, the moved-from object @c other has no target.
|
||||
*/
|
||||
any_completion_handler(any_completion_handler&& other) noexcept
|
||||
: fn_table_(other.fn_table_),
|
||||
impl_(other.impl_)
|
||||
{
|
||||
other.fn_table_ = nullptr;
|
||||
other.impl_ = nullptr;
|
||||
}
|
||||
|
||||
/// Move-assign an @c any_completion_handler from another.
|
||||
/**
|
||||
* After the operation, the moved-from object @c other has no target.
|
||||
*/
|
||||
any_completion_handler& operator=(
|
||||
any_completion_handler&& other) noexcept
|
||||
{
|
||||
any_completion_handler(
|
||||
static_cast<any_completion_handler&&>(other)).swap(*this);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// Assignment operator that sets the polymorphic wrapper to the empty state.
|
||||
any_completion_handler& operator=(nullptr_t) noexcept
|
||||
{
|
||||
any_completion_handler().swap(*this);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// Destructor.
|
||||
~any_completion_handler()
|
||||
{
|
||||
if (impl_)
|
||||
fn_table_->destroy(impl_);
|
||||
}
|
||||
|
||||
/// Test if the polymorphic wrapper is empty.
|
||||
constexpr explicit operator bool() const noexcept
|
||||
{
|
||||
return impl_ != nullptr;
|
||||
}
|
||||
|
||||
/// Test if the polymorphic wrapper is non-empty.
|
||||
constexpr bool operator!() const noexcept
|
||||
{
|
||||
return impl_ == nullptr;
|
||||
}
|
||||
|
||||
/// Swap the content of an @c any_completion_handler with another.
|
||||
void swap(any_completion_handler& other) noexcept
|
||||
{
|
||||
std::swap(fn_table_, other.fn_table_);
|
||||
std::swap(impl_, other.impl_);
|
||||
}
|
||||
|
||||
/// Get the associated allocator.
|
||||
allocator_type get_allocator() const noexcept
|
||||
{
|
||||
return allocator_type(0, *this);
|
||||
}
|
||||
|
||||
/// Get the associated cancellation slot.
|
||||
cancellation_slot_type get_cancellation_slot() const noexcept
|
||||
{
|
||||
return impl_ ? impl_->get_cancellation_slot() : cancellation_slot_type();
|
||||
}
|
||||
|
||||
/// Function call operator.
|
||||
/**
|
||||
* Invokes target completion handler with the supplied arguments.
|
||||
*
|
||||
* This function may only be called once, as the target handler is moved from.
|
||||
* The polymorphic wrapper is left in an empty state.
|
||||
*
|
||||
* Throws @c std::bad_function_call if the polymorphic wrapper is empty.
|
||||
*/
|
||||
template <typename... Args>
|
||||
auto operator()(Args&&... args)
|
||||
-> decltype(fn_table_->call(impl_, static_cast<Args&&>(args)...))
|
||||
{
|
||||
if (detail::any_completion_handler_impl_base* impl = impl_)
|
||||
{
|
||||
impl_ = nullptr;
|
||||
return fn_table_->call(impl, static_cast<Args&&>(args)...);
|
||||
}
|
||||
std::bad_function_call ex;
|
||||
asio::detail::throw_exception(ex);
|
||||
}
|
||||
|
||||
/// Equality operator.
|
||||
friend constexpr bool operator==(
|
||||
const any_completion_handler& a, nullptr_t) noexcept
|
||||
{
|
||||
return a.impl_ == nullptr;
|
||||
}
|
||||
|
||||
/// Equality operator.
|
||||
friend constexpr bool operator==(
|
||||
nullptr_t, const any_completion_handler& b) noexcept
|
||||
{
|
||||
return nullptr == b.impl_;
|
||||
}
|
||||
|
||||
/// Inequality operator.
|
||||
friend constexpr bool operator!=(
|
||||
const any_completion_handler& a, nullptr_t) noexcept
|
||||
{
|
||||
return a.impl_ != nullptr;
|
||||
}
|
||||
|
||||
/// Inequality operator.
|
||||
friend constexpr bool operator!=(
|
||||
nullptr_t, const any_completion_handler& b) 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()) noexcept
|
||||
{
|
||||
any_completion_executor any_candidate(std::nothrow, candidate);
|
||||
return handler.fn_table_
|
||||
? handler.fn_table_->executor(handler.impl_, any_candidate)
|
||||
: any_candidate;
|
||||
}
|
||||
};
|
||||
|
||||
template <typename... Signatures, typename Candidate>
|
||||
struct associated_immediate_executor<
|
||||
any_completion_handler<Signatures...>, Candidate>
|
||||
{
|
||||
using type = any_completion_executor;
|
||||
|
||||
static type get(const any_completion_handler<Signatures...>& handler,
|
||||
const Candidate& candidate = Candidate()) noexcept
|
||||
{
|
||||
any_io_executor any_candidate(std::nothrow, candidate);
|
||||
return handler.fn_table_
|
||||
? handler.fn_table_->immediate_executor(handler.impl_, any_candidate)
|
||||
: any_candidate;
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_ANY_COMPLETION_HANDLER_HPP
|
||||
351
Packages/asio-1.36.0/include/asio/any_io_executor.hpp
vendored
Normal file
351
Packages/asio-1.36.0/include/asio/any_io_executor.hpp
vendored
Normal file
@@ -0,0 +1,351 @@
|
||||
//
|
||||
// any_io_executor.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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() noexcept;
|
||||
|
||||
/// Construct in an empty state. Equivalent effects to default constructor.
|
||||
ASIO_DECL any_io_executor(nullptr_t) noexcept;
|
||||
|
||||
/// Copy constructor.
|
||||
ASIO_DECL any_io_executor(const any_io_executor& e) noexcept;
|
||||
|
||||
/// Move constructor.
|
||||
ASIO_DECL any_io_executor(any_io_executor&& e) noexcept;
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!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
|
||||
>::value
|
||||
> = 0)
|
||||
: base_type(static_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,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!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
|
||||
>::value
|
||||
> = 0) noexcept
|
||||
: base_type(std::nothrow, static_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) noexcept;
|
||||
|
||||
/// Construct to point to the same target as another any_executor.
|
||||
ASIO_DECL any_io_executor(std::nothrow_t, any_io_executor&& e) noexcept;
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!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
|
||||
>::value
|
||||
> = 0)
|
||||
: base_type(static_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,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!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
|
||||
>::value
|
||||
> = 0) noexcept
|
||||
: base_type(std::nothrow, static_cast<Executor&&>(e))
|
||||
{
|
||||
}
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Assignment operator.
|
||||
ASIO_DECL any_io_executor& operator=(
|
||||
const any_io_executor& e) noexcept;
|
||||
|
||||
/// Move assignment operator.
|
||||
ASIO_DECL any_io_executor& operator=(any_io_executor&& e) noexcept;
|
||||
|
||||
/// 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) 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,
|
||||
constraint_t<
|
||||
traits::require_member<const base_type&, const Property&>::is_valid
|
||||
> = 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,
|
||||
constraint_t<
|
||||
traits::prefer_member<const base_type&, const Property&>::is_valid
|
||||
> = 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
|
||||
65
Packages/asio-1.36.0/include/asio/append.hpp
vendored
Normal file
65
Packages/asio-1.36.0/include/asio/append.hpp
vendored
Normal file
@@ -0,0 +1,65 @@
|
||||
//
|
||||
// append.hpp
|
||||
// ~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#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>
|
||||
constexpr explicit append_t(T&& completion_token, V&&... values)
|
||||
: token_(static_cast<T&&>(completion_token)),
|
||||
values_(static_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 constexpr
|
||||
append_t<decay_t<CompletionToken>, decay_t<Values>...>
|
||||
append(CompletionToken&& completion_token, Values&&... values)
|
||||
{
|
||||
return append_t<decay_t<CompletionToken>, decay_t<Values>...>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
static_cast<Values&&>(values)...);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/append.hpp"
|
||||
|
||||
#endif // ASIO_APPEND_HPP
|
||||
152
Packages/asio-1.36.0/include/asio/as_tuple.hpp
vendored
Normal file
152
Packages/asio-1.36.0/include/asio/as_tuple.hpp
vendored
Normal file
@@ -0,0 +1,152 @@
|
||||
//
|
||||
// as_tuple.hpp
|
||||
// ~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#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.
|
||||
*/
|
||||
constexpr as_tuple_t(
|
||||
default_constructor_tag = default_constructor_tag(),
|
||||
CompletionToken token = CompletionToken())
|
||||
: token_(static_cast<CompletionToken&&>(token))
|
||||
{
|
||||
}
|
||||
|
||||
/// Constructor.
|
||||
template <typename T>
|
||||
constexpr explicit as_tuple_t(
|
||||
T&& completion_token)
|
||||
: token_(static_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,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!is_same<InnerExecutor1, executor_with_default>::value,
|
||||
is_convertible<InnerExecutor1, InnerExecutor>,
|
||||
false_type
|
||||
>::value
|
||||
> = 0) noexcept
|
||||
: InnerExecutor(ex)
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
/// Type alias to adapt an I/O object to use @c as_tuple_t as its
|
||||
/// default completion token type.
|
||||
template <typename T>
|
||||
using as_default_on_t = typename T::template rebind_executor<
|
||||
executor_with_default<typename T::executor_type>>::other;
|
||||
|
||||
/// 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<T>::template rebind_executor<
|
||||
executor_with_default<typename decay_t<T>::executor_type>
|
||||
>::other
|
||||
as_default_on(T&& object)
|
||||
{
|
||||
return typename decay_t<T>::template rebind_executor<
|
||||
executor_with_default<typename decay_t<T>::executor_type>
|
||||
>::other(static_cast<T&&>(object));
|
||||
}
|
||||
|
||||
//private:
|
||||
CompletionToken token_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to specify that
|
||||
/// the completion handler arguments should be combined into a single tuple
|
||||
/// argument.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
struct partial_as_tuple
|
||||
{
|
||||
/// Default constructor.
|
||||
constexpr partial_as_tuple()
|
||||
{
|
||||
}
|
||||
|
||||
/// 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
|
||||
constexpr as_tuple_t<decay_t<CompletionToken>>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return as_tuple_t<decay_t<CompletionToken>>(
|
||||
static_cast<CompletionToken&&>(completion_token));
|
||||
}
|
||||
};
|
||||
|
||||
/// A function object that adapts a @ref completion_token to specify that the
|
||||
/// completion handler arguments should be combined into a single tuple
|
||||
/// argument.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
ASIO_INLINE_VARIABLE constexpr partial_as_tuple as_tuple;
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/as_tuple.hpp"
|
||||
|
||||
#endif // ASIO_AS_TUPLE_HPP
|
||||
214
Packages/asio-1.36.0/include/asio/associated_allocator.hpp
vendored
Normal file
214
Packages/asio-1.36.0/include/asio/associated_allocator.hpp
vendored
Normal file
@@ -0,0 +1,214 @@
|
||||
//
|
||||
// associated_allocator.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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, void_t<typename T::allocator_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&) noexcept
|
||||
{
|
||||
return type();
|
||||
}
|
||||
|
||||
static const type& get(const T&, const A& a) noexcept
|
||||
{
|
||||
return a;
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename A>
|
||||
struct associated_allocator_impl<T, A, void_t<typename T::allocator_type>>
|
||||
{
|
||||
typedef typename T::allocator_type type;
|
||||
|
||||
static auto get(const T& t) noexcept
|
||||
-> decltype(t.get_allocator())
|
||||
{
|
||||
return t.get_allocator();
|
||||
}
|
||||
|
||||
static auto get(const T& t, const A&) noexcept
|
||||
-> decltype(t.get_allocator())
|
||||
{
|
||||
return t.get_allocator();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename A>
|
||||
struct associated_allocator_impl<T, A,
|
||||
enable_if_t<
|
||||
!has_allocator_type<T>::value
|
||||
>,
|
||||
void_t<
|
||||
typename associator<associated_allocator, T, A>::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) 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) 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) 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 auto get_associated_allocator(
|
||||
const T& t, const Allocator& a) noexcept
|
||||
-> decltype(associated_allocator<T, Allocator>::get(t, a))
|
||||
{
|
||||
return associated_allocator<T, Allocator>::get(t, a);
|
||||
}
|
||||
|
||||
template <typename T, typename Allocator = std::allocator<void>>
|
||||
using associated_allocator_t
|
||||
= typename associated_allocator<T, Allocator>::type;
|
||||
|
||||
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,
|
||||
enable_if_t<
|
||||
is_same<
|
||||
typename associated_allocator<T,
|
||||
A>::asio_associated_allocator_is_unspecialised,
|
||||
void
|
||||
>::value
|
||||
>>
|
||||
{
|
||||
typedef void asio_associated_allocator_is_unspecialised;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// 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) 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 auto get(reference_wrapper<T> t, const Allocator& a) noexcept
|
||||
-> decltype(associated_allocator<T, Allocator>::get(t.get(), a))
|
||||
{
|
||||
return associated_allocator<T, Allocator>::get(t.get(), a);
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_ASSOCIATED_ALLOCATOR_HPP
|
||||
221
Packages/asio-1.36.0/include/asio/associated_cancellation_slot.hpp
vendored
Normal file
221
Packages/asio-1.36.0/include/asio/associated_cancellation_slot.hpp
vendored
Normal file
@@ -0,0 +1,221 @@
|
||||
//
|
||||
// associated_cancellation_slot.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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, void_t<typename T::cancellation_slot_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&) noexcept
|
||||
{
|
||||
return type();
|
||||
}
|
||||
|
||||
static const type& get(const T&, const S& s) noexcept
|
||||
{
|
||||
return s;
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename S>
|
||||
struct associated_cancellation_slot_impl<T, S,
|
||||
void_t<typename T::cancellation_slot_type>>
|
||||
{
|
||||
typedef typename T::cancellation_slot_type type;
|
||||
|
||||
static auto get(const T& t) noexcept
|
||||
-> decltype(t.get_cancellation_slot())
|
||||
{
|
||||
return t.get_cancellation_slot();
|
||||
}
|
||||
|
||||
static auto get(const T& t, const S&) noexcept
|
||||
-> decltype(t.get_cancellation_slot())
|
||||
{
|
||||
return t.get_cancellation_slot();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename S>
|
||||
struct associated_cancellation_slot_impl<T, S,
|
||||
enable_if_t<
|
||||
!has_cancellation_slot_type<T>::value
|
||||
>,
|
||||
void_t<
|
||||
typename associator<associated_cancellation_slot, T, S>::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) 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) 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) 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 auto get_associated_cancellation_slot(
|
||||
const T& t, const CancellationSlot& st) noexcept
|
||||
-> decltype(associated_cancellation_slot<T, CancellationSlot>::get(t, st))
|
||||
{
|
||||
return associated_cancellation_slot<T, CancellationSlot>::get(t, st);
|
||||
}
|
||||
|
||||
template <typename T, typename CancellationSlot = cancellation_slot>
|
||||
using associated_cancellation_slot_t =
|
||||
typename associated_cancellation_slot<T, CancellationSlot>::type;
|
||||
|
||||
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,
|
||||
enable_if_t<
|
||||
is_same<
|
||||
typename associated_cancellation_slot<T,
|
||||
S>::asio_associated_cancellation_slot_is_unspecialised,
|
||||
void
|
||||
>::value
|
||||
>>
|
||||
{
|
||||
typedef void asio_associated_cancellation_slot_is_unspecialised;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// 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) 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 auto get(reference_wrapper<T> t, const CancellationSlot& s) noexcept
|
||||
-> decltype(
|
||||
associated_cancellation_slot<T, CancellationSlot>::get(t.get(), s))
|
||||
{
|
||||
return associated_cancellation_slot<T, CancellationSlot>::get(t.get(), s);
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_ASSOCIATED_CANCELLATION_SLOT_HPP
|
||||
235
Packages/asio-1.36.0/include/asio/associated_executor.hpp
vendored
Normal file
235
Packages/asio-1.36.0/include/asio/associated_executor.hpp
vendored
Normal file
@@ -0,0 +1,235 @@
|
||||
//
|
||||
// associated_executor.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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, void_t<typename T::executor_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&) noexcept
|
||||
{
|
||||
return type();
|
||||
}
|
||||
|
||||
static const type& get(const T&, const E& e) noexcept
|
||||
{
|
||||
return e;
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename E>
|
||||
struct associated_executor_impl<T, E, void_t<typename T::executor_type>>
|
||||
{
|
||||
typedef typename T::executor_type type;
|
||||
|
||||
static auto get(const T& t) noexcept
|
||||
-> decltype(t.get_executor())
|
||||
{
|
||||
return t.get_executor();
|
||||
}
|
||||
|
||||
static auto get(const T& t, const E&) noexcept
|
||||
-> decltype(t.get_executor())
|
||||
{
|
||||
return t.get_executor();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename E>
|
||||
struct associated_executor_impl<T, E,
|
||||
enable_if_t<
|
||||
!has_executor_type<T>::value
|
||||
>,
|
||||
void_t<
|
||||
typename associator<associated_executor, T, E>::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) 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) 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) 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 auto get_associated_executor(
|
||||
const T& t, const Executor& ex,
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 0) noexcept
|
||||
-> decltype(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 typename associated_executor<T,
|
||||
typename ExecutionContext::executor_type>::type
|
||||
get_associated_executor(const T& t, ExecutionContext& ctx,
|
||||
constraint_t<is_convertible<ExecutionContext&,
|
||||
execution_context&>::value> = 0) noexcept
|
||||
{
|
||||
return associated_executor<T,
|
||||
typename ExecutionContext::executor_type>::get(t, ctx.get_executor());
|
||||
}
|
||||
|
||||
template <typename T, typename Executor = system_executor>
|
||||
using associated_executor_t = typename associated_executor<T, Executor>::type;
|
||||
|
||||
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,
|
||||
enable_if_t<
|
||||
is_same<
|
||||
typename associated_executor<T,
|
||||
E>::asio_associated_executor_is_unspecialised,
|
||||
void
|
||||
>::value
|
||||
>>
|
||||
{
|
||||
typedef void asio_associated_executor_is_unspecialised;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// 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) 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 auto get(reference_wrapper<T> t, const Executor& ex) noexcept
|
||||
-> decltype(associated_executor<T, Executor>::get(t.get(), ex))
|
||||
{
|
||||
return associated_executor<T, Executor>::get(t.get(), ex);
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_ASSOCIATED_EXECUTOR_HPP
|
||||
281
Packages/asio-1.36.0/include/asio/associated_immediate_executor.hpp
vendored
Normal file
281
Packages/asio-1.36.0/include/asio/associated_immediate_executor.hpp
vendored
Normal file
@@ -0,0 +1,281 @@
|
||||
//
|
||||
// associated_immediate_executor.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_IMMEDIATE_EXECUTOR_HPP
|
||||
#define ASIO_ASSOCIATED_IMMEDIATE_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/blocking.hpp"
|
||||
#include "asio/execution/executor.hpp"
|
||||
#include "asio/execution_context.hpp"
|
||||
#include "asio/is_executor.hpp"
|
||||
#include "asio/require.hpp"
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
template <typename T, typename Executor>
|
||||
struct associated_immediate_executor;
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename T, typename = void>
|
||||
struct has_immediate_executor_type : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct has_immediate_executor_type<T,
|
||||
void_t<typename T::immediate_executor_type>>
|
||||
: true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename E, typename = void, typename = void>
|
||||
struct default_immediate_executor
|
||||
{
|
||||
typedef decay_t<require_result_t<E, execution::blocking_t::never_t>> type;
|
||||
|
||||
static auto get(const E& e) noexcept
|
||||
-> decltype(asio::require(e, execution::blocking.never))
|
||||
{
|
||||
return asio::require(e, execution::blocking.never);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename E>
|
||||
struct default_immediate_executor<E,
|
||||
enable_if_t<
|
||||
!execution::is_executor<E>::value
|
||||
>,
|
||||
enable_if_t<
|
||||
is_executor<E>::value
|
||||
>>
|
||||
{
|
||||
class type : public E
|
||||
{
|
||||
public:
|
||||
template <typename Executor1>
|
||||
explicit type(const Executor1& e,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!is_same<Executor1, type>::value,
|
||||
is_convertible<Executor1, E>,
|
||||
false_type
|
||||
>::value
|
||||
> = 0) noexcept
|
||||
: E(e)
|
||||
{
|
||||
}
|
||||
|
||||
type(const type& other) noexcept
|
||||
: E(static_cast<const E&>(other))
|
||||
{
|
||||
}
|
||||
|
||||
type(type&& other) noexcept
|
||||
: E(static_cast<E&&>(other))
|
||||
{
|
||||
}
|
||||
|
||||
template <typename Function, typename Allocator>
|
||||
void dispatch(Function&& f, const Allocator& a) const
|
||||
{
|
||||
this->post(static_cast<Function&&>(f), a);
|
||||
}
|
||||
|
||||
friend bool operator==(const type& a, const type& b) noexcept
|
||||
{
|
||||
return static_cast<const E&>(a) == static_cast<const E&>(b);
|
||||
}
|
||||
|
||||
friend bool operator!=(const type& a, const type& b) noexcept
|
||||
{
|
||||
return static_cast<const E&>(a) != static_cast<const E&>(b);
|
||||
}
|
||||
};
|
||||
|
||||
static type get(const E& e) noexcept
|
||||
{
|
||||
return type(e);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename E, typename = void, typename = void>
|
||||
struct associated_immediate_executor_impl
|
||||
{
|
||||
typedef void asio_associated_immediate_executor_is_unspecialised;
|
||||
|
||||
typedef typename default_immediate_executor<E>::type type;
|
||||
|
||||
static auto get(const T&, const E& e) noexcept
|
||||
-> decltype(default_immediate_executor<E>::get(e))
|
||||
{
|
||||
return default_immediate_executor<E>::get(e);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename E>
|
||||
struct associated_immediate_executor_impl<T, E,
|
||||
void_t<typename T::immediate_executor_type>>
|
||||
{
|
||||
typedef typename T::immediate_executor_type type;
|
||||
|
||||
static auto get(const T& t, const E&) noexcept
|
||||
-> decltype(t.get_immediate_executor())
|
||||
{
|
||||
return t.get_immediate_executor();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename E>
|
||||
struct associated_immediate_executor_impl<T, E,
|
||||
enable_if_t<
|
||||
!has_immediate_executor_type<T>::value
|
||||
>,
|
||||
void_t<
|
||||
typename associator<associated_immediate_executor, T, E>::type
|
||||
>> : associator<associated_immediate_executor, T, E>
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// Traits type used to obtain the immediate 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>
|
||||
struct associated_immediate_executor
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
: detail::associated_immediate_executor_impl<T, Executor>
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
{
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
/// If @c T has a nested type @c immediate_executor_type,
|
||||
// <tt>T::immediate_executor_type</tt>. Otherwise @c Executor.
|
||||
typedef see_below type;
|
||||
|
||||
/// If @c T has a nested type @c immediate_executor_type, returns
|
||||
/// <tt>t.get_immediate_executor()</tt>. Otherwise returns
|
||||
/// <tt>asio::require(ex, asio::execution::blocking.never)</tt>.
|
||||
static decltype(auto) get(const T& t, const Executor& ex) noexcept;
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
};
|
||||
|
||||
/// Helper function to obtain an object's associated executor.
|
||||
/**
|
||||
* @returns <tt>associated_immediate_executor<T, Executor>::get(t, ex)</tt>
|
||||
*/
|
||||
template <typename T, typename Executor>
|
||||
ASIO_NODISCARD inline auto get_associated_immediate_executor(
|
||||
const T& t, const Executor& ex,
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 0) noexcept
|
||||
-> decltype(associated_immediate_executor<T, Executor>::get(t, ex))
|
||||
{
|
||||
return associated_immediate_executor<T, Executor>::get(t, ex);
|
||||
}
|
||||
|
||||
/// Helper function to obtain an object's associated executor.
|
||||
/**
|
||||
* @returns <tt>associated_immediate_executor<T, typename
|
||||
* ExecutionContext::executor_type>::get(t, ctx.get_executor())</tt>
|
||||
*/
|
||||
template <typename T, typename ExecutionContext>
|
||||
ASIO_NODISCARD inline typename associated_immediate_executor<T,
|
||||
typename ExecutionContext::executor_type>::type
|
||||
get_associated_immediate_executor(const T& t, ExecutionContext& ctx,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0) noexcept
|
||||
{
|
||||
return associated_immediate_executor<T,
|
||||
typename ExecutionContext::executor_type>::get(t, ctx.get_executor());
|
||||
}
|
||||
|
||||
template <typename T, typename Executor>
|
||||
using associated_immediate_executor_t =
|
||||
typename associated_immediate_executor<T, Executor>::type;
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename T, typename E, typename = void>
|
||||
struct associated_immediate_executor_forwarding_base
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, typename E>
|
||||
struct associated_immediate_executor_forwarding_base<T, E,
|
||||
enable_if_t<
|
||||
is_same<
|
||||
typename associated_immediate_executor<T,
|
||||
E>::asio_associated_immediate_executor_is_unspecialised,
|
||||
void
|
||||
>::value
|
||||
>>
|
||||
{
|
||||
typedef void asio_associated_immediate_executor_is_unspecialised;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// Specialisation of associated_immediate_executor for
|
||||
/// @c std::reference_wrapper.
|
||||
template <typename T, typename Executor>
|
||||
struct associated_immediate_executor<reference_wrapper<T>, Executor>
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
: detail::associated_immediate_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_immediate_executor<T, Executor>::type type;
|
||||
|
||||
/// Forwards the request to get the executor to the associator specialisation
|
||||
/// for the unwrapped type @c T.
|
||||
static auto get(reference_wrapper<T> t, const Executor& ex) noexcept
|
||||
-> decltype(associated_immediate_executor<T, Executor>::get(t.get(), ex))
|
||||
{
|
||||
return associated_immediate_executor<T, Executor>::get(t.get(), ex);
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_ASSOCIATED_IMMEDIATE_EXECUTOR_HPP
|
||||
35
Packages/asio-1.36.0/include/asio/associator.hpp
vendored
Normal file
35
Packages/asio-1.36.0/include/asio/associator.hpp
vendored
Normal file
@@ -0,0 +1,35 @@
|
||||
//
|
||||
// associator.hpp
|
||||
// ~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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, typename _ = void>
|
||||
struct associator
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_ASSOCIATOR_HPP
|
||||
968
Packages/asio-1.36.0/include/asio/async_result.hpp
vendored
Normal file
968
Packages/asio-1.36.0/include/asio/async_result.hpp
vendored
Normal file
@@ -0,0 +1,968 @@
|
||||
//
|
||||
// async_result.hpp
|
||||
// ~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_ASYNC_RESULT_HPP
|
||||
#define ASIO_ASYNC_RESULT_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/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
namespace detail {
|
||||
|
||||
template <typename T>
|
||||
struct is_completion_signature : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_completion_signature<R(Args...)> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_completion_signature<R(Args...) &> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_completion_signature<R(Args...) &&> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
# if defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_completion_signature<R(Args...) noexcept> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_completion_signature<R(Args...) & noexcept> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_completion_signature<R(Args...) && noexcept> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
# endif // defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename... T>
|
||||
struct are_completion_signatures : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <>
|
||||
struct are_completion_signatures<>
|
||||
: true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T0>
|
||||
struct are_completion_signatures<T0>
|
||||
: is_completion_signature<T0>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T0, typename... TN>
|
||||
struct are_completion_signatures<T0, TN...>
|
||||
: integral_constant<bool, (
|
||||
is_completion_signature<T0>::value
|
||||
&& are_completion_signatures<TN...>::value)>
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename T, typename... Args>
|
||||
ASIO_CONCEPT callable_with = requires(T&& t, Args&&... args)
|
||||
{
|
||||
static_cast<T&&>(t)(static_cast<Args&&>(args)...);
|
||||
};
|
||||
|
||||
template <typename T, typename... Signatures>
|
||||
struct is_completion_handler_for : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, typename R, typename... Args>
|
||||
struct is_completion_handler_for<T, R(Args...)>
|
||||
: integral_constant<bool, (callable_with<decay_t<T>, Args...>)>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, typename R, typename... Args>
|
||||
struct is_completion_handler_for<T, R(Args...) &>
|
||||
: integral_constant<bool, (callable_with<decay_t<T>&, Args...>)>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, typename R, typename... Args>
|
||||
struct is_completion_handler_for<T, R(Args...) &&>
|
||||
: integral_constant<bool, (callable_with<decay_t<T>&&, Args...>)>
|
||||
{
|
||||
};
|
||||
|
||||
# if defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename T, typename R, typename... Args>
|
||||
struct is_completion_handler_for<T, R(Args...) noexcept>
|
||||
: integral_constant<bool, (callable_with<decay_t<T>, Args...>)>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, typename R, typename... Args>
|
||||
struct is_completion_handler_for<T, R(Args...) & noexcept>
|
||||
: integral_constant<bool, (callable_with<decay_t<T>&, Args...>)>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, typename R, typename... Args>
|
||||
struct is_completion_handler_for<T, R(Args...) && noexcept>
|
||||
: integral_constant<bool, (callable_with<decay_t<T>&&, Args...>)>
|
||||
{
|
||||
};
|
||||
|
||||
# endif // defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename T, typename Signature0, typename... SignatureN>
|
||||
struct is_completion_handler_for<T, Signature0, SignatureN...>
|
||||
: integral_constant<bool, (
|
||||
is_completion_handler_for<T, Signature0>::value
|
||||
&& is_completion_handler_for<T, SignatureN...>::value)>
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
template <typename T>
|
||||
ASIO_CONCEPT completion_signature =
|
||||
detail::is_completion_signature<T>::value;
|
||||
|
||||
#define ASIO_COMPLETION_SIGNATURE \
|
||||
::asio::completion_signature
|
||||
|
||||
template <typename T, typename... Signatures>
|
||||
ASIO_CONCEPT completion_handler_for =
|
||||
detail::are_completion_signatures<Signatures...>::value
|
||||
&& detail::is_completion_handler_for<T, Signatures...>::value;
|
||||
|
||||
#define ASIO_COMPLETION_HANDLER_FOR(sig) \
|
||||
::asio::completion_handler_for<sig>
|
||||
#define ASIO_COMPLETION_HANDLER_FOR2(sig0, sig1) \
|
||||
::asio::completion_handler_for<sig0, sig1>
|
||||
#define ASIO_COMPLETION_HANDLER_FOR3(sig0, sig1, sig2) \
|
||||
::asio::completion_handler_for<sig0, sig1, sig2>
|
||||
|
||||
#else // defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
#define ASIO_COMPLETION_SIGNATURE typename
|
||||
#define ASIO_COMPLETION_HANDLER_FOR(sig) typename
|
||||
#define ASIO_COMPLETION_HANDLER_FOR2(sig0, sig1) typename
|
||||
#define ASIO_COMPLETION_HANDLER_FOR3(sig0, sig1, sig2) typename
|
||||
|
||||
#endif // defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename T>
|
||||
struct is_lvalue_completion_signature : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_lvalue_completion_signature<R(Args...) &> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
# if defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_lvalue_completion_signature<R(Args...) & noexcept> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
# endif // defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename... Signatures>
|
||||
struct are_any_lvalue_completion_signatures : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename Sig0>
|
||||
struct are_any_lvalue_completion_signatures<Sig0>
|
||||
: is_lvalue_completion_signature<Sig0>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename Sig0, typename... SigN>
|
||||
struct are_any_lvalue_completion_signatures<Sig0, SigN...>
|
||||
: integral_constant<bool, (
|
||||
is_lvalue_completion_signature<Sig0>::value
|
||||
|| are_any_lvalue_completion_signatures<SigN...>::value)>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct is_rvalue_completion_signature : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_rvalue_completion_signature<R(Args...) &&> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
# if defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct is_rvalue_completion_signature<R(Args...) && noexcept> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
# endif // defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename... Signatures>
|
||||
struct are_any_rvalue_completion_signatures : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename Sig0>
|
||||
struct are_any_rvalue_completion_signatures<Sig0>
|
||||
: is_rvalue_completion_signature<Sig0>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename Sig0, typename... SigN>
|
||||
struct are_any_rvalue_completion_signatures<Sig0, SigN...>
|
||||
: integral_constant<bool, (
|
||||
is_rvalue_completion_signature<Sig0>::value
|
||||
|| are_any_rvalue_completion_signatures<SigN...>::value)>
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct simple_completion_signature;
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct simple_completion_signature<R(Args...)>
|
||||
{
|
||||
typedef R type(Args...);
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct simple_completion_signature<R(Args...) &>
|
||||
{
|
||||
typedef R type(Args...);
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct simple_completion_signature<R(Args...) &&>
|
||||
{
|
||||
typedef R type(Args...);
|
||||
};
|
||||
|
||||
# if defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct simple_completion_signature<R(Args...) noexcept>
|
||||
{
|
||||
typedef R type(Args...);
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct simple_completion_signature<R(Args...) & noexcept>
|
||||
{
|
||||
typedef R type(Args...);
|
||||
};
|
||||
|
||||
template <typename R, typename... Args>
|
||||
struct simple_completion_signature<R(Args...) && noexcept>
|
||||
{
|
||||
typedef R type(Args...);
|
||||
};
|
||||
|
||||
# endif // defined(ASIO_HAS_NOEXCEPT_FUNCTION_TYPE)
|
||||
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures>
|
||||
class completion_handler_async_result
|
||||
{
|
||||
public:
|
||||
typedef CompletionToken completion_handler_type;
|
||||
typedef void return_type;
|
||||
|
||||
explicit completion_handler_async_result(completion_handler_type&)
|
||||
{
|
||||
}
|
||||
|
||||
return_type get()
|
||||
{
|
||||
}
|
||||
|
||||
template <typename Initiation,
|
||||
ASIO_COMPLETION_HANDLER_FOR(Signatures...) RawCompletionToken,
|
||||
typename... Args>
|
||||
static return_type initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
{
|
||||
static_cast<Initiation&&>(initiation)(
|
||||
static_cast<RawCompletionToken&&>(token),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
completion_handler_async_result(
|
||||
const completion_handler_async_result&) = delete;
|
||||
completion_handler_async_result& operator=(
|
||||
const completion_handler_async_result&) = delete;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// An interface for customising the behaviour of an initiating function.
|
||||
/**
|
||||
* The async_result trait is a customisation point that is used within the
|
||||
* initiating function for an @ref asynchronous_operation. The trait combines:
|
||||
*
|
||||
* @li the completion signature (or signatures) that describe the arguments that
|
||||
* an asynchronous operation will pass to a completion handler;
|
||||
*
|
||||
* @li the @ref completion_token type supplied by the caller; and
|
||||
*
|
||||
* @li the operation's internal implementation.
|
||||
*
|
||||
* Specialisations of the trait must satisfy the @ref async_result_requirements,
|
||||
* and are reponsible for determining:
|
||||
*
|
||||
* @li the concrete completion handler type to be called at the end of the
|
||||
* asynchronous operation;
|
||||
*
|
||||
* @li the initiating function return type;
|
||||
*
|
||||
* @li how the return value of the initiating function is obtained; and
|
||||
*
|
||||
* @li how and when to launch the operation by invoking the supplied initiation
|
||||
* function object.
|
||||
*
|
||||
* This template may be specialised for user-defined completion token types.
|
||||
* The primary template assumes that the CompletionToken is the already a
|
||||
* concrete completion handler.
|
||||
*
|
||||
* @note For backwards compatibility, the primary template implements member
|
||||
* types and functions that are associated with legacy forms of the async_result
|
||||
* trait. These are annotated as "Legacy" in the documentation below. User
|
||||
* specialisations of this trait do not need to implement these in order to
|
||||
* satisfy the @ref async_result_requirements.
|
||||
*
|
||||
* In general, implementers of asynchronous operations should use the
|
||||
* async_initiate function rather than using the async_result trait directly.
|
||||
*/
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures>
|
||||
class async_result
|
||||
{
|
||||
public:
|
||||
/// (Legacy.) The concrete completion handler type for the specific signature.
|
||||
typedef CompletionToken completion_handler_type;
|
||||
|
||||
/// (Legacy.) The return type of the initiating function.
|
||||
typedef void return_type;
|
||||
|
||||
/// (Legacy.) Construct an async result from a given handler.
|
||||
/**
|
||||
* When using a specalised async_result, the constructor has an opportunity
|
||||
* to initialise some state associated with the completion handler, which is
|
||||
* then returned from the initiating function.
|
||||
*/
|
||||
explicit async_result(completion_handler_type& h);
|
||||
|
||||
/// (Legacy.) Obtain the value to be returned from the initiating function.
|
||||
return_type get();
|
||||
|
||||
/// Initiate the asynchronous operation that will produce the result, and
|
||||
/// obtain the value to be returned from the initiating function.
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static return_type initiate(
|
||||
Initiation&& initiation,
|
||||
RawCompletionToken&& token,
|
||||
Args&&... args);
|
||||
|
||||
private:
|
||||
async_result(const async_result&) = delete;
|
||||
async_result& operator=(const async_result&) = delete;
|
||||
};
|
||||
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures>
|
||||
class async_result :
|
||||
public conditional_t<
|
||||
detail::are_any_lvalue_completion_signatures<Signatures...>::value
|
||||
|| !detail::are_any_rvalue_completion_signatures<Signatures...>::value,
|
||||
detail::completion_handler_async_result<CompletionToken, Signatures...>,
|
||||
async_result<CompletionToken,
|
||||
typename detail::simple_completion_signature<Signatures>::type...>
|
||||
>
|
||||
{
|
||||
public:
|
||||
typedef conditional_t<
|
||||
detail::are_any_lvalue_completion_signatures<Signatures...>::value
|
||||
|| !detail::are_any_rvalue_completion_signatures<Signatures...>::value,
|
||||
detail::completion_handler_async_result<CompletionToken, Signatures...>,
|
||||
async_result<CompletionToken,
|
||||
typename detail::simple_completion_signature<Signatures>::type...>
|
||||
> base_type;
|
||||
|
||||
using base_type::base_type;
|
||||
|
||||
private:
|
||||
async_result(const async_result&) = delete;
|
||||
async_result& operator=(const async_result&) = delete;
|
||||
};
|
||||
|
||||
template <ASIO_COMPLETION_SIGNATURE... Signatures>
|
||||
class async_result<void, Signatures...>
|
||||
{
|
||||
// Empty.
|
||||
};
|
||||
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Helper template to deduce the handler type from a CompletionToken, capture
|
||||
/// a local copy of the handler, and then create an async_result for the
|
||||
/// handler.
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures>
|
||||
struct async_completion
|
||||
{
|
||||
/// The real handler type to be used for the asynchronous operation.
|
||||
typedef typename asio::async_result<
|
||||
decay_t<CompletionToken>, Signatures...>::completion_handler_type
|
||||
completion_handler_type;
|
||||
|
||||
/// Constructor.
|
||||
/**
|
||||
* The constructor creates the concrete completion handler and makes the link
|
||||
* between the handler and the asynchronous result.
|
||||
*/
|
||||
explicit async_completion(CompletionToken& token)
|
||||
: completion_handler(static_cast<conditional_t<
|
||||
is_same<CompletionToken, completion_handler_type>::value,
|
||||
completion_handler_type&, CompletionToken&&>>(token)),
|
||||
result(completion_handler)
|
||||
{
|
||||
}
|
||||
|
||||
/// A copy of, or reference to, a real handler object.
|
||||
conditional_t<
|
||||
is_same<CompletionToken, completion_handler_type>::value,
|
||||
completion_handler_type&, completion_handler_type> completion_handler;
|
||||
|
||||
/// The result of the asynchronous operation's initiating function.
|
||||
async_result<decay_t<CompletionToken>, Signatures...> result;
|
||||
};
|
||||
|
||||
namespace detail {
|
||||
|
||||
struct async_result_memfns_base
|
||||
{
|
||||
void initiate();
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct async_result_memfns_derived
|
||||
: T, async_result_memfns_base
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T, T>
|
||||
struct async_result_memfns_check
|
||||
{
|
||||
};
|
||||
|
||||
template <typename>
|
||||
char (&async_result_initiate_memfn_helper(...))[2];
|
||||
|
||||
template <typename T>
|
||||
char async_result_initiate_memfn_helper(
|
||||
async_result_memfns_check<
|
||||
void (async_result_memfns_base::*)(),
|
||||
&async_result_memfns_derived<T>::initiate>*);
|
||||
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures>
|
||||
struct async_result_has_initiate_memfn
|
||||
: integral_constant<bool, sizeof(async_result_initiate_memfn_helper<
|
||||
async_result<decay_t<CompletionToken>, Signatures...>
|
||||
>(0)) != 1>
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
# define ASIO_INITFN_RESULT_TYPE(ct, sig) \
|
||||
void_or_deduced
|
||||
# define ASIO_INITFN_RESULT_TYPE2(ct, sig0, sig1) \
|
||||
void_or_deduced
|
||||
# define ASIO_INITFN_RESULT_TYPE3(ct, sig0, sig1, sig2) \
|
||||
void_or_deduced
|
||||
#else
|
||||
# define ASIO_INITFN_RESULT_TYPE(ct, sig) \
|
||||
typename ::asio::async_result< \
|
||||
typename ::asio::decay<ct>::type, sig>::return_type
|
||||
# define ASIO_INITFN_RESULT_TYPE2(ct, sig0, sig1) \
|
||||
typename ::asio::async_result< \
|
||||
typename ::asio::decay<ct>::type, sig0, sig1>::return_type
|
||||
# define ASIO_INITFN_RESULT_TYPE3(ct, sig0, sig1, sig2) \
|
||||
typename ::asio::async_result< \
|
||||
typename ::asio::decay<ct>::type, sig0, sig1, sig2>::return_type
|
||||
#define ASIO_HANDLER_TYPE(ct, sig) \
|
||||
typename ::asio::async_result< \
|
||||
typename ::asio::decay<ct>::type, sig>::completion_handler_type
|
||||
#define ASIO_HANDLER_TYPE2(ct, sig0, sig1) \
|
||||
typename ::asio::async_result< \
|
||||
typename ::asio::decay<ct>::type, \
|
||||
sig0, sig1>::completion_handler_type
|
||||
#define ASIO_HANDLER_TYPE3(ct, sig0, sig1, sig2) \
|
||||
typename ::asio::async_result< \
|
||||
typename ::asio::decay<ct>::type, \
|
||||
sig0, sig1, sig2>::completion_handler_type
|
||||
#endif
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE(ct, sig) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE2(ct, sig0, sig1) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE3(ct, sig0, sig1, sig2) \
|
||||
auto
|
||||
#elif defined(ASIO_HAS_RETURN_TYPE_DEDUCTION)
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE(ct, sig) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE2(ct, sig0, sig1) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE3(ct, sig0, sig1, sig2) \
|
||||
auto
|
||||
#else
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE(ct, sig) \
|
||||
ASIO_INITFN_RESULT_TYPE(ct, sig)
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE2(ct, sig0, sig1) \
|
||||
ASIO_INITFN_RESULT_TYPE2(ct, sig0, sig1)
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE3(ct, sig0, sig1, sig2) \
|
||||
ASIO_INITFN_RESULT_TYPE3(ct, sig0, sig1, sig2)
|
||||
#endif
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ct, sig) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX2(ct, sig0, sig1) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX3(ct, sig0, sig1, sig2) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX(expr)
|
||||
#elif defined(ASIO_HAS_RETURN_TYPE_DEDUCTION)
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ct, sig) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX2(ct, sig0, sig1) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX3(ct, sig0, sig1, sig2) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX(expr)
|
||||
#else
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX(ct, sig) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX2(ct, sig0, sig1) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_PREFIX3(ct, sig0, sig1, sig2) \
|
||||
auto
|
||||
# define ASIO_INITFN_AUTO_RESULT_TYPE_SUFFIX(expr) -> decltype expr
|
||||
#endif
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
# define ASIO_INITFN_DEDUCED_RESULT_TYPE(ct, sig, expr) \
|
||||
void_or_deduced
|
||||
# define ASIO_INITFN_DEDUCED_RESULT_TYPE2(ct, sig0, sig1, expr) \
|
||||
void_or_deduced
|
||||
# define ASIO_INITFN_DEDUCED_RESULT_TYPE3(ct, sig0, sig1, sig2, expr) \
|
||||
void_or_deduced
|
||||
#else
|
||||
# define ASIO_INITFN_DEDUCED_RESULT_TYPE(ct, sig, expr) \
|
||||
decltype expr
|
||||
# define ASIO_INITFN_DEDUCED_RESULT_TYPE2(ct, sig0, sig1, expr) \
|
||||
decltype expr
|
||||
# define ASIO_INITFN_DEDUCED_RESULT_TYPE3(ct, sig0, sig1, sig2, expr) \
|
||||
decltype expr
|
||||
#endif
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename CompletionToken,
|
||||
completion_signature... Signatures,
|
||||
typename Initiation, typename... Args>
|
||||
void_or_deduced async_initiate(
|
||||
Initiation&& initiation,
|
||||
type_identity_t<CompletionToken>& token,
|
||||
Args&&... args);
|
||||
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures,
|
||||
typename Initiation, typename... Args>
|
||||
inline auto async_initiate(Initiation&& initiation,
|
||||
type_identity_t<CompletionToken>& token, Args&&... args)
|
||||
-> decltype(enable_if_t<
|
||||
enable_if_t<
|
||||
detail::are_completion_signatures<Signatures...>::value,
|
||||
detail::async_result_has_initiate_memfn<
|
||||
CompletionToken, Signatures...>>::value,
|
||||
async_result<decay_t<CompletionToken>, Signatures...>>::initiate(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
static_cast<CompletionToken&&>(token),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_result<decay_t<CompletionToken>, Signatures...>::initiate(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
static_cast<CompletionToken&&>(token),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures,
|
||||
typename CompletionToken, typename Initiation, typename... Args>
|
||||
inline auto async_initiate(Initiation&& initiation,
|
||||
CompletionToken&& token, Args&&... args)
|
||||
-> decltype(enable_if_t<
|
||||
enable_if_t<
|
||||
detail::are_completion_signatures<Signatures...>::value,
|
||||
detail::async_result_has_initiate_memfn<
|
||||
CompletionToken, Signatures...>>::value,
|
||||
async_result<decay_t<CompletionToken>, Signatures...>>::initiate(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
static_cast<CompletionToken&&>(token),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_result<decay_t<CompletionToken>, Signatures...>::initiate(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
static_cast<CompletionToken&&>(token),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename CompletionToken,
|
||||
ASIO_COMPLETION_SIGNATURE... Signatures,
|
||||
typename Initiation, typename... Args>
|
||||
inline typename enable_if_t<
|
||||
!enable_if_t<
|
||||
detail::are_completion_signatures<Signatures...>::value,
|
||||
detail::async_result_has_initiate_memfn<
|
||||
CompletionToken, Signatures...>>::value,
|
||||
async_result<decay_t<CompletionToken>, Signatures...>
|
||||
>::return_type
|
||||
async_initiate(Initiation&& initiation,
|
||||
type_identity_t<CompletionToken>& token, Args&&... args)
|
||||
{
|
||||
async_completion<CompletionToken, Signatures...> completion(token);
|
||||
|
||||
static_cast<Initiation&&>(initiation)(
|
||||
static_cast<
|
||||
typename async_result<decay_t<CompletionToken>,
|
||||
Signatures...>::completion_handler_type&&>(
|
||||
completion.completion_handler),
|
||||
static_cast<Args&&>(args)...);
|
||||
|
||||
return completion.result.get();
|
||||
}
|
||||
|
||||
template <ASIO_COMPLETION_SIGNATURE... Signatures,
|
||||
typename CompletionToken, typename Initiation, typename... Args>
|
||||
inline typename enable_if_t<
|
||||
!enable_if_t<
|
||||
detail::are_completion_signatures<Signatures...>::value,
|
||||
detail::async_result_has_initiate_memfn<
|
||||
CompletionToken, Signatures...>>::value,
|
||||
async_result<decay_t<CompletionToken>, Signatures...>
|
||||
>::return_type
|
||||
async_initiate(Initiation&& initiation, CompletionToken&& token, Args&&... args)
|
||||
{
|
||||
async_completion<CompletionToken, Signatures...> completion(token);
|
||||
|
||||
static_cast<Initiation&&>(initiation)(
|
||||
static_cast<
|
||||
typename async_result<decay_t<CompletionToken>,
|
||||
Signatures...>::completion_handler_type&&>(
|
||||
completion.completion_handler),
|
||||
static_cast<Args&&>(args)...);
|
||||
|
||||
return completion.result.get();
|
||||
}
|
||||
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#if defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename... Signatures>
|
||||
struct initiation_archetype
|
||||
{
|
||||
template <completion_handler_for<Signatures...> CompletionHandler>
|
||||
void operator()(CompletionHandler&&) const
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
template <typename T, typename... Signatures>
|
||||
ASIO_CONCEPT completion_token_for =
|
||||
detail::are_completion_signatures<Signatures...>::value
|
||||
&&
|
||||
requires(T&& t)
|
||||
{
|
||||
async_initiate<T, Signatures...>(
|
||||
detail::initiation_archetype<Signatures...>{}, t);
|
||||
};
|
||||
|
||||
#define ASIO_COMPLETION_TOKEN_FOR(sig) \
|
||||
::asio::completion_token_for<sig>
|
||||
#define ASIO_COMPLETION_TOKEN_FOR2(sig0, sig1) \
|
||||
::asio::completion_token_for<sig0, sig1>
|
||||
#define ASIO_COMPLETION_TOKEN_FOR3(sig0, sig1, sig2) \
|
||||
::asio::completion_token_for<sig0, sig1, sig2>
|
||||
|
||||
#else // defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
#define ASIO_COMPLETION_TOKEN_FOR(sig) typename
|
||||
#define ASIO_COMPLETION_TOKEN_FOR2(sig0, sig1) typename
|
||||
#define ASIO_COMPLETION_TOKEN_FOR3(sig0, sig1, sig2) typename
|
||||
|
||||
#endif // defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
namespace detail {
|
||||
|
||||
struct async_operation_probe {};
|
||||
struct async_operation_probe_result {};
|
||||
|
||||
template <typename Call, typename = void>
|
||||
struct is_async_operation_call : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename Call>
|
||||
struct is_async_operation_call<Call,
|
||||
void_t<
|
||||
enable_if_t<
|
||||
is_same<
|
||||
result_of_t<Call>,
|
||||
async_operation_probe_result
|
||||
>::value
|
||||
>
|
||||
>
|
||||
> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename... Signatures>
|
||||
class async_result<detail::async_operation_probe, Signatures...>
|
||||
{
|
||||
public:
|
||||
typedef detail::async_operation_probe_result return_type;
|
||||
|
||||
template <typename Initiation, typename... InitArgs>
|
||||
static return_type initiate(Initiation&&,
|
||||
detail::async_operation_probe, InitArgs&&...)
|
||||
{
|
||||
return return_type();
|
||||
}
|
||||
};
|
||||
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// The is_async_operation trait detects whether a type @c T and arguments
|
||||
/// @c Args... may be used to initiate an asynchronous operation.
|
||||
/**
|
||||
* Class template @c is_async_operation is a trait is derived from @c true_type
|
||||
* if the expression <tt>T(Args..., token)</tt> initiates an asynchronous
|
||||
* operation, where @c token is an unspecified completion token type. Otherwise,
|
||||
* @c is_async_operation is derived from @c false_type.
|
||||
*/
|
||||
template <typename T, typename... Args>
|
||||
struct is_async_operation : integral_constant<bool, automatically_determined>
|
||||
{
|
||||
};
|
||||
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename T, typename... Args>
|
||||
struct is_async_operation :
|
||||
detail::is_async_operation_call<
|
||||
T(Args..., detail::async_operation_probe)>
|
||||
{
|
||||
};
|
||||
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#if defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
template <typename T, typename... Args>
|
||||
ASIO_CONCEPT async_operation = is_async_operation<T, Args...>::value;
|
||||
|
||||
#define ASIO_ASYNC_OPERATION \
|
||||
::asio::async_operation
|
||||
#define ASIO_ASYNC_OPERATION1(a0) \
|
||||
::asio::async_operation<a0>
|
||||
#define ASIO_ASYNC_OPERATION2(a0, a1) \
|
||||
::asio::async_operation<a0, a1>
|
||||
#define ASIO_ASYNC_OPERATION3(a0, a1, a2) \
|
||||
::asio::async_operation<a0, a1, a2>
|
||||
|
||||
#else // defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
#define ASIO_ASYNC_OPERATION typename
|
||||
#define ASIO_ASYNC_OPERATION1(a0) typename
|
||||
#define ASIO_ASYNC_OPERATION2(a0, a1) typename
|
||||
#define ASIO_ASYNC_OPERATION3(a0, a1, a2) typename
|
||||
|
||||
#endif // defined(ASIO_HAS_CONCEPTS)
|
||||
|
||||
namespace detail {
|
||||
|
||||
struct completion_signature_probe {};
|
||||
|
||||
template <typename... T>
|
||||
struct completion_signature_probe_result
|
||||
{
|
||||
template <template <typename...> class Op>
|
||||
struct apply
|
||||
{
|
||||
typedef Op<T...> type;
|
||||
};
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct completion_signature_probe_result<T>
|
||||
{
|
||||
typedef T type;
|
||||
|
||||
template <template <typename...> class Op>
|
||||
struct apply
|
||||
{
|
||||
typedef Op<T> type;
|
||||
};
|
||||
};
|
||||
|
||||
template <>
|
||||
struct completion_signature_probe_result<void>
|
||||
{
|
||||
template <template <typename...> class Op>
|
||||
struct apply
|
||||
{
|
||||
typedef Op<> type;
|
||||
};
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename... Signatures>
|
||||
class async_result<detail::completion_signature_probe, Signatures...>
|
||||
{
|
||||
public:
|
||||
typedef detail::completion_signature_probe_result<Signatures...> return_type;
|
||||
|
||||
template <typename Initiation, typename... InitArgs>
|
||||
static return_type initiate(Initiation&&,
|
||||
detail::completion_signature_probe, InitArgs&&...)
|
||||
{
|
||||
return return_type();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename Signature>
|
||||
class async_result<detail::completion_signature_probe, Signature>
|
||||
{
|
||||
public:
|
||||
typedef detail::completion_signature_probe_result<Signature> return_type;
|
||||
|
||||
template <typename Initiation, typename... InitArgs>
|
||||
static return_type initiate(Initiation&&,
|
||||
detail::completion_signature_probe, InitArgs&&...)
|
||||
{
|
||||
return return_type();
|
||||
}
|
||||
};
|
||||
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// The completion_signature_of trait determines the completion signature
|
||||
/// of an asynchronous operation.
|
||||
/**
|
||||
* Class template @c completion_signature_of is a trait with a member type
|
||||
* alias @c type that denotes the completion signature of the asynchronous
|
||||
* operation initiated by the expression <tt>T(Args..., token)</tt> operation,
|
||||
* where @c token is an unspecified completion token type. If the asynchronous
|
||||
* operation does not have exactly one completion signature, the instantion of
|
||||
* the trait is well-formed but the member type alias @c type is omitted. If
|
||||
* the expression <tt>T(Args..., token)</tt> is not an asynchronous operation
|
||||
* then use of the trait is ill-formed.
|
||||
*/
|
||||
template <typename T, typename... Args>
|
||||
struct completion_signature_of
|
||||
{
|
||||
typedef automatically_determined type;
|
||||
};
|
||||
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename T, typename... Args>
|
||||
struct completion_signature_of :
|
||||
result_of_t<T(Args..., detail::completion_signature_probe)>
|
||||
{
|
||||
};
|
||||
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename T, typename... Args>
|
||||
using completion_signature_of_t =
|
||||
typename completion_signature_of<T, Args...>::type;
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/default_completion_token.hpp"
|
||||
|
||||
#endif // ASIO_ASYNC_RESULT_HPP
|
||||
145
Packages/asio-1.36.0/include/asio/awaitable.hpp
vendored
Normal file
145
Packages/asio-1.36.0/include/asio/awaitable.hpp
vendored
Normal file
@@ -0,0 +1,145 @@
|
||||
//
|
||||
// awaitable.hpp
|
||||
// ~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#if defined(ASIO_HEADER_ONLY)
|
||||
# include "asio/impl/awaitable.ipp"
|
||||
#endif // defined(ASIO_HEADER_ONLY)
|
||||
|
||||
#endif // defined(ASIO_HAS_CO_AWAIT) || defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#endif // ASIO_AWAITABLE_HPP
|
||||
1362
Packages/asio-1.36.0/include/asio/basic_datagram_socket.hpp
vendored
Normal file
1362
Packages/asio-1.36.0/include/asio/basic_datagram_socket.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
715
Packages/asio-1.36.0/include/asio/basic_deadline_timer.hpp
vendored
Normal file
715
Packages/asio-1.36.0/include/asio/basic_deadline_timer.hpp
vendored
Normal file
@@ -0,0 +1,715 @@
|
||||
//
|
||||
// basic_deadline_timer.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_NO_DEPRECATED)
|
||||
|
||||
#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 {
|
||||
|
||||
/// (Deprecated: Use basic_waitable_timer.) 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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");
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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() 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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_wait(
|
||||
WaitToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_deadline_timer& operator=(
|
||||
const basic_deadline_timer&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WaitHandler>
|
||||
void operator()(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 // !defined(ASIO_NO_DEPRECATED)
|
||||
|
||||
#endif // ASIO_BASIC_DEADLINE_TIMER_HPP
|
||||
936
Packages/asio-1.36.0/include/asio/basic_file.hpp
vendored
Normal file
936
Packages/asio-1.36.0/include/asio/basic_file.hpp
vendored
Normal file
@@ -0,0 +1,936 @@
|
||||
//
|
||||
// basic_file.hpp
|
||||
// ~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 <utility>
|
||||
#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
|
||||
|
||||
#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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*/
|
||||
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 and open a basic_file.
|
||||
/**
|
||||
* 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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*/
|
||||
template <typename ExecutionContext>
|
||||
explicit basic_file(ExecutionContext& context,
|
||||
const char* path, file_base::flags open_flags,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*/
|
||||
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 and open a basic_file.
|
||||
/**
|
||||
* 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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*/
|
||||
template <typename ExecutionContext>
|
||||
explicit basic_file(ExecutionContext& context,
|
||||
const std::string& path, file_base::flags open_flags,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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");
|
||||
}
|
||||
|
||||
/// 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) 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,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
defaulted_constraint
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_file&
|
||||
> operator=(basic_file<Executor1>&& other)
|
||||
{
|
||||
basic_file tmp(std::move(other));
|
||||
impl_ = std::move(tmp.impl_);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// Get the executor associated with the object.
|
||||
const executor_type& get_executor() 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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*
|
||||
* @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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*
|
||||
* @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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*
|
||||
* @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.
|
||||
*
|
||||
* Exactly one of the following file_base::flags values must be specified:
|
||||
*
|
||||
* @li flags::read_only
|
||||
* @li flags::write_only
|
||||
* @li flags::read_write
|
||||
*
|
||||
* The following flags may be bitwise or-ed in addition:
|
||||
*
|
||||
* @li flags::append
|
||||
* @li flags::create
|
||||
* @li flags::exclusive
|
||||
* @li flags::truncate
|
||||
* @li flags::sync_all_on_write
|
||||
*
|
||||
* @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&) = delete;
|
||||
basic_file& operator=(const basic_file&) = delete;
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // defined(ASIO_HAS_FILE)
|
||||
// || defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#endif // ASIO_BASIC_FILE_HPP
|
||||
287
Packages/asio-1.36.0/include/asio/basic_io_object.hpp
vendored
Normal file
287
Packages/asio-1.36.0/include/asio/basic_io_object.hpp
vendored
Normal file
@@ -0,0 +1,287 @@
|
||||
//
|
||||
// basic_io_object.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
|
||||
#if !defined(ASIO_NO_DEPRECATED) \
|
||||
|| defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#include "asio/io_context.hpp"
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
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;
|
||||
};
|
||||
}
|
||||
|
||||
/// (Deprecated) 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(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;
|
||||
|
||||
/// 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();
|
||||
}
|
||||
|
||||
/// 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();
|
||||
}
|
||||
|
||||
/// 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() 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_;
|
||||
};
|
||||
|
||||
// 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;
|
||||
|
||||
asio::io_context& get_io_context()
|
||||
{
|
||||
return service_->get_io_context();
|
||||
}
|
||||
|
||||
asio::io_context& get_io_service()
|
||||
{
|
||||
return service_->get_io_context();
|
||||
}
|
||||
|
||||
typedef asio::io_context::executor_type executor_type;
|
||||
|
||||
executor_type get_executor() 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_;
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // !defined(ASIO_NO_DEPRECATED)
|
||||
// || defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#endif // ASIO_BASIC_IO_OBJECT_HPP
|
||||
689
Packages/asio-1.36.0/include/asio/basic_random_access_file.hpp
vendored
Normal file
689
Packages/asio-1.36.0/include/asio/basic_random_access_file.hpp
vendored
Normal file
@@ -0,0 +1,689 @@
|
||||
//
|
||||
// basic_random_access_file.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = defaulted_constraint())
|
||||
: basic_file<Executor>(context, native_file)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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) 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,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
defaulted_constraint
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_random_access_file&
|
||||
> operator=(basic_random_access_file<Executor1>&& other)
|
||||
{
|
||||
basic_file<Executor>::operator=(std::move(other));
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// 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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some_at(uint64_t offset, const ConstBufferSequence& buffers,
|
||||
WriteToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some_at(uint64_t offset, const MutableBufferSequence& buffers,
|
||||
ReadToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_random_access_file& operator=(
|
||||
const basic_random_access_file&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WriteHandler, typename ConstBufferSequence>
|
||||
void operator()(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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename ReadHandler, typename MutableBufferSequence>
|
||||
void operator()(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
|
||||
1356
Packages/asio-1.36.0/include/asio/basic_raw_socket.hpp
vendored
Normal file
1356
Packages/asio-1.36.0/include/asio/basic_raw_socket.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
626
Packages/asio-1.36.0/include/asio/basic_readable_pipe.hpp
vendored
Normal file
626
Packages/asio-1.36.0/include/asio/basic_readable_pipe.hpp
vendored
Normal file
@@ -0,0 +1,626 @@
|
||||
//
|
||||
// basic_readable_pipe.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 <utility>
|
||||
#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
|
||||
|
||||
#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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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");
|
||||
}
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
defaulted_constraint
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_readable_pipe&
|
||||
> operator=(basic_readable_pipe<Executor1>&& other)
|
||||
{
|
||||
basic_readable_pipe tmp(std::move(other));
|
||||
impl_ = std::move(tmp.impl_);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// 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() 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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some(const MutableBufferSequence& buffers,
|
||||
ReadToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_readable_pipe& operator=(const basic_readable_pipe&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename ReadHandler, typename MutableBufferSequence>
|
||||
void operator()(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
|
||||
823
Packages/asio-1.36.0/include/asio/basic_seq_packet_socket.hpp
vendored
Normal file
823
Packages/asio-1.36.0/include/asio/basic_seq_packet_socket.hpp
vendored
Normal file
@@ -0,0 +1,823 @@
|
||||
//
|
||||
// basic_seq_packet_socket.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
: basic_socket<Protocol, Executor>(context, protocol, native_socket)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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) 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,
|
||||
constraint_t<
|
||||
is_convertible<Protocol1, Protocol>::value
|
||||
&& is_convertible<Executor1, Executor>::value
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Protocol1, Protocol>::value
|
||||
&& is_convertible<Executor1, Executor>::value,
|
||||
basic_seq_packet_socket&
|
||||
> operator=(basic_seq_packet_socket<Protocol1, Executor1>&& other)
|
||||
{
|
||||
basic_socket<Protocol, Executor>::operator=(std::move(other));
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// 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::async_immediate().
|
||||
*
|
||||
* @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
|
||||
= default_completion_token_t<executor_type>>
|
||||
auto async_send(const ConstBufferSequence& buffers,
|
||||
socket_base::message_flags flags,
|
||||
WriteToken&& token
|
||||
= default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_receive(const MutableBufferSequence& buffers,
|
||||
socket_base::message_flags& out_flags,
|
||||
ReadToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_receive(const MutableBufferSequence& buffers,
|
||||
socket_base::message_flags in_flags,
|
||||
socket_base::message_flags& out_flags,
|
||||
ReadToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_seq_packet_socket& operator=(
|
||||
const basic_seq_packet_socket&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WriteHandler, typename ConstBufferSequence>
|
||||
void operator()(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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename ReadHandler, typename MutableBufferSequence>
|
||||
void operator()(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
|
||||
987
Packages/asio-1.36.0/include/asio/basic_serial_port.hpp
vendored
Normal file
987
Packages/asio-1.36.0/include/asio/basic_serial_port.hpp
vendored
Normal file
@@ -0,0 +1,987 @@
|
||||
//
|
||||
// basic_serial_port.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 Christopher M. Kohlhoff (chris at kohlhoff dot com)
|
||||
// Copyright (c) 2008 Rep Invariant Systems, Inc. (info@repinvariant.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_SERIAL_PORT_HPP
|
||||
#define ASIO_BASIC_SERIAL_PORT_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_SERIAL_PORT) \
|
||||
|| defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#include <string>
|
||||
#include <utility>
|
||||
#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"
|
||||
#include "asio/serial_port_base.hpp"
|
||||
#if defined(ASIO_HAS_IOCP)
|
||||
# include "asio/detail/win_iocp_serial_port_service.hpp"
|
||||
#else
|
||||
# include "asio/detail/posix_serial_port_service.hpp"
|
||||
#endif
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
/// Provides serial port functionality.
|
||||
/**
|
||||
* The basic_serial_port class provides a wrapper over serial port
|
||||
* functionality.
|
||||
*
|
||||
* @par Thread Safety
|
||||
* @e Distinct @e objects: Safe.@n
|
||||
* @e Shared @e objects: Unsafe.
|
||||
*/
|
||||
template <typename Executor = any_io_executor>
|
||||
class basic_serial_port
|
||||
: public serial_port_base
|
||||
{
|
||||
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 serial port type to another executor.
|
||||
template <typename Executor1>
|
||||
struct rebind_executor
|
||||
{
|
||||
/// The serial port type when rebound to the specified executor.
|
||||
typedef basic_serial_port<Executor1> other;
|
||||
};
|
||||
|
||||
/// The native representation of a serial port.
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
typedef implementation_defined native_handle_type;
|
||||
#elif defined(ASIO_HAS_IOCP)
|
||||
typedef detail::win_iocp_serial_port_service::native_handle_type
|
||||
native_handle_type;
|
||||
#else
|
||||
typedef detail::posix_serial_port_service::native_handle_type
|
||||
native_handle_type;
|
||||
#endif
|
||||
|
||||
/// A basic_basic_serial_port is always the lowest layer.
|
||||
typedef basic_serial_port lowest_layer_type;
|
||||
|
||||
/// Construct a basic_serial_port without opening it.
|
||||
/**
|
||||
* This constructor creates a serial port without opening it.
|
||||
*
|
||||
* @param ex The I/O executor that the serial port will use, by default, to
|
||||
* dispatch handlers for any asynchronous operations performed on the
|
||||
* serial port.
|
||||
*/
|
||||
explicit basic_serial_port(const executor_type& ex)
|
||||
: impl_(0, ex)
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct a basic_serial_port without opening it.
|
||||
/**
|
||||
* This constructor creates a serial port without opening it.
|
||||
*
|
||||
* @param context An execution context which provides the I/O executor that
|
||||
* the serial port will use, by default, to dispatch handlers for any
|
||||
* asynchronous operations performed on the serial port.
|
||||
*/
|
||||
template <typename ExecutionContext>
|
||||
explicit basic_serial_port(ExecutionContext& context,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = defaulted_constraint())
|
||||
: impl_(0, 0, context)
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct and open a basic_serial_port.
|
||||
/**
|
||||
* This constructor creates and opens a serial port for the specified device
|
||||
* name.
|
||||
*
|
||||
* @param ex The I/O executor that the serial port will use, by default, to
|
||||
* dispatch handlers for any asynchronous operations performed on the
|
||||
* serial port.
|
||||
*
|
||||
* @param device The platform-specific device name for this serial
|
||||
* port.
|
||||
*/
|
||||
basic_serial_port(const executor_type& ex, const char* device)
|
||||
: impl_(0, ex)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().open(impl_.get_implementation(), device, ec);
|
||||
asio::detail::throw_error(ec, "open");
|
||||
}
|
||||
|
||||
/// Construct and open a basic_serial_port.
|
||||
/**
|
||||
* This constructor creates and opens a serial port for the specified device
|
||||
* name.
|
||||
*
|
||||
* @param context An execution context which provides the I/O executor that
|
||||
* the serial port will use, by default, to dispatch handlers for any
|
||||
* asynchronous operations performed on the serial port.
|
||||
*
|
||||
* @param device The platform-specific device name for this serial
|
||||
* port.
|
||||
*/
|
||||
template <typename ExecutionContext>
|
||||
basic_serial_port(ExecutionContext& context, const char* device,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
: impl_(0, 0, context)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().open(impl_.get_implementation(), device, ec);
|
||||
asio::detail::throw_error(ec, "open");
|
||||
}
|
||||
|
||||
/// Construct and open a basic_serial_port.
|
||||
/**
|
||||
* This constructor creates and opens a serial port for the specified device
|
||||
* name.
|
||||
*
|
||||
* @param ex The I/O executor that the serial port will use, by default, to
|
||||
* dispatch handlers for any asynchronous operations performed on the
|
||||
* serial port.
|
||||
*
|
||||
* @param device The platform-specific device name for this serial
|
||||
* port.
|
||||
*/
|
||||
basic_serial_port(const executor_type& ex, const std::string& device)
|
||||
: impl_(0, ex)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().open(impl_.get_implementation(), device, ec);
|
||||
asio::detail::throw_error(ec, "open");
|
||||
}
|
||||
|
||||
/// Construct and open a basic_serial_port.
|
||||
/**
|
||||
* This constructor creates and opens a serial port for the specified device
|
||||
* name.
|
||||
*
|
||||
* @param context An execution context which provides the I/O executor that
|
||||
* the serial port will use, by default, to dispatch handlers for any
|
||||
* asynchronous operations performed on the serial port.
|
||||
*
|
||||
* @param device The platform-specific device name for this serial
|
||||
* port.
|
||||
*/
|
||||
template <typename ExecutionContext>
|
||||
basic_serial_port(ExecutionContext& context, const std::string& device,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
: impl_(0, 0, context)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().open(impl_.get_implementation(), device, ec);
|
||||
asio::detail::throw_error(ec, "open");
|
||||
}
|
||||
|
||||
/// Construct a basic_serial_port on an existing native serial port.
|
||||
/**
|
||||
* This constructor creates a serial port object to hold an existing native
|
||||
* serial port.
|
||||
*
|
||||
* @param ex The I/O executor that the serial port will use, by default, to
|
||||
* dispatch handlers for any asynchronous operations performed on the
|
||||
* serial port.
|
||||
*
|
||||
* @param native_serial_port A native serial port.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*/
|
||||
basic_serial_port(const executor_type& ex,
|
||||
const native_handle_type& native_serial_port)
|
||||
: impl_(0, ex)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().assign(impl_.get_implementation(),
|
||||
native_serial_port, ec);
|
||||
asio::detail::throw_error(ec, "assign");
|
||||
}
|
||||
|
||||
/// Construct a basic_serial_port on an existing native serial port.
|
||||
/**
|
||||
* This constructor creates a serial port object to hold an existing native
|
||||
* serial port.
|
||||
*
|
||||
* @param context An execution context which provides the I/O executor that
|
||||
* the serial port will use, by default, to dispatch handlers for any
|
||||
* asynchronous operations performed on the serial port.
|
||||
*
|
||||
* @param native_serial_port A native serial port.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*/
|
||||
template <typename ExecutionContext>
|
||||
basic_serial_port(ExecutionContext& context,
|
||||
const native_handle_type& native_serial_port,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
: impl_(0, 0, context)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().assign(impl_.get_implementation(),
|
||||
native_serial_port, ec);
|
||||
asio::detail::throw_error(ec, "assign");
|
||||
}
|
||||
|
||||
/// Move-construct a basic_serial_port from another.
|
||||
/**
|
||||
* This constructor moves a serial port from one object to another.
|
||||
*
|
||||
* @param other The other basic_serial_port 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_serial_port(const executor_type&)
|
||||
* constructor.
|
||||
*/
|
||||
basic_serial_port(basic_serial_port&& other)
|
||||
: impl_(std::move(other.impl_))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move-assign a basic_serial_port from another.
|
||||
/**
|
||||
* This assignment operator moves a serial port from one object to another.
|
||||
*
|
||||
* @param other The other basic_serial_port 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_serial_port(const executor_type&)
|
||||
* constructor.
|
||||
*/
|
||||
basic_serial_port& operator=(basic_serial_port&& other)
|
||||
{
|
||||
impl_ = std::move(other.impl_);
|
||||
return *this;
|
||||
}
|
||||
|
||||
// All serial ports have access to each other's implementations.
|
||||
template <typename Executor1>
|
||||
friend class basic_serial_port;
|
||||
|
||||
/// Move-construct a basic_serial_port from a serial port of another executor
|
||||
/// type.
|
||||
/**
|
||||
* This constructor moves a serial port from one object to another.
|
||||
*
|
||||
* @param other The other basic_serial_port 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_serial_port(const executor_type&)
|
||||
* constructor.
|
||||
*/
|
||||
template <typename Executor1>
|
||||
basic_serial_port(basic_serial_port<Executor1>&& other,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
defaulted_constraint
|
||||
> = defaulted_constraint())
|
||||
: impl_(std::move(other.impl_))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move-assign a basic_serial_port from a serial port of another executor
|
||||
/// type.
|
||||
/**
|
||||
* This assignment operator moves a serial port from one object to another.
|
||||
*
|
||||
* @param other The other basic_serial_port 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_serial_port(const executor_type&)
|
||||
* constructor.
|
||||
*/
|
||||
template <typename Executor1>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_serial_port&
|
||||
> operator=(basic_serial_port<Executor1>&& other)
|
||||
{
|
||||
basic_serial_port tmp(std::move(other));
|
||||
impl_ = std::move(tmp.impl_);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// Destroys the serial port.
|
||||
/**
|
||||
* This function destroys the serial port, cancelling any outstanding
|
||||
* asynchronous wait operations associated with the serial port as if by
|
||||
* calling @c cancel.
|
||||
*/
|
||||
~basic_serial_port()
|
||||
{
|
||||
}
|
||||
|
||||
/// Get the executor associated with the object.
|
||||
const executor_type& get_executor() 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_serial_port 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_serial_port 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;
|
||||
}
|
||||
|
||||
/// Open the serial port using the specified device name.
|
||||
/**
|
||||
* This function opens the serial port for the specified device name.
|
||||
*
|
||||
* @param device The platform-specific device name.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*/
|
||||
void open(const std::string& device)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().open(impl_.get_implementation(), device, ec);
|
||||
asio::detail::throw_error(ec, "open");
|
||||
}
|
||||
|
||||
/// Open the serial port using the specified device name.
|
||||
/**
|
||||
* This function opens the serial port using the given platform-specific
|
||||
* device name.
|
||||
*
|
||||
* @param device The platform-specific device name.
|
||||
*
|
||||
* @param ec Set the indicate what error occurred, if any.
|
||||
*/
|
||||
ASIO_SYNC_OP_VOID open(const std::string& device,
|
||||
asio::error_code& ec)
|
||||
{
|
||||
impl_.get_service().open(impl_.get_implementation(), device, ec);
|
||||
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||
}
|
||||
|
||||
/// Assign an existing native serial port to the serial port.
|
||||
/*
|
||||
* This function opens the serial port to hold an existing native serial port.
|
||||
*
|
||||
* @param native_serial_port A native serial port.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*/
|
||||
void assign(const native_handle_type& native_serial_port)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().assign(impl_.get_implementation(),
|
||||
native_serial_port, ec);
|
||||
asio::detail::throw_error(ec, "assign");
|
||||
}
|
||||
|
||||
/// Assign an existing native serial port to the serial port.
|
||||
/*
|
||||
* This function opens the serial port to hold an existing native serial port.
|
||||
*
|
||||
* @param native_serial_port A native serial port.
|
||||
*
|
||||
* @param ec Set to indicate what error occurred, if any.
|
||||
*/
|
||||
ASIO_SYNC_OP_VOID assign(const native_handle_type& native_serial_port,
|
||||
asio::error_code& ec)
|
||||
{
|
||||
impl_.get_service().assign(impl_.get_implementation(),
|
||||
native_serial_port, ec);
|
||||
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||
}
|
||||
|
||||
/// Determine whether the serial port is open.
|
||||
bool is_open() const
|
||||
{
|
||||
return impl_.get_service().is_open(impl_.get_implementation());
|
||||
}
|
||||
|
||||
/// Close the serial port.
|
||||
/**
|
||||
* This function is used to close the serial port. 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.
|
||||
*/
|
||||
void close()
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||
asio::detail::throw_error(ec, "close");
|
||||
}
|
||||
|
||||
/// Close the serial port.
|
||||
/**
|
||||
* This function is used to close the serial port. 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.
|
||||
*/
|
||||
ASIO_SYNC_OP_VOID close(asio::error_code& ec)
|
||||
{
|
||||
impl_.get_service().close(impl_.get_implementation(), ec);
|
||||
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||
}
|
||||
|
||||
/// Get the native serial port representation.
|
||||
/**
|
||||
* This function may be used to obtain the underlying representation of the
|
||||
* serial port. This is intended to allow access to native serial port
|
||||
* 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 serial port.
|
||||
/**
|
||||
* This function causes all outstanding asynchronous read or 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 serial port.
|
||||
/**
|
||||
* This function causes all outstanding asynchronous read or 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);
|
||||
}
|
||||
|
||||
/// Send a break sequence to the serial port.
|
||||
/**
|
||||
* This function causes a break sequence of platform-specific duration to be
|
||||
* sent out the serial port.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*/
|
||||
void send_break()
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().send_break(impl_.get_implementation(), ec);
|
||||
asio::detail::throw_error(ec, "send_break");
|
||||
}
|
||||
|
||||
/// Send a break sequence to the serial port.
|
||||
/**
|
||||
* This function causes a break sequence of platform-specific duration to be
|
||||
* sent out the serial port.
|
||||
*
|
||||
* @param ec Set to indicate what error occurred, if any.
|
||||
*/
|
||||
ASIO_SYNC_OP_VOID send_break(asio::error_code& ec)
|
||||
{
|
||||
impl_.get_service().send_break(impl_.get_implementation(), ec);
|
||||
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||
}
|
||||
|
||||
/// Set an option on the serial port.
|
||||
/**
|
||||
* This function is used to set an option on the serial port.
|
||||
*
|
||||
* @param option The option value to be set on the serial port.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*
|
||||
* @sa SettableSerialPortOption @n
|
||||
* asio::serial_port_base::baud_rate @n
|
||||
* asio::serial_port_base::flow_control @n
|
||||
* asio::serial_port_base::parity @n
|
||||
* asio::serial_port_base::stop_bits @n
|
||||
* asio::serial_port_base::character_size
|
||||
*/
|
||||
template <typename SettableSerialPortOption>
|
||||
void set_option(const SettableSerialPortOption& option)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().set_option(impl_.get_implementation(), option, ec);
|
||||
asio::detail::throw_error(ec, "set_option");
|
||||
}
|
||||
|
||||
/// Set an option on the serial port.
|
||||
/**
|
||||
* This function is used to set an option on the serial port.
|
||||
*
|
||||
* @param option The option value to be set on the serial port.
|
||||
*
|
||||
* @param ec Set to indicate what error occurred, if any.
|
||||
*
|
||||
* @sa SettableSerialPortOption @n
|
||||
* asio::serial_port_base::baud_rate @n
|
||||
* asio::serial_port_base::flow_control @n
|
||||
* asio::serial_port_base::parity @n
|
||||
* asio::serial_port_base::stop_bits @n
|
||||
* asio::serial_port_base::character_size
|
||||
*/
|
||||
template <typename SettableSerialPortOption>
|
||||
ASIO_SYNC_OP_VOID set_option(const SettableSerialPortOption& option,
|
||||
asio::error_code& ec)
|
||||
{
|
||||
impl_.get_service().set_option(impl_.get_implementation(), option, ec);
|
||||
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||
}
|
||||
|
||||
/// Get an option from the serial port.
|
||||
/**
|
||||
* This function is used to get the current value of an option on the serial
|
||||
* port.
|
||||
*
|
||||
* @param option The option value to be obtained from the serial port.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*
|
||||
* @sa GettableSerialPortOption @n
|
||||
* asio::serial_port_base::baud_rate @n
|
||||
* asio::serial_port_base::flow_control @n
|
||||
* asio::serial_port_base::parity @n
|
||||
* asio::serial_port_base::stop_bits @n
|
||||
* asio::serial_port_base::character_size
|
||||
*/
|
||||
template <typename GettableSerialPortOption>
|
||||
void get_option(GettableSerialPortOption& option) const
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().get_option(impl_.get_implementation(), option, ec);
|
||||
asio::detail::throw_error(ec, "get_option");
|
||||
}
|
||||
|
||||
/// Get an option from the serial port.
|
||||
/**
|
||||
* This function is used to get the current value of an option on the serial
|
||||
* port.
|
||||
*
|
||||
* @param option The option value to be obtained from the serial port.
|
||||
*
|
||||
* @param ec Set to indicate what error occurred, if any.
|
||||
*
|
||||
* @sa GettableSerialPortOption @n
|
||||
* asio::serial_port_base::baud_rate @n
|
||||
* asio::serial_port_base::flow_control @n
|
||||
* asio::serial_port_base::parity @n
|
||||
* asio::serial_port_base::stop_bits @n
|
||||
* asio::serial_port_base::character_size
|
||||
*/
|
||||
template <typename GettableSerialPortOption>
|
||||
ASIO_SYNC_OP_VOID get_option(GettableSerialPortOption& option,
|
||||
asio::error_code& ec) const
|
||||
{
|
||||
impl_.get_service().get_option(impl_.get_implementation(), option, ec);
|
||||
ASIO_SYNC_OP_VOID_RETURN(ec);
|
||||
}
|
||||
|
||||
/// Write some data to the serial port.
|
||||
/**
|
||||
* This function is used to write data to the serial port. 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 serial port.
|
||||
*
|
||||
* @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
|
||||
* basic_serial_port.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 serial port.
|
||||
/**
|
||||
* This function is used to write data to the serial port. 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 serial port.
|
||||
*
|
||||
* @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 serial port.
|
||||
* 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 serial port.
|
||||
* 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::async_immediate().
|
||||
*
|
||||
* @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
|
||||
* basic_serial_port.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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some(const ConstBufferSequence& buffers,
|
||||
WriteToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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 serial port.
|
||||
/**
|
||||
* This function is used to read data from the serial port. 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_serial_port.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 serial port.
|
||||
/**
|
||||
* This function is used to read data from the serial port. 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 serial port.
|
||||
* 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::async_immediate().
|
||||
*
|
||||
* @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_serial_port.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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some(const MutableBufferSequence& buffers,
|
||||
ReadToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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_serial_port(const basic_serial_port&) = delete;
|
||||
basic_serial_port& operator=(const basic_serial_port&) = delete;
|
||||
|
||||
class initiate_async_write_some
|
||||
{
|
||||
public:
|
||||
typedef Executor executor_type;
|
||||
|
||||
explicit initiate_async_write_some(basic_serial_port* self)
|
||||
: self_(self)
|
||||
{
|
||||
}
|
||||
|
||||
const executor_type& get_executor() const noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WriteHandler, typename ConstBufferSequence>
|
||||
void operator()(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_serial_port* self_;
|
||||
};
|
||||
|
||||
class initiate_async_read_some
|
||||
{
|
||||
public:
|
||||
typedef Executor executor_type;
|
||||
|
||||
explicit initiate_async_read_some(basic_serial_port* self)
|
||||
: self_(self)
|
||||
{
|
||||
}
|
||||
|
||||
const executor_type& get_executor() const noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename ReadHandler, typename MutableBufferSequence>
|
||||
void operator()(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_serial_port* self_;
|
||||
};
|
||||
|
||||
#if defined(ASIO_HAS_IOCP)
|
||||
detail::io_object_impl<detail::win_iocp_serial_port_service, Executor> impl_;
|
||||
#else
|
||||
detail::io_object_impl<detail::posix_serial_port_service, Executor> impl_;
|
||||
#endif
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // defined(ASIO_HAS_SERIAL_PORT)
|
||||
// || defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
#endif // ASIO_BASIC_SERIAL_PORT_HPP
|
||||
653
Packages/asio-1.36.0/include/asio/basic_signal_set.hpp
vendored
Normal file
653
Packages/asio-1.36.0/include/asio/basic_signal_set.hpp
vendored
Normal file
@@ -0,0 +1,653 @@
|
||||
//
|
||||
// basic_signal_set.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/signal_set_base.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 : public signal_set_base
|
||||
{
|
||||
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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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() 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);
|
||||
}
|
||||
|
||||
/// Add a signal to a signal_set with the specified flags.
|
||||
/**
|
||||
* This function adds the specified signal to the set. It has no effect if the
|
||||
* signal is already in the set.
|
||||
*
|
||||
* Flags other than flags::dont_care require OS support for the @c sigaction
|
||||
* call, and this function will fail with @c error::operation_not_supported if
|
||||
* this is unavailable.
|
||||
*
|
||||
* The specified flags will conflict with a prior, active registration of the
|
||||
* same signal, if either specified a flags value other than flags::dont_care.
|
||||
* In this case, the @c add will fail with @c error::invalid_argument.
|
||||
*
|
||||
* @param signal_number The signal to be added to the set.
|
||||
*
|
||||
* @param f Flags to modify the behaviour of the specified signal.
|
||||
*
|
||||
* @throws asio::system_error Thrown on failure.
|
||||
*/
|
||||
void add(int signal_number, flags_t f)
|
||||
{
|
||||
asio::error_code ec;
|
||||
impl_.get_service().add(impl_.get_implementation(), signal_number, f, ec);
|
||||
asio::detail::throw_error(ec, "add");
|
||||
}
|
||||
|
||||
/// Add a signal to a signal_set with the specified flags.
|
||||
/**
|
||||
* This function adds the specified signal to the set. It has no effect if the
|
||||
* signal is already in the set.
|
||||
*
|
||||
* Flags other than flags::dont_care require OS support for the @c sigaction
|
||||
* call, and this function will fail with @c error::operation_not_supported if
|
||||
* this is unavailable.
|
||||
*
|
||||
* The specified flags will conflict with a prior, active registration of the
|
||||
* same signal, if either specified a flags value other than flags::dont_care.
|
||||
* In this case, the @c add will fail with @c error::invalid_argument.
|
||||
*
|
||||
* @param signal_number The signal to be added to the set.
|
||||
*
|
||||
* @param f Flags to modify the behaviour of the specified signal.
|
||||
*
|
||||
* @param ec Set to indicate what error occurred, if any.
|
||||
*/
|
||||
ASIO_SYNC_OP_VOID add(int signal_number, flags_t f,
|
||||
asio::error_code& ec)
|
||||
{
|
||||
impl_.get_service().add(impl_.get_implementation(), signal_number, f, 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::async_immediate().
|
||||
*
|
||||
* @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
|
||||
*
|
||||
* @note Unlike the POSIX function @c signal, @c async_wait executes its
|
||||
* completion handler as specified in the @ref async_op_requirements. This
|
||||
* means it places no async-signal safety restrictions on what work can be
|
||||
* performed in a completion handler.
|
||||
*/
|
||||
template <
|
||||
ASIO_COMPLETION_TOKEN_FOR(void (asio::error_code, int))
|
||||
SignalToken = default_completion_token_t<executor_type>>
|
||||
auto async_wait(
|
||||
SignalToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_signal_set& operator=(const basic_signal_set&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename SignalHandler>
|
||||
void operator()(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
|
||||
1936
Packages/asio-1.36.0/include/asio/basic_socket.hpp
vendored
Normal file
1936
Packages/asio-1.36.0/include/asio/basic_socket.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
2708
Packages/asio-1.36.0/include/asio/basic_socket_acceptor.hpp
vendored
Normal file
2708
Packages/asio-1.36.0/include/asio/basic_socket_acceptor.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
266
Packages/asio-1.36.0/include/asio/basic_socket_iostream.hpp
vendored
Normal file
266
Packages/asio-1.36.0/include/asio/basic_socket_iostream.hpp
vendored
Normal file
@@ -0,0 +1,266 @@
|
||||
//
|
||||
// basic_socket_iostream.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
|
||||
#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()
|
||||
{
|
||||
}
|
||||
|
||||
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;
|
||||
}
|
||||
|
||||
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,
|
||||
typename Clock = chrono::steady_clock,
|
||||
typename WaitTraits = wait_traits<Clock>>
|
||||
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:
|
||||
typedef detail::chrono_time_traits<Clock, WaitTraits> traits_helper;
|
||||
|
||||
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)
|
||||
/// The time type.
|
||||
typedef typename WaitTraits::time_point time_point;
|
||||
|
||||
/// The duration type.
|
||||
typedef typename WaitTraits::duration duration;
|
||||
#else
|
||||
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);
|
||||
}
|
||||
|
||||
/// 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);
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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... 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);
|
||||
}
|
||||
|
||||
/// 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... T>
|
||||
void connect(T... x)
|
||||
{
|
||||
if (rdbuf()->connect(x...) == 0)
|
||||
this->setstate(std::ios_base::failbit);
|
||||
}
|
||||
|
||||
/// 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();
|
||||
}
|
||||
|
||||
/// 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);
|
||||
}
|
||||
|
||||
private:
|
||||
// Disallow copying and assignment.
|
||||
basic_socket_iostream(const basic_socket_iostream&) = delete;
|
||||
basic_socket_iostream& operator=(
|
||||
const basic_socket_iostream&) = delete;
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // !defined(ASIO_NO_IOSTREAM)
|
||||
|
||||
#endif // ASIO_BASIC_SOCKET_IOSTREAM_HPP
|
||||
545
Packages/asio-1.36.0/include/asio/basic_socket_streambuf.hpp
vendored
Normal file
545
Packages/asio-1.36.0/include/asio/basic_socket_streambuf.hpp
vendored
Normal file
@@ -0,0 +1,545 @@
|
||||
//
|
||||
// basic_socket_streambuf.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#include "asio/steady_timer.hpp"
|
||||
|
||||
#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,
|
||||
typename Clock = chrono::steady_clock,
|
||||
typename WaitTraits = wait_traits<Clock>>
|
||||
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,
|
||||
private basic_socket<Protocol>
|
||||
{
|
||||
private:
|
||||
typedef detail::chrono_time_traits<Clock, WaitTraits> traits_helper;
|
||||
|
||||
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)
|
||||
/// The time type.
|
||||
typedef typename WaitTraits::time_point time_point;
|
||||
|
||||
/// The duration type.
|
||||
typedef typename WaitTraits::duration duration;
|
||||
#else
|
||||
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();
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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... 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;
|
||||
}
|
||||
|
||||
/// 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_;
|
||||
}
|
||||
|
||||
/// 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);
|
||||
}
|
||||
|
||||
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&) = delete;
|
||||
basic_socket_streambuf& operator=(
|
||||
const basic_socket_streambuf&) = delete;
|
||||
|
||||
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()
|
||||
{
|
||||
return (time_point::max)();
|
||||
}
|
||||
|
||||
enum { putback_max = 8 };
|
||||
asio::error_code ec_;
|
||||
time_point expiry_time_;
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // !defined(ASIO_NO_IOSTREAM)
|
||||
|
||||
#endif // ASIO_BASIC_SOCKET_STREAMBUF_HPP
|
||||
744
Packages/asio-1.36.0/include/asio/basic_stream_file.hpp
vendored
Normal file
744
Packages/asio-1.36.0/include/asio/basic_stream_file.hpp
vendored
Normal file
@@ -0,0 +1,744 @@
|
||||
//
|
||||
// basic_stream_file.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = defaulted_constraint())
|
||||
: basic_file<Executor>(context, native_file)
|
||||
{
|
||||
this->impl_.get_service().set_is_stream(
|
||||
this->impl_.get_implementation(), true);
|
||||
}
|
||||
|
||||
/// 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) 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,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
defaulted_constraint
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_stream_file&
|
||||
> operator=(basic_stream_file<Executor1>&& other)
|
||||
{
|
||||
basic_file<Executor>::operator=(std::move(other));
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// 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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some(const ConstBufferSequence& buffers,
|
||||
WriteToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some(const MutableBufferSequence& buffers,
|
||||
ReadToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_stream_file& operator=(const basic_stream_file&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WriteHandler, typename ConstBufferSequence>
|
||||
void operator()(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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename ReadHandler, typename MutableBufferSequence>
|
||||
void operator()(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
|
||||
1163
Packages/asio-1.36.0/include/asio/basic_stream_socket.hpp
vendored
Normal file
1163
Packages/asio-1.36.0/include/asio/basic_stream_socket.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
450
Packages/asio-1.36.0/include/asio/basic_streambuf.hpp
vendored
Normal file
450
Packages/asio-1.36.0/include/asio/basic_streambuf.hpp
vendored
Normal file
@@ -0,0 +1,450 @@
|
||||
//
|
||||
// basic_streambuf.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 const_buffer const_buffers_type;
|
||||
typedef 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 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 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 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 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) noexcept
|
||||
: sb_(other.sb_)
|
||||
{
|
||||
}
|
||||
|
||||
/// Move construct a basic_streambuf_ref.
|
||||
basic_streambuf_ref(basic_streambuf_ref&& other) noexcept
|
||||
: sb_(other.sb_)
|
||||
{
|
||||
}
|
||||
|
||||
/// Get the size of the input sequence.
|
||||
std::size_t size() const noexcept
|
||||
{
|
||||
return sb_.size();
|
||||
}
|
||||
|
||||
/// Get the maximum size of the dynamic buffer.
|
||||
std::size_t max_size() const noexcept
|
||||
{
|
||||
return sb_.max_size();
|
||||
}
|
||||
|
||||
/// Get the current capacity of the dynamic buffer.
|
||||
std::size_t capacity() const noexcept
|
||||
{
|
||||
return sb_.capacity();
|
||||
}
|
||||
|
||||
/// Get a list of buffers that represents the input sequence.
|
||||
const_buffers_type data() const 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
Packages/asio-1.36.0/include/asio/basic_streambuf_fwd.hpp
vendored
Normal file
36
Packages/asio-1.36.0/include/asio/basic_streambuf_fwd.hpp
vendored
Normal file
@@ -0,0 +1,36 @@
|
||||
//
|
||||
// basic_streambuf_fwd.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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
|
||||
645
Packages/asio-1.36.0/include/asio/basic_waitable_timer.hpp
vendored
Normal file
645
Packages/asio-1.36.0/include/asio/basic_waitable_timer.hpp
vendored
Normal file
@@ -0,0 +1,645 @@
|
||||
//
|
||||
// basic_waitable_timer.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 <utility>
|
||||
#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"
|
||||
|
||||
#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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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");
|
||||
}
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_waitable_timer&
|
||||
> operator=(basic_waitable_timer<Clock, WaitTraits, Executor1>&& other)
|
||||
{
|
||||
basic_waitable_timer tmp(std::move(other));
|
||||
impl_ = std::move(tmp.impl_);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// 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() 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;
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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;
|
||||
}
|
||||
|
||||
/// 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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_wait(
|
||||
WaitToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_waitable_timer& operator=(const basic_waitable_timer&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WaitHandler>
|
||||
void operator()(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
|
||||
622
Packages/asio-1.36.0/include/asio/basic_writable_pipe.hpp
vendored
Normal file
622
Packages/asio-1.36.0/include/asio/basic_writable_pipe.hpp
vendored
Normal file
@@ -0,0 +1,622 @@
|
||||
//
|
||||
// basic_writable_pipe.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 <utility>
|
||||
#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
|
||||
|
||||
#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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value,
|
||||
defaulted_constraint
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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");
|
||||
}
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
defaulted_constraint
|
||||
> = 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>
|
||||
constraint_t<
|
||||
is_convertible<Executor1, Executor>::value,
|
||||
basic_writable_pipe&
|
||||
> operator=(basic_writable_pipe<Executor1>&& other)
|
||||
{
|
||||
basic_writable_pipe tmp(std::move(other));
|
||||
impl_ = std::move(tmp.impl_);
|
||||
return *this;
|
||||
}
|
||||
|
||||
/// 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() 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::async_immediate().
|
||||
*
|
||||
* @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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some(const ConstBufferSequence& buffers,
|
||||
WriteToken&& token = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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&) = delete;
|
||||
basic_writable_pipe& operator=(const basic_writable_pipe&) = delete;
|
||||
|
||||
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 noexcept
|
||||
{
|
||||
return self_->get_executor();
|
||||
}
|
||||
|
||||
template <typename WriteHandler, typename ConstBufferSequence>
|
||||
void operator()(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
|
||||
603
Packages/asio-1.36.0/include/asio/bind_allocator.hpp
vendored
Normal file
603
Packages/asio-1.36.0/include/asio/bind_allocator.hpp
vendored
Normal file
@@ -0,0 +1,603 @@
|
||||
//
|
||||
// bind_allocator.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/associated_allocator.hpp"
|
||||
#include "asio/associated_executor.hpp"
|
||||
#include "asio/associator.hpp"
|
||||
#include "asio/async_result.hpp"
|
||||
#include "asio/detail/initiation_base.hpp"
|
||||
#include "asio/detail/type_traits.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, void_t<typename T::result_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, void_t<typename T::argument_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,
|
||||
void_t<typename T::first_argument_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;
|
||||
};
|
||||
|
||||
} // 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, U&& u)
|
||||
: allocator_(s),
|
||||
target_(static_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,
|
||||
constraint_t<is_constructible<Allocator, OtherAllocator>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: 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,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: allocator_(s),
|
||||
target_(other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Move constructor.
|
||||
allocator_binder(allocator_binder&& other)
|
||||
: allocator_(static_cast<allocator_type&&>(
|
||||
other.get_allocator())),
|
||||
target_(static_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_(static_cast<T&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move construct from a different allocator wrapper type.
|
||||
template <typename U, typename OtherAllocator>
|
||||
allocator_binder(
|
||||
allocator_binder<U, OtherAllocator>&& other,
|
||||
constraint_t<is_constructible<Allocator, OtherAllocator>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: allocator_(static_cast<OtherAllocator&&>(
|
||||
other.get_allocator())),
|
||||
target_(static_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,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: allocator_(s),
|
||||
target_(static_cast<U&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Destructor.
|
||||
~allocator_binder()
|
||||
{
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
target_type& get() noexcept
|
||||
{
|
||||
return target_;
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
const target_type& get() const noexcept
|
||||
{
|
||||
return target_;
|
||||
}
|
||||
|
||||
/// Obtain the associated allocator.
|
||||
allocator_type get_allocator() const noexcept
|
||||
{
|
||||
return allocator_;
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &
|
||||
{
|
||||
return target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &&
|
||||
{
|
||||
return static_cast<T&&>(target_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) const&
|
||||
{
|
||||
return target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
Allocator allocator_;
|
||||
T target_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to specify that
|
||||
/// the completion handler should have the supplied allocator as its associated
|
||||
/// allocator.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Allocator>
|
||||
struct partial_allocator_binder
|
||||
{
|
||||
/// Constructor that specifies associated allocator.
|
||||
explicit partial_allocator_binder(const Allocator& ex)
|
||||
: allocator_(ex)
|
||||
{
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to specify that the completion handler
|
||||
/// should have the allocator as its associated allocator.
|
||||
template <typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
constexpr allocator_binder<decay_t<CompletionToken>, Allocator>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return allocator_binder<decay_t<CompletionToken>, Allocator>(
|
||||
allocator_, static_cast<CompletionToken&&>(completion_token));
|
||||
}
|
||||
|
||||
//private:
|
||||
Allocator allocator_;
|
||||
};
|
||||
|
||||
/// Create a partial completion token that associates an allocator.
|
||||
template <typename Allocator>
|
||||
ASIO_NODISCARD inline partial_allocator_binder<Allocator>
|
||||
bind_allocator(const Allocator& ex)
|
||||
{
|
||||
return partial_allocator_binder<Allocator>(ex);
|
||||
}
|
||||
|
||||
/// Associate an object of type @c T with an allocator of type
|
||||
/// @c Allocator.
|
||||
template <typename Allocator, typename T>
|
||||
ASIO_NODISCARD inline allocator_binder<decay_t<T>, Allocator>
|
||||
bind_allocator(const Allocator& s, T&& t)
|
||||
{
|
||||
return allocator_binder<decay_t<T>, Allocator>(s, static_cast<T&&>(t));
|
||||
}
|
||||
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename TargetAsyncResult, typename Allocator, typename = void>
|
||||
class allocator_binder_completion_handler_async_result
|
||||
{
|
||||
public:
|
||||
template <typename T>
|
||||
explicit allocator_binder_completion_handler_async_result(T&)
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult, typename Allocator>
|
||||
class allocator_binder_completion_handler_async_result<
|
||||
TargetAsyncResult, Allocator,
|
||||
void_t<typename TargetAsyncResult::completion_handler_type>>
|
||||
{
|
||||
private:
|
||||
TargetAsyncResult target_;
|
||||
|
||||
public:
|
||||
typedef allocator_binder<
|
||||
typename TargetAsyncResult::completion_handler_type, Allocator>
|
||||
completion_handler_type;
|
||||
|
||||
explicit allocator_binder_completion_handler_async_result(
|
||||
typename TargetAsyncResult::completion_handler_type& handler)
|
||||
: target_(handler)
|
||||
{
|
||||
}
|
||||
|
||||
auto get() -> decltype(target_.get())
|
||||
{
|
||||
return target_.get();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult, typename = void>
|
||||
struct allocator_binder_async_result_return_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult>
|
||||
struct allocator_binder_async_result_return_type<
|
||||
TargetAsyncResult, void_type<typename TargetAsyncResult::return_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_completion_handler_async_result<
|
||||
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)
|
||||
: detail::allocator_binder_completion_handler_async_result<
|
||||
async_result<T, Signature>, Allocator>(b.get())
|
||||
{
|
||||
}
|
||||
|
||||
template <typename Initiation>
|
||||
struct init_wrapper : detail::initiation_base<Initiation>
|
||||
{
|
||||
using detail::initiation_base<Initiation>::initiation_base;
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, const Allocator& a, Args&&... args) &&
|
||||
{
|
||||
static_cast<Initiation&&>(*this)(
|
||||
allocator_binder<decay_t<Handler>, Allocator>(
|
||||
a, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler,
|
||||
const Allocator& a, Args&&... args) const &
|
||||
{
|
||||
static_cast<const Initiation&>(*this)(
|
||||
allocator_binder<decay_t<Handler>, Allocator>(
|
||||
a, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
declval<init_wrapper<decay_t<Initiation>>>(),
|
||||
token.get(), token.get_allocator(), static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
init_wrapper<decay_t<Initiation>>(
|
||||
static_cast<Initiation&&>(initiation)),
|
||||
token.get(), token.get_allocator(), static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
async_result(const async_result&) = delete;
|
||||
async_result& operator=(const async_result&) = delete;
|
||||
|
||||
async_result<T, Signature> target_;
|
||||
};
|
||||
|
||||
template <typename Allocator, typename... Signatures>
|
||||
struct async_result<partial_allocator_binder<Allocator>, Signatures...>
|
||||
{
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
allocator_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
Allocator>(token.allocator_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
allocator_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
Allocator>(token.allocator_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <template <typename, typename> class Associator,
|
||||
typename T, typename Allocator, typename DefaultCandidate>
|
||||
struct associator<Associator, allocator_binder<T, Allocator>, DefaultCandidate>
|
||||
: Associator<T, DefaultCandidate>
|
||||
{
|
||||
static typename Associator<T, DefaultCandidate>::type get(
|
||||
const allocator_binder<T, Allocator>& b) noexcept
|
||||
{
|
||||
return Associator<T, DefaultCandidate>::get(b.get());
|
||||
}
|
||||
|
||||
static auto get(const allocator_binder<T, Allocator>& b,
|
||||
const DefaultCandidate& c) noexcept
|
||||
-> decltype(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 auto get(const allocator_binder<T, Allocator>& b,
|
||||
const Allocator1& = Allocator1()) noexcept
|
||||
-> decltype(b.get_allocator())
|
||||
{
|
||||
return b.get_allocator();
|
||||
}
|
||||
};
|
||||
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_BIND_ALLOCATOR_HPP
|
||||
620
Packages/asio-1.36.0/include/asio/bind_cancellation_slot.hpp
vendored
Normal file
620
Packages/asio-1.36.0/include/asio/bind_cancellation_slot.hpp
vendored
Normal file
@@ -0,0 +1,620 @@
|
||||
//
|
||||
// bind_cancellation_slot.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/associated_cancellation_slot.hpp"
|
||||
#include "asio/associated_executor.hpp"
|
||||
#include "asio/associator.hpp"
|
||||
#include "asio/async_result.hpp"
|
||||
#include "asio/detail/initiation_base.hpp"
|
||||
#include "asio/detail/type_traits.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, void_t<typename T::result_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,
|
||||
void_t<typename T::argument_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,
|
||||
void_t<typename T::first_argument_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;
|
||||
};
|
||||
|
||||
} // 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, U&& u)
|
||||
: slot_(s),
|
||||
target_(static_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,
|
||||
constraint_t<is_constructible<CancellationSlot,
|
||||
OtherCancellationSlot>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: 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,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: slot_(s),
|
||||
target_(other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Move constructor.
|
||||
cancellation_slot_binder(cancellation_slot_binder&& other)
|
||||
: slot_(static_cast<cancellation_slot_type&&>(
|
||||
other.get_cancellation_slot())),
|
||||
target_(static_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_(static_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,
|
||||
constraint_t<is_constructible<CancellationSlot,
|
||||
OtherCancellationSlot>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: slot_(static_cast<OtherCancellationSlot&&>(
|
||||
other.get_cancellation_slot())),
|
||||
target_(static_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,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: slot_(s),
|
||||
target_(static_cast<U&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Destructor.
|
||||
~cancellation_slot_binder()
|
||||
{
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
target_type& get() noexcept
|
||||
{
|
||||
return target_;
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
const target_type& get() const noexcept
|
||||
{
|
||||
return target_;
|
||||
}
|
||||
|
||||
/// Obtain the associated cancellation slot.
|
||||
cancellation_slot_type get_cancellation_slot() const noexcept
|
||||
{
|
||||
return slot_;
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &
|
||||
{
|
||||
return target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &&
|
||||
{
|
||||
return static_cast<T&&>(target_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) const&
|
||||
{
|
||||
return target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
CancellationSlot slot_;
|
||||
T target_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to specify that
|
||||
/// the completion handler should have the supplied cancellation slot as its
|
||||
/// associated cancellation slot.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename CancellationSlot>
|
||||
struct partial_cancellation_slot_binder
|
||||
{
|
||||
/// Constructor that specifies associated cancellation slot.
|
||||
explicit partial_cancellation_slot_binder(const CancellationSlot& ex)
|
||||
: cancellation_slot_(ex)
|
||||
{
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to specify that the completion handler
|
||||
/// should have the cancellation slot as its associated cancellation slot.
|
||||
template <typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
constexpr cancellation_slot_binder<decay_t<CompletionToken>, CancellationSlot>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return cancellation_slot_binder<decay_t<CompletionToken>, CancellationSlot>(
|
||||
static_cast<CompletionToken&&>(completion_token), cancellation_slot_);
|
||||
}
|
||||
|
||||
//private:
|
||||
CancellationSlot cancellation_slot_;
|
||||
};
|
||||
|
||||
/// Create a partial completion token that associates a cancellation slot.
|
||||
template <typename CancellationSlot>
|
||||
ASIO_NODISCARD inline partial_cancellation_slot_binder<CancellationSlot>
|
||||
bind_cancellation_slot(const CancellationSlot& ex)
|
||||
{
|
||||
return partial_cancellation_slot_binder<CancellationSlot>(ex);
|
||||
}
|
||||
|
||||
/// 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<decay_t<T>, CancellationSlot>
|
||||
bind_cancellation_slot(const CancellationSlot& s, T&& t)
|
||||
{
|
||||
return cancellation_slot_binder<decay_t<T>, CancellationSlot>(
|
||||
s, static_cast<T&&>(t));
|
||||
}
|
||||
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename TargetAsyncResult,
|
||||
typename CancellationSlot, typename = void>
|
||||
class cancellation_slot_binder_completion_handler_async_result
|
||||
{
|
||||
public:
|
||||
template <typename T>
|
||||
explicit cancellation_slot_binder_completion_handler_async_result(T&)
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult, typename CancellationSlot>
|
||||
class cancellation_slot_binder_completion_handler_async_result<
|
||||
TargetAsyncResult, CancellationSlot,
|
||||
void_t<typename TargetAsyncResult::completion_handler_type>>
|
||||
{
|
||||
private:
|
||||
TargetAsyncResult target_;
|
||||
|
||||
public:
|
||||
typedef cancellation_slot_binder<
|
||||
typename TargetAsyncResult::completion_handler_type, CancellationSlot>
|
||||
completion_handler_type;
|
||||
|
||||
explicit cancellation_slot_binder_completion_handler_async_result(
|
||||
typename TargetAsyncResult::completion_handler_type& handler)
|
||||
: target_(handler)
|
||||
{
|
||||
}
|
||||
|
||||
auto get() -> decltype(target_.get())
|
||||
{
|
||||
return target_.get();
|
||||
}
|
||||
};
|
||||
|
||||
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, void_t<typename TargetAsyncResult::return_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_completion_handler_async_result<
|
||||
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)
|
||||
: detail::cancellation_slot_binder_completion_handler_async_result<
|
||||
async_result<T, Signature>, CancellationSlot>(b.get())
|
||||
{
|
||||
}
|
||||
|
||||
template <typename Initiation>
|
||||
struct init_wrapper : detail::initiation_base<Initiation>
|
||||
{
|
||||
using detail::initiation_base<Initiation>::initiation_base;
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler,
|
||||
const CancellationSlot& slot, Args&&... args) &&
|
||||
{
|
||||
static_cast<Initiation&&>(*this)(
|
||||
cancellation_slot_binder<decay_t<Handler>, CancellationSlot>(
|
||||
slot, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler,
|
||||
const CancellationSlot& slot, Args&&... args) const &
|
||||
{
|
||||
static_cast<const Initiation&>(*this)(
|
||||
cancellation_slot_binder<decay_t<Handler>, CancellationSlot>(
|
||||
slot, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
declval<init_wrapper<decay_t<Initiation>>>(),
|
||||
token.get(), token.get_cancellation_slot(),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
init_wrapper<decay_t<Initiation>>(
|
||||
static_cast<Initiation&&>(initiation)),
|
||||
token.get(), token.get_cancellation_slot(),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
async_result(const async_result&) = delete;
|
||||
async_result& operator=(const async_result&) = delete;
|
||||
|
||||
async_result<T, Signature> target_;
|
||||
};
|
||||
|
||||
template <typename CancellationSlot, typename... Signatures>
|
||||
struct async_result<partial_cancellation_slot_binder<CancellationSlot>,
|
||||
Signatures...>
|
||||
{
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
cancellation_slot_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
CancellationSlot>(token.cancellation_slot_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
cancellation_slot_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
CancellationSlot>(token.cancellation_slot_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <template <typename, typename> class Associator,
|
||||
typename T, typename CancellationSlot, typename DefaultCandidate>
|
||||
struct associator<Associator,
|
||||
cancellation_slot_binder<T, CancellationSlot>,
|
||||
DefaultCandidate>
|
||||
: Associator<T, DefaultCandidate>
|
||||
{
|
||||
static typename Associator<T, DefaultCandidate>::type get(
|
||||
const cancellation_slot_binder<T, CancellationSlot>& b) noexcept
|
||||
{
|
||||
return Associator<T, DefaultCandidate>::get(b.get());
|
||||
}
|
||||
|
||||
static auto get(const cancellation_slot_binder<T, CancellationSlot>& b,
|
||||
const DefaultCandidate& c) noexcept
|
||||
-> decltype(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 auto get(const cancellation_slot_binder<T, CancellationSlot>& b,
|
||||
const CancellationSlot1& = CancellationSlot1()) noexcept
|
||||
-> decltype(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
|
||||
671
Packages/asio-1.36.0/include/asio/bind_executor.hpp
vendored
Normal file
671
Packages/asio-1.36.0/include/asio/bind_executor.hpp
vendored
Normal file
@@ -0,0 +1,671 @@
|
||||
//
|
||||
// bind_executor.hpp
|
||||
// ~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/associated_executor.hpp"
|
||||
#include "asio/associator.hpp"
|
||||
#include "asio/async_result.hpp"
|
||||
#include "asio/detail/initiation_base.hpp"
|
||||
#include "asio/detail/type_traits.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, void_t<typename T::result_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, void_t<typename T::argument_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,
|
||||
void_t<typename T::first_argument_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(E&& e, U&& u)
|
||||
: executor_(static_cast<E&&>(e)),
|
||||
target_(executor_arg_t(), executor_, static_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(E&& e, U&& u)
|
||||
: executor_(static_cast<E&&>(e)),
|
||||
target_(static_cast<U&&>(u))
|
||||
{
|
||||
}
|
||||
|
||||
Executor executor_;
|
||||
T target_;
|
||||
};
|
||||
|
||||
} // 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,
|
||||
U&& u)
|
||||
: base_type(e, static_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,
|
||||
constraint_t<is_constructible<Executor, OtherExecutor>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: 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,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: base_type(e, other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Move constructor.
|
||||
executor_binder(executor_binder&& other)
|
||||
: base_type(static_cast<executor_type&&>(other.get_executor()),
|
||||
static_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, static_cast<T&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move construct from a different executor wrapper type.
|
||||
template <typename U, typename OtherExecutor>
|
||||
executor_binder(executor_binder<U, OtherExecutor>&& other,
|
||||
constraint_t<is_constructible<Executor, OtherExecutor>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: base_type(static_cast<OtherExecutor&&>(other.get_executor()),
|
||||
static_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,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: base_type(e, static_cast<U&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Destructor.
|
||||
~executor_binder()
|
||||
{
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
target_type& get() noexcept
|
||||
{
|
||||
return this->target_;
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
const target_type& get() const noexcept
|
||||
{
|
||||
return this->target_;
|
||||
}
|
||||
|
||||
/// Obtain the associated executor.
|
||||
executor_type get_executor() const noexcept
|
||||
{
|
||||
return this->executor_;
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &
|
||||
{
|
||||
return this->target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &&
|
||||
{
|
||||
return static_cast<T&&>(this->target_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) const&
|
||||
{
|
||||
return this->target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
typedef detail::executor_binder_base<T, Executor,
|
||||
uses_executor<T, Executor>::value> base_type;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to specify that
|
||||
/// the completion handler should have the supplied executor as its associated
|
||||
/// executor.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Executor>
|
||||
struct partial_executor_binder
|
||||
{
|
||||
/// Constructor that specifies associated executor.
|
||||
explicit partial_executor_binder(const Executor& ex)
|
||||
: executor_(ex)
|
||||
{
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to specify that the completion handler
|
||||
/// should have the executor as its associated executor.
|
||||
template <typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
constexpr executor_binder<decay_t<CompletionToken>, Executor>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return executor_binder<decay_t<CompletionToken>, Executor>(executor_arg_t(),
|
||||
static_cast<CompletionToken&&>(completion_token), executor_);
|
||||
}
|
||||
|
||||
//private:
|
||||
Executor executor_;
|
||||
};
|
||||
|
||||
/// Create a partial completion token that associates an executor.
|
||||
template <typename Executor>
|
||||
ASIO_NODISCARD inline partial_executor_binder<Executor>
|
||||
bind_executor(const Executor& ex,
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 0)
|
||||
{
|
||||
return partial_executor_binder<Executor>(ex);
|
||||
}
|
||||
|
||||
/// Associate an object of type @c T with an executor of type @c Executor.
|
||||
template <typename Executor, typename T>
|
||||
ASIO_NODISCARD inline executor_binder<decay_t<T>, Executor>
|
||||
bind_executor(const Executor& ex, T&& t,
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 0)
|
||||
{
|
||||
return executor_binder<decay_t<T>, Executor>(
|
||||
executor_arg_t(), ex, static_cast<T&&>(t));
|
||||
}
|
||||
|
||||
/// Create a partial completion token that associates an execution context's
|
||||
/// executor.
|
||||
template <typename ExecutionContext>
|
||||
ASIO_NODISCARD inline partial_executor_binder<
|
||||
typename ExecutionContext::executor_type>
|
||||
bind_executor(ExecutionContext& ctx,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
{
|
||||
return partial_executor_binder<typename ExecutionContext::executor_type>(
|
||||
ctx.get_executor());
|
||||
}
|
||||
|
||||
/// Associate an object of type @c T with an execution context's executor.
|
||||
template <typename ExecutionContext, typename T>
|
||||
ASIO_NODISCARD inline executor_binder<decay_t<T>,
|
||||
typename ExecutionContext::executor_type>
|
||||
bind_executor(ExecutionContext& ctx, T&& t,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
{
|
||||
return executor_binder<decay_t<T>, typename ExecutionContext::executor_type>(
|
||||
executor_arg_t(), ctx.get_executor(), static_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,
|
||||
void_t<typename TargetAsyncResult::completion_handler_type >>
|
||||
{
|
||||
private:
|
||||
TargetAsyncResult target_;
|
||||
|
||||
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)
|
||||
{
|
||||
}
|
||||
|
||||
auto get() -> decltype(target_.get())
|
||||
{
|
||||
return target_.get();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult, typename = void>
|
||||
struct executor_binder_async_result_return_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult>
|
||||
struct executor_binder_async_result_return_type<TargetAsyncResult,
|
||||
void_t<typename TargetAsyncResult::return_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 : detail::initiation_base<Initiation>
|
||||
{
|
||||
using detail::initiation_base<Initiation>::initiation_base;
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, const Executor& e, Args&&... args) &&
|
||||
{
|
||||
static_cast<Initiation&&>(*this)(
|
||||
executor_binder<decay_t<Handler>, Executor>(
|
||||
executor_arg_t(), e, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler,
|
||||
const Executor& e, Args&&... args) const &
|
||||
{
|
||||
static_cast<const Initiation&>(*this)(
|
||||
executor_binder<decay_t<Handler>, Executor>(
|
||||
executor_arg_t(), e, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
declval<init_wrapper<decay_t<Initiation>>>(),
|
||||
token.get(), token.get_executor(), static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
init_wrapper<decay_t<Initiation>>(
|
||||
static_cast<Initiation&&>(initiation)),
|
||||
token.get(), token.get_executor(), static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
async_result(const async_result&) = delete;
|
||||
async_result& operator=(const async_result&) = delete;
|
||||
};
|
||||
|
||||
template <typename Executor, typename... Signatures>
|
||||
struct async_result<partial_executor_binder<Executor>, Signatures...>
|
||||
{
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
executor_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
Executor>(executor_arg_t(), token.executor_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
executor_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
Executor>(executor_arg_t(), token.executor_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <template <typename, typename> class Associator,
|
||||
typename T, typename Executor, typename DefaultCandidate>
|
||||
struct associator<Associator, executor_binder<T, Executor>, DefaultCandidate>
|
||||
: Associator<T, DefaultCandidate>
|
||||
{
|
||||
static typename Associator<T, DefaultCandidate>::type get(
|
||||
const executor_binder<T, Executor>& b) noexcept
|
||||
{
|
||||
return Associator<T, DefaultCandidate>::get(b.get());
|
||||
}
|
||||
|
||||
static auto get(const executor_binder<T, Executor>& b,
|
||||
const DefaultCandidate& c) noexcept
|
||||
-> decltype(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 auto get(const executor_binder<T, Executor>& b,
|
||||
const Executor1& = Executor1()) noexcept
|
||||
-> decltype(b.get_executor())
|
||||
{
|
||||
return b.get_executor();
|
||||
}
|
||||
};
|
||||
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_BIND_EXECUTOR_HPP
|
||||
623
Packages/asio-1.36.0/include/asio/bind_immediate_executor.hpp
vendored
Normal file
623
Packages/asio-1.36.0/include/asio/bind_immediate_executor.hpp
vendored
Normal file
@@ -0,0 +1,623 @@
|
||||
//
|
||||
// bind_immediate_executor.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_IMMEDIATE_EXECUTOR_HPP
|
||||
#define ASIO_BIND_IMMEDIATE_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/associated_executor.hpp"
|
||||
#include "asio/associated_immediate_executor.hpp"
|
||||
#include "asio/associator.hpp"
|
||||
#include "asio/async_result.hpp"
|
||||
#include "asio/detail/initiation_base.hpp"
|
||||
#include "asio/detail/type_traits.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 immediate_executor_binder_result_type
|
||||
{
|
||||
protected:
|
||||
typedef void result_type_or_void;
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct immediate_executor_binder_result_type<T, void_t<typename T::result_type>>
|
||||
{
|
||||
typedef typename T::result_type result_type;
|
||||
protected:
|
||||
typedef result_type result_type_or_void;
|
||||
};
|
||||
|
||||
template <typename R>
|
||||
struct immediate_executor_binder_result_type<R(*)()>
|
||||
{
|
||||
typedef R result_type;
|
||||
protected:
|
||||
typedef result_type result_type_or_void;
|
||||
};
|
||||
|
||||
template <typename R>
|
||||
struct immediate_executor_binder_result_type<R(&)()>
|
||||
{
|
||||
typedef R result_type;
|
||||
protected:
|
||||
typedef result_type result_type_or_void;
|
||||
};
|
||||
|
||||
template <typename R, typename A1>
|
||||
struct immediate_executor_binder_result_type<R(*)(A1)>
|
||||
{
|
||||
typedef R result_type;
|
||||
protected:
|
||||
typedef result_type result_type_or_void;
|
||||
};
|
||||
|
||||
template <typename R, typename A1>
|
||||
struct immediate_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 immediate_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 immediate_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 immediate_executor_binder_argument_type {};
|
||||
|
||||
template <typename T>
|
||||
struct immediate_executor_binder_argument_type<T,
|
||||
void_t<typename T::argument_type>>
|
||||
{
|
||||
typedef typename T::argument_type argument_type;
|
||||
};
|
||||
|
||||
template <typename R, typename A1>
|
||||
struct immediate_executor_binder_argument_type<R(*)(A1)>
|
||||
{
|
||||
typedef A1 argument_type;
|
||||
};
|
||||
|
||||
template <typename R, typename A1>
|
||||
struct immediate_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 immediate_executor_binder_argument_types {};
|
||||
|
||||
template <typename T>
|
||||
struct immediate_executor_binder_argument_types<T,
|
||||
void_t<typename T::first_argument_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 immediate_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 immediate_executor_binder_argument_type<R(&)(A1, A2)>
|
||||
{
|
||||
typedef A1 first_argument_type;
|
||||
typedef A2 second_argument_type;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// A call wrapper type to bind a immediate executor of type @c Executor
|
||||
/// to an object of type @c T.
|
||||
template <typename T, typename Executor>
|
||||
class immediate_executor_binder
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
: public detail::immediate_executor_binder_result_type<T>,
|
||||
public detail::immediate_executor_binder_argument_type<T>,
|
||||
public detail::immediate_executor_binder_argument_types<T>
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
{
|
||||
public:
|
||||
/// The type of the target object.
|
||||
typedef T target_type;
|
||||
|
||||
/// The type of the associated immediate executor.
|
||||
typedef Executor immediate_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 a immediate 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>
|
||||
immediate_executor_binder(const immediate_executor_type& e,
|
||||
U&& u)
|
||||
: executor_(e),
|
||||
target_(static_cast<U&&>(u))
|
||||
{
|
||||
}
|
||||
|
||||
/// Copy constructor.
|
||||
immediate_executor_binder(const immediate_executor_binder& other)
|
||||
: executor_(other.get_immediate_executor()),
|
||||
target_(other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct a copy, but specify a different immediate executor.
|
||||
immediate_executor_binder(const immediate_executor_type& e,
|
||||
const immediate_executor_binder& other)
|
||||
: executor_(e),
|
||||
target_(other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct a copy of a different immediate 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>
|
||||
immediate_executor_binder(
|
||||
const immediate_executor_binder<U, OtherExecutor>& other,
|
||||
constraint_t<is_constructible<Executor, OtherExecutor>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: executor_(other.get_immediate_executor()),
|
||||
target_(other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct a copy of a different immediate executor wrapper type, but
|
||||
/// specify a different immediate executor.
|
||||
/**
|
||||
* This constructor is only valid if the type @c T is constructible from type
|
||||
* @c U.
|
||||
*/
|
||||
template <typename U, typename OtherExecutor>
|
||||
immediate_executor_binder(const immediate_executor_type& e,
|
||||
const immediate_executor_binder<U, OtherExecutor>& other,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: executor_(e),
|
||||
target_(other.get())
|
||||
{
|
||||
}
|
||||
|
||||
/// Move constructor.
|
||||
immediate_executor_binder(immediate_executor_binder&& other)
|
||||
: executor_(static_cast<immediate_executor_type&&>(
|
||||
other.get_immediate_executor())),
|
||||
target_(static_cast<T&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move construct the target object, but specify a different immediate
|
||||
/// executor.
|
||||
immediate_executor_binder(const immediate_executor_type& e,
|
||||
immediate_executor_binder&& other)
|
||||
: executor_(e),
|
||||
target_(static_cast<T&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move construct from a different immediate executor wrapper type.
|
||||
template <typename U, typename OtherExecutor>
|
||||
immediate_executor_binder(
|
||||
immediate_executor_binder<U, OtherExecutor>&& other,
|
||||
constraint_t<is_constructible<Executor, OtherExecutor>::value> = 0,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: executor_(static_cast<OtherExecutor&&>(
|
||||
other.get_immediate_executor())),
|
||||
target_(static_cast<U&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Move construct from a different immediate executor wrapper type, but
|
||||
/// specify a different immediate executor.
|
||||
template <typename U, typename OtherExecutor>
|
||||
immediate_executor_binder(const immediate_executor_type& e,
|
||||
immediate_executor_binder<U, OtherExecutor>&& other,
|
||||
constraint_t<is_constructible<T, U>::value> = 0)
|
||||
: executor_(e),
|
||||
target_(static_cast<U&&>(other.get()))
|
||||
{
|
||||
}
|
||||
|
||||
/// Destructor.
|
||||
~immediate_executor_binder()
|
||||
{
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
target_type& get() noexcept
|
||||
{
|
||||
return target_;
|
||||
}
|
||||
|
||||
/// Obtain a reference to the target object.
|
||||
const target_type& get() const noexcept
|
||||
{
|
||||
return target_;
|
||||
}
|
||||
|
||||
/// Obtain the associated immediate executor.
|
||||
immediate_executor_type get_immediate_executor() const noexcept
|
||||
{
|
||||
return executor_;
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &
|
||||
{
|
||||
return target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) &&
|
||||
{
|
||||
return static_cast<T&&>(target_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Forwarding function call operator.
|
||||
template <typename... Args>
|
||||
result_of_t<T(Args...)> operator()(Args&&... args) const&
|
||||
{
|
||||
return target_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
Executor executor_;
|
||||
T target_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to specify that
|
||||
/// the completion handler should have the supplied executor as its associated
|
||||
/// immediate executor.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Executor>
|
||||
struct partial_immediate_executor_binder
|
||||
{
|
||||
/// Constructor that specifies associated executor.
|
||||
explicit partial_immediate_executor_binder(const Executor& ex)
|
||||
: executor_(ex)
|
||||
{
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to specify that the completion handler
|
||||
/// should have the executor as its associated immediate executor.
|
||||
template <typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
constexpr immediate_executor_binder<decay_t<CompletionToken>, Executor>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return immediate_executor_binder<decay_t<CompletionToken>, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token), executor_);
|
||||
}
|
||||
|
||||
//private:
|
||||
Executor executor_;
|
||||
};
|
||||
|
||||
/// Create a partial completion token that associates an executor.
|
||||
template <typename Executor>
|
||||
ASIO_NODISCARD inline partial_immediate_executor_binder<Executor>
|
||||
bind_immediate_executor(const Executor& ex)
|
||||
{
|
||||
return partial_immediate_executor_binder<Executor>(ex);
|
||||
}
|
||||
|
||||
/// Associate an object of type @c T with a immediate executor of type
|
||||
/// @c Executor.
|
||||
template <typename Executor, typename T>
|
||||
ASIO_NODISCARD inline immediate_executor_binder<decay_t<T>, Executor>
|
||||
bind_immediate_executor(const Executor& e, T&& t)
|
||||
{
|
||||
return immediate_executor_binder<
|
||||
decay_t<T>, Executor>(
|
||||
e, static_cast<T&&>(t));
|
||||
}
|
||||
|
||||
#if !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename TargetAsyncResult, typename Executor, typename = void>
|
||||
class immediate_executor_binder_completion_handler_async_result
|
||||
{
|
||||
public:
|
||||
template <typename T>
|
||||
explicit immediate_executor_binder_completion_handler_async_result(T&)
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult, typename Executor>
|
||||
class immediate_executor_binder_completion_handler_async_result<
|
||||
TargetAsyncResult, Executor,
|
||||
void_t<
|
||||
typename TargetAsyncResult::completion_handler_type
|
||||
>>
|
||||
{
|
||||
private:
|
||||
TargetAsyncResult target_;
|
||||
|
||||
public:
|
||||
typedef immediate_executor_binder<
|
||||
typename TargetAsyncResult::completion_handler_type, Executor>
|
||||
completion_handler_type;
|
||||
|
||||
explicit immediate_executor_binder_completion_handler_async_result(
|
||||
typename TargetAsyncResult::completion_handler_type& handler)
|
||||
: target_(handler)
|
||||
{
|
||||
}
|
||||
|
||||
auto get() -> decltype(target_.get())
|
||||
{
|
||||
return target_.get();
|
||||
}
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult, typename = void>
|
||||
struct immediate_executor_binder_async_result_return_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename TargetAsyncResult>
|
||||
struct immediate_executor_binder_async_result_return_type<
|
||||
TargetAsyncResult,
|
||||
void_t<
|
||||
typename TargetAsyncResult::return_type
|
||||
>>
|
||||
{
|
||||
typedef typename TargetAsyncResult::return_type return_type;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
template <typename T, typename Executor, typename Signature>
|
||||
class async_result<immediate_executor_binder<T, Executor>, Signature> :
|
||||
public detail::immediate_executor_binder_completion_handler_async_result<
|
||||
async_result<T, Signature>, Executor>,
|
||||
public detail::immediate_executor_binder_async_result_return_type<
|
||||
async_result<T, Signature>>
|
||||
{
|
||||
public:
|
||||
explicit async_result(immediate_executor_binder<T, Executor>& b)
|
||||
: detail::immediate_executor_binder_completion_handler_async_result<
|
||||
async_result<T, Signature>, Executor>(b.get())
|
||||
{
|
||||
}
|
||||
|
||||
template <typename Initiation>
|
||||
struct init_wrapper : detail::initiation_base<Initiation>
|
||||
{
|
||||
using detail::initiation_base<Initiation>::initiation_base;
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, const Executor& e, Args&&... args) &&
|
||||
{
|
||||
static_cast<Initiation&&>(*this)(
|
||||
immediate_executor_binder<
|
||||
decay_t<Handler>, Executor>(
|
||||
e, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler,
|
||||
const Executor& e, Args&&... args) const &
|
||||
{
|
||||
static_cast<const Initiation&>(*this)(
|
||||
immediate_executor_binder<
|
||||
decay_t<Handler>, Executor>(
|
||||
e, static_cast<Handler&&>(handler)),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
declval<init_wrapper<decay_t<Initiation>>>(),
|
||||
token.get(), token.get_immediate_executor(),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<
|
||||
conditional_t<
|
||||
is_const<remove_reference_t<RawCompletionToken>>::value, const T, T>,
|
||||
Signature>(
|
||||
init_wrapper<decay_t<Initiation>>(
|
||||
static_cast<Initiation&&>(initiation)),
|
||||
token.get(), token.get_immediate_executor(),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
async_result(const async_result&) = delete;
|
||||
async_result& operator=(const async_result&) = delete;
|
||||
|
||||
async_result<T, Signature> target_;
|
||||
};
|
||||
|
||||
template <typename Executor, typename... Signatures>
|
||||
struct async_result<partial_immediate_executor_binder<Executor>, Signatures...>
|
||||
{
|
||||
template <typename Initiation, typename RawCompletionToken, typename... Args>
|
||||
static auto initiate(Initiation&& initiation,
|
||||
RawCompletionToken&& token, Args&&... args)
|
||||
-> decltype(
|
||||
async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
immediate_executor_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
Executor>(token.executor_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...))
|
||||
{
|
||||
return async_initiate<Signatures...>(
|
||||
static_cast<Initiation&&>(initiation),
|
||||
immediate_executor_binder<
|
||||
default_completion_token_t<associated_executor_t<Initiation>>,
|
||||
Executor>(token.executor_,
|
||||
default_completion_token_t<associated_executor_t<Initiation>>{}),
|
||||
static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <template <typename, typename> class Associator,
|
||||
typename T, typename Executor, typename DefaultCandidate>
|
||||
struct associator<Associator,
|
||||
immediate_executor_binder<T, Executor>,
|
||||
DefaultCandidate>
|
||||
: Associator<T, DefaultCandidate>
|
||||
{
|
||||
static typename Associator<T, DefaultCandidate>::type get(
|
||||
const immediate_executor_binder<T, Executor>& b) noexcept
|
||||
{
|
||||
return Associator<T, DefaultCandidate>::get(b.get());
|
||||
}
|
||||
|
||||
static auto get(const immediate_executor_binder<T, Executor>& b,
|
||||
const DefaultCandidate& c) noexcept
|
||||
-> decltype(Associator<T, DefaultCandidate>::get(b.get(), c))
|
||||
{
|
||||
return Associator<T, DefaultCandidate>::get(b.get(), c);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename T, typename Executor, typename Executor1>
|
||||
struct associated_immediate_executor<
|
||||
immediate_executor_binder<T, Executor>,
|
||||
Executor1>
|
||||
{
|
||||
typedef Executor type;
|
||||
|
||||
static auto get(const immediate_executor_binder<T, Executor>& b,
|
||||
const Executor1& = Executor1()) noexcept
|
||||
-> decltype(b.get_immediate_executor())
|
||||
{
|
||||
return b.get_immediate_executor();
|
||||
}
|
||||
};
|
||||
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_BIND_IMMEDIATE_EXECUTOR_HPP
|
||||
2881
Packages/asio-1.36.0/include/asio/buffer.hpp
vendored
Normal file
2881
Packages/asio-1.36.0/include/asio/buffer.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
318
Packages/asio-1.36.0/include/asio/buffer_registration.hpp
vendored
Normal file
318
Packages/asio-1.36.0/include/asio/buffer_registration.hpp
vendored
Normal file
@@ -0,0 +1,318 @@
|
||||
//
|
||||
// buffer_registration.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 <utility>
|
||||
#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)
|
||||
|
||||
#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) 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(),
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 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(),
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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_));
|
||||
}
|
||||
|
||||
/// Move constructor.
|
||||
buffer_registration(buffer_registration&& other) 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)
|
||||
}
|
||||
|
||||
/// Unregisters the buffers.
|
||||
~buffer_registration()
|
||||
{
|
||||
#if defined(ASIO_HAS_IO_URING)
|
||||
if (service_)
|
||||
service_->unregister_buffers();
|
||||
#endif // defined(ASIO_HAS_IO_URING)
|
||||
}
|
||||
|
||||
/// Move assignment.
|
||||
buffer_registration& operator=(buffer_registration&& other) 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;
|
||||
}
|
||||
|
||||
/// Get the number of registered buffers.
|
||||
std::size_t size() const noexcept
|
||||
{
|
||||
return buffers_.size();
|
||||
}
|
||||
|
||||
/// Get the begin iterator for the sequence of registered buffers.
|
||||
const_iterator begin() const noexcept
|
||||
{
|
||||
return buffers_.begin();
|
||||
}
|
||||
|
||||
/// Get the begin iterator for the sequence of registered buffers.
|
||||
const_iterator cbegin() const noexcept
|
||||
{
|
||||
return buffers_.cbegin();
|
||||
}
|
||||
|
||||
/// Get the end iterator for the sequence of registered buffers.
|
||||
const_iterator end() const noexcept
|
||||
{
|
||||
return buffers_.end();
|
||||
}
|
||||
|
||||
/// Get the end iterator for the sequence of registered buffers.
|
||||
const_iterator cend() const noexcept
|
||||
{
|
||||
return buffers_.cend();
|
||||
}
|
||||
|
||||
/// Get the buffer at the specified index.
|
||||
const mutable_registered_buffer& operator[](std::size_t i) noexcept
|
||||
{
|
||||
return buffers_[i];
|
||||
}
|
||||
|
||||
/// Get the buffer at the specified index.
|
||||
const mutable_registered_buffer& at(std::size_t i) noexcept
|
||||
{
|
||||
return buffers_.at(i);
|
||||
}
|
||||
|
||||
private:
|
||||
// Disallow copying and assignment.
|
||||
buffer_registration(const buffer_registration&) = delete;
|
||||
buffer_registration& operator=(const buffer_registration&) = delete;
|
||||
|
||||
// Helper function to get an executor's context.
|
||||
template <typename T>
|
||||
static execution_context& get_context(const T& t,
|
||||
enable_if_t<execution::is_executor<T>::value>* = 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,
|
||||
enable_if_t<!execution::is_executor<T>::value>* = 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)
|
||||
};
|
||||
|
||||
/// 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,
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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,
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
{
|
||||
return buffer_registration<MutableBufferSequence, Allocator>(
|
||||
ctx, buffer_sequence, alloc);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_BUFFER_REGISTRATION_HPP
|
||||
273
Packages/asio-1.36.0/include/asio/buffered_read_stream.hpp
vendored
Normal file
273
Packages/asio-1.36.0/include/asio/buffered_read_stream.hpp
vendored
Normal file
@@ -0,0 +1,273 @@
|
||||
//
|
||||
// buffered_read_stream.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 remove_reference_t<Stream> 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_(static_cast<Arg&&>(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_(static_cast<Arg&&>(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() 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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some(const ConstBufferSequence& buffers,
|
||||
WriteHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
declval<conditional_t<true, Stream&, WriteHandler>>().async_write_some(
|
||||
buffers, static_cast<WriteHandler&&>(handler)))
|
||||
{
|
||||
return next_layer_.async_write_some(buffers,
|
||||
static_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 = default_completion_token_t<executor_type>>
|
||||
auto async_fill(
|
||||
ReadHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some(const MutableBufferSequence& buffers,
|
||||
ReadHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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
Packages/asio-1.36.0/include/asio/buffered_read_stream_fwd.hpp
vendored
Normal file
25
Packages/asio-1.36.0/include/asio/buffered_read_stream_fwd.hpp
vendored
Normal file
@@ -0,0 +1,25 @@
|
||||
//
|
||||
// buffered_read_stream_fwd.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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
|
||||
292
Packages/asio-1.36.0/include/asio/buffered_stream.hpp
vendored
Normal file
292
Packages/asio-1.36.0/include/asio/buffered_stream.hpp
vendored
Normal file
@@ -0,0 +1,292 @@
|
||||
//
|
||||
// buffered_stream.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 remove_reference_t<Stream> 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_(static_cast<Arg&&>(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_(static_cast<Arg&&>(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() 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 = default_completion_token_t<executor_type>>
|
||||
auto async_flush(
|
||||
WriteHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
declval<buffered_write_stream<Stream>&>().async_flush(
|
||||
static_cast<WriteHandler&&>(handler)))
|
||||
{
|
||||
return stream_impl_.next_layer().async_flush(
|
||||
static_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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some(const ConstBufferSequence& buffers,
|
||||
WriteHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
declval<Stream&>().async_write_some(buffers,
|
||||
static_cast<WriteHandler&&>(handler)))
|
||||
{
|
||||
return stream_impl_.async_write_some(buffers,
|
||||
static_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 = default_completion_token_t<executor_type>>
|
||||
auto async_fill(
|
||||
ReadHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
declval<buffered_read_stream<
|
||||
buffered_write_stream<Stream>>&>().async_fill(
|
||||
static_cast<ReadHandler&&>(handler)))
|
||||
{
|
||||
return stream_impl_.async_fill(static_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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some(const MutableBufferSequence& buffers,
|
||||
ReadHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
declval<Stream&>().async_read_some(buffers,
|
||||
static_cast<ReadHandler&&>(handler)))
|
||||
{
|
||||
return stream_impl_.async_read_some(buffers,
|
||||
static_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
Packages/asio-1.36.0/include/asio/buffered_stream_fwd.hpp
vendored
Normal file
25
Packages/asio-1.36.0/include/asio/buffered_stream_fwd.hpp
vendored
Normal file
@@ -0,0 +1,25 @@
|
||||
//
|
||||
// buffered_stream_fwd.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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
|
||||
265
Packages/asio-1.36.0/include/asio/buffered_write_stream.hpp
vendored
Normal file
265
Packages/asio-1.36.0/include/asio/buffered_write_stream.hpp
vendored
Normal file
@@ -0,0 +1,265 @@
|
||||
//
|
||||
// buffered_write_stream.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 remove_reference_t<Stream> 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_(static_cast<Arg&&>(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_(static_cast<Arg&&>(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() 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 = default_completion_token_t<executor_type>>
|
||||
auto async_flush(
|
||||
WriteHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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 = default_completion_token_t<executor_type>>
|
||||
auto async_write_some(const ConstBufferSequence& buffers,
|
||||
WriteHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
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 = default_completion_token_t<executor_type>>
|
||||
auto async_read_some(const MutableBufferSequence& buffers,
|
||||
ReadHandler&& handler = default_completion_token_t<executor_type>())
|
||||
-> decltype(
|
||||
declval<conditional_t<true, Stream&, ReadHandler>>().async_read_some(
|
||||
buffers, static_cast<ReadHandler&&>(handler)))
|
||||
{
|
||||
return next_layer_.async_read_some(buffers,
|
||||
static_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
Packages/asio-1.36.0/include/asio/buffered_write_stream_fwd.hpp
vendored
Normal file
25
Packages/asio-1.36.0/include/asio/buffered_write_stream_fwd.hpp
vendored
Normal file
@@ -0,0 +1,25 @@
|
||||
//
|
||||
// buffered_write_stream_fwd.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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
|
||||
501
Packages/asio-1.36.0/include/asio/buffers_iterator.hpp
vendored
Normal file
501
Packages/asio-1.36.0/include/asio/buffers_iterator.hpp
vendored
Normal file
@@ -0,0 +1,501 @@
|
||||
//
|
||||
// buffers_iterator.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 add_const_t<ByteType> 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 add_const_t<ByteType> byte_type;
|
||||
typedef const const_buffer* const_iterator;
|
||||
};
|
||||
} // namespace detail
|
||||
|
||||
/// 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
|
||||
301
Packages/asio-1.36.0/include/asio/cancel_after.hpp
vendored
Normal file
301
Packages/asio-1.36.0/include/asio/cancel_after.hpp
vendored
Normal file
@@ -0,0 +1,301 @@
|
||||
//
|
||||
// cancel_after.hpp
|
||||
// ~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_CANCEL_AFTER_HPP
|
||||
#define ASIO_CANCEL_AFTER_HPP
|
||||
|
||||
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||
# pragma once
|
||||
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||
|
||||
#include "asio/detail/config.hpp"
|
||||
#include "asio/basic_waitable_timer.hpp"
|
||||
#include "asio/cancellation_type.hpp"
|
||||
#include "asio/detail/chrono.hpp"
|
||||
#include "asio/detail/type_traits.hpp"
|
||||
#include "asio/wait_traits.hpp"
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
/// A @ref completion_token adapter that cancels an operation after a timeout.
|
||||
/**
|
||||
* The cancel_after_t class is used to indicate that an asynchronous operation
|
||||
* should be cancelled if not complete before the specified duration has
|
||||
* elapsed.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock,
|
||||
typename WaitTraits = asio::wait_traits<Clock>>
|
||||
class cancel_after_t
|
||||
{
|
||||
public:
|
||||
/// Constructor.
|
||||
template <typename T>
|
||||
cancel_after_t(T&& completion_token, const typename Clock::duration& timeout,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: token_(static_cast<T&&>(completion_token)),
|
||||
timeout_(timeout),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
//private:
|
||||
CompletionToken token_;
|
||||
typename Clock::duration timeout_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// A @ref completion_token adapter that cancels an operation after a timeout.
|
||||
/**
|
||||
* The cancel_after_timer class is used to indicate that an asynchronous
|
||||
* operation should be cancelled if not complete before the specified duration
|
||||
* has elapsed.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock,
|
||||
typename WaitTraits = asio::wait_traits<Clock>,
|
||||
typename Executor = any_io_executor>
|
||||
class cancel_after_timer
|
||||
{
|
||||
public:
|
||||
/// Constructor.
|
||||
template <typename T>
|
||||
cancel_after_timer(T&& completion_token,
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const typename Clock::duration& timeout,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: token_(static_cast<T&&>(completion_token)),
|
||||
timer_(timer),
|
||||
timeout_(timeout),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
//private:
|
||||
CompletionToken token_;
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer_;
|
||||
typename Clock::duration timeout_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to cancel an
|
||||
/// operation after a timeout.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits = asio::wait_traits<Clock>>
|
||||
class partial_cancel_after
|
||||
{
|
||||
public:
|
||||
/// Constructor that specifies the timeout duration and cancellation type.
|
||||
explicit partial_cancel_after(const typename Clock::duration& timeout,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: timeout_(timeout),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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
|
||||
cancel_after_t<decay_t<CompletionToken>, Clock, WaitTraits>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return cancel_after_t<decay_t<CompletionToken>, Clock, WaitTraits>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timeout_, cancel_type_);
|
||||
}
|
||||
|
||||
//private:
|
||||
typename Clock::duration timeout_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to cancel an
|
||||
/// operation after a timeout.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits = asio::wait_traits<Clock>,
|
||||
typename Executor = any_io_executor>
|
||||
class partial_cancel_after_timer
|
||||
{
|
||||
public:
|
||||
/// Constructor that specifies the timeout duration and cancellation type.
|
||||
explicit partial_cancel_after_timer(
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const typename Clock::duration& timeout,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: timer_(timer),
|
||||
timeout_(timeout),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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
|
||||
cancel_after_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return cancel_after_timer<decay_t<CompletionToken>,
|
||||
Clock, WaitTraits, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timeout_, cancel_type_);
|
||||
}
|
||||
|
||||
//private:
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer_;
|
||||
typename Clock::duration timeout_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// Create a partial completion token adapter that cancels an operation if not
|
||||
/// complete before the specified relative timeout has elapsed.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_after, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Rep, typename Period>
|
||||
ASIO_NODISCARD inline partial_cancel_after<chrono::steady_clock>
|
||||
cancel_after(const chrono::duration<Rep, Period>& timeout,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
{
|
||||
return partial_cancel_after<chrono::steady_clock>(timeout, cancel_type);
|
||||
}
|
||||
|
||||
/// Create a partial completion token adapter that cancels an operation if not
|
||||
/// complete before the specified relative timeout has elapsed.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_after, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits,
|
||||
typename Executor, typename Rep, typename Period>
|
||||
ASIO_NODISCARD inline
|
||||
partial_cancel_after_timer<Clock, WaitTraits, Executor>
|
||||
cancel_after(basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const chrono::duration<Rep, Period>& timeout,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
{
|
||||
return partial_cancel_after_timer<Clock, WaitTraits, Executor>(
|
||||
timer, timeout, cancel_type);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete before
|
||||
/// the specified relative timeout has elapsed.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_after, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Rep, typename Period, typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
cancel_after_t<decay_t<CompletionToken>, chrono::steady_clock>
|
||||
cancel_after(const chrono::duration<Rep, Period>& timeout,
|
||||
CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_after_t<decay_t<CompletionToken>, chrono::steady_clock>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timeout, cancellation_type::terminal);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete before
|
||||
/// the specified relative timeout has elapsed.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_after, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Rep, typename Period, typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
cancel_after_t<decay_t<CompletionToken>, chrono::steady_clock>
|
||||
cancel_after(const chrono::duration<Rep, Period>& timeout,
|
||||
cancellation_type_t cancel_type, CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_after_t<decay_t<CompletionToken>, chrono::steady_clock>(
|
||||
static_cast<CompletionToken&&>(completion_token), timeout, cancel_type);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete before
|
||||
/// the specified relative timeout has elapsed.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_after, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits, typename Executor,
|
||||
typename Rep, typename Period, typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
cancel_after_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>
|
||||
cancel_after(basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const chrono::duration<Rep, Period>& timeout,
|
||||
CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_after_timer<decay_t<CompletionToken>,
|
||||
Clock, WaitTraits, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timer, timeout, cancellation_type::terminal);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete before
|
||||
/// the specified relative timeout has elapsed.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_after, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits, typename Executor,
|
||||
typename Rep, typename Period, typename CompletionToken>
|
||||
ASIO_NODISCARD inline
|
||||
cancel_after_timer<decay_t<CompletionToken>, chrono::steady_clock>
|
||||
cancel_after(basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const chrono::duration<Rep, Period>& timeout,
|
||||
cancellation_type_t cancel_type, CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_after_timer<decay_t<CompletionToken>,
|
||||
Clock, WaitTraits, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timer, timeout, cancel_type);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/cancel_after.hpp"
|
||||
|
||||
#endif // ASIO_CANCEL_AFTER_HPP
|
||||
294
Packages/asio-1.36.0/include/asio/cancel_at.hpp
vendored
Normal file
294
Packages/asio-1.36.0/include/asio/cancel_at.hpp
vendored
Normal file
@@ -0,0 +1,294 @@
|
||||
//
|
||||
// cancel_at.hpp
|
||||
// ~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_CANCEL_AT_HPP
|
||||
#define ASIO_CANCEL_AT_HPP
|
||||
|
||||
#if defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||
# pragma once
|
||||
#endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
|
||||
|
||||
#include "asio/detail/config.hpp"
|
||||
#include "asio/basic_waitable_timer.hpp"
|
||||
#include "asio/cancellation_type.hpp"
|
||||
#include "asio/detail/chrono.hpp"
|
||||
#include "asio/detail/type_traits.hpp"
|
||||
#include "asio/wait_traits.hpp"
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
/// A @ref completion_token adapter that cancels an operation at a given time.
|
||||
/**
|
||||
* The cancel_at_t class is used to indicate that an asynchronous operation
|
||||
* should be cancelled if not complete at the specified absolute time.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock,
|
||||
typename WaitTraits = asio::wait_traits<Clock>>
|
||||
class cancel_at_t
|
||||
{
|
||||
public:
|
||||
/// Constructor.
|
||||
template <typename T>
|
||||
cancel_at_t(T&& completion_token, const typename Clock::time_point& expiry,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: token_(static_cast<T&&>(completion_token)),
|
||||
expiry_(expiry),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
//private:
|
||||
CompletionToken token_;
|
||||
typename Clock::time_point expiry_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// A @ref completion_token adapter that cancels an operation at a given time.
|
||||
/**
|
||||
* The cancel_at_timer class is used to indicate that an asynchronous operation
|
||||
* should be cancelled if not complete at the specified absolute time.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock,
|
||||
typename WaitTraits = asio::wait_traits<Clock>,
|
||||
typename Executor = any_io_executor>
|
||||
class cancel_at_timer
|
||||
{
|
||||
public:
|
||||
/// Constructor.
|
||||
template <typename T>
|
||||
cancel_at_timer(T&& completion_token,
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const typename Clock::time_point& expiry,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: token_(static_cast<T&&>(completion_token)),
|
||||
timer_(timer),
|
||||
expiry_(expiry),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
//private:
|
||||
CompletionToken token_;
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer_;
|
||||
typename Clock::time_point expiry_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to cancel an
|
||||
/// operation at a given time.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits = asio::wait_traits<Clock>>
|
||||
class partial_cancel_at
|
||||
{
|
||||
public:
|
||||
/// Constructor that specifies the expiry and cancellation type.
|
||||
explicit partial_cancel_at(const typename Clock::time_point& expiry,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: expiry_(expiry),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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
|
||||
constexpr cancel_at_t<decay_t<CompletionToken>, Clock, WaitTraits>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return cancel_at_t<decay_t<CompletionToken>, Clock, WaitTraits>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
expiry_, cancel_type_);
|
||||
}
|
||||
|
||||
//private:
|
||||
typename Clock::time_point expiry_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// A function object type that adapts a @ref completion_token to cancel an
|
||||
/// operation at a given time.
|
||||
/**
|
||||
* May also be used directly as a completion token, in which case it adapts the
|
||||
* asynchronous operation's default completion token (or asio::deferred
|
||||
* if no default is available).
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits = asio::wait_traits<Clock>,
|
||||
typename Executor = any_io_executor>
|
||||
class partial_cancel_at_timer
|
||||
{
|
||||
public:
|
||||
/// Constructor that specifies the expiry and cancellation type.
|
||||
explicit partial_cancel_at_timer(
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const typename Clock::time_point& expiry,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
: timer_(timer),
|
||||
expiry_(expiry),
|
||||
cancel_type_(cancel_type)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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
|
||||
cancel_at_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>
|
||||
operator()(CompletionToken&& completion_token) const
|
||||
{
|
||||
return cancel_at_timer<decay_t<CompletionToken>,
|
||||
Clock, WaitTraits, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timer_, expiry_, cancel_type_);
|
||||
}
|
||||
|
||||
//private:
|
||||
basic_waitable_timer<Clock, WaitTraits, Executor>& timer_;
|
||||
typename Clock::time_point expiry_;
|
||||
cancellation_type_t cancel_type_;
|
||||
};
|
||||
|
||||
/// Create a partial completion token adapter that cancels an operation if not
|
||||
/// complete by the specified absolute time.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_at, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Clock, typename Duration>
|
||||
ASIO_NODISCARD inline partial_cancel_at<Clock>
|
||||
cancel_at(const chrono::time_point<Clock, Duration>& expiry,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
{
|
||||
return partial_cancel_at<Clock>(expiry, cancel_type);
|
||||
}
|
||||
|
||||
/// Create a partial completion token adapter that cancels an operation if not
|
||||
/// complete by the specified absolute time.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_at, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename Clock, typename WaitTraits,
|
||||
typename Executor, typename Duration>
|
||||
ASIO_NODISCARD inline partial_cancel_at_timer<Clock, WaitTraits, Executor>
|
||||
cancel_at(basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const chrono::time_point<Clock, Duration>& expiry,
|
||||
cancellation_type_t cancel_type = cancellation_type::terminal)
|
||||
{
|
||||
return partial_cancel_at_timer<Clock, WaitTraits, Executor>(
|
||||
timer, expiry, cancel_type);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete by the
|
||||
/// specified absolute time.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_at, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock, typename Duration>
|
||||
ASIO_NODISCARD inline cancel_at_t<decay_t<CompletionToken>, Clock>
|
||||
cancel_at(const chrono::time_point<Clock, Duration>& expiry,
|
||||
CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_at_t<decay_t<CompletionToken>, Clock>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
expiry, cancellation_type::terminal);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete by the
|
||||
/// specified absolute time.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_at, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock, typename Duration>
|
||||
ASIO_NODISCARD inline cancel_at_t<decay_t<CompletionToken>, Clock>
|
||||
cancel_at(const chrono::time_point<Clock, Duration>& expiry,
|
||||
cancellation_type_t cancel_type, CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_at_t<decay_t<CompletionToken>, Clock>(
|
||||
static_cast<CompletionToken&&>(completion_token), expiry, cancel_type);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete by the
|
||||
/// specified absolute time.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_at, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock,
|
||||
typename WaitTraits, typename Executor, typename Duration>
|
||||
ASIO_NODISCARD inline
|
||||
cancel_at_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>
|
||||
cancel_at(basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const chrono::time_point<Clock, Duration>& expiry,
|
||||
CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_at_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timer, expiry, cancellation_type::terminal);
|
||||
}
|
||||
|
||||
/// Adapt a @ref completion_token to cancel an operation if not complete by the
|
||||
/// specified absolute time.
|
||||
/**
|
||||
* @par Thread Safety
|
||||
* When an asynchronous operation is used with cancel_at, a timer async_wait
|
||||
* operation is performed in parallel to the main operation. If this parallel
|
||||
* async_wait completes first, a cancellation request is emitted to cancel the
|
||||
* main operation. Consequently, the application must ensure that the
|
||||
* asynchronous operation is performed within an implicit or explicit strand.
|
||||
*/
|
||||
template <typename CompletionToken, typename Clock,
|
||||
typename WaitTraits, typename Executor, typename Duration>
|
||||
ASIO_NODISCARD inline
|
||||
cancel_at_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>
|
||||
cancel_at(basic_waitable_timer<Clock, WaitTraits, Executor>& timer,
|
||||
const chrono::time_point<Clock, Duration>& expiry,
|
||||
cancellation_type_t cancel_type, CompletionToken&& completion_token)
|
||||
{
|
||||
return cancel_at_timer<decay_t<CompletionToken>, Clock, WaitTraits, Executor>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
timer, expiry, cancel_type);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/cancel_at.hpp"
|
||||
|
||||
#endif // ASIO_CANCEL_AT_HPP
|
||||
245
Packages/asio-1.36.0/include/asio/cancellation_signal.hpp
vendored
Normal file
245
Packages/asio-1.36.0/include/asio/cancellation_signal.hpp
vendored
Normal file
@@ -0,0 +1,245 @@
|
||||
//
|
||||
// cancellation_signal.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/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() noexcept = 0;
|
||||
|
||||
protected:
|
||||
~cancellation_handler_base() {}
|
||||
};
|
||||
|
||||
template <typename Handler>
|
||||
class cancellation_handler
|
||||
: public cancellation_handler_base
|
||||
{
|
||||
public:
|
||||
template <typename... Args>
|
||||
cancellation_handler(std::size_t size, Args&&... args)
|
||||
: handler_(static_cast<Args&&>(args)...),
|
||||
size_(size)
|
||||
{
|
||||
}
|
||||
|
||||
void call(cancellation_type_t type)
|
||||
{
|
||||
handler_(type);
|
||||
}
|
||||
|
||||
std::pair<void*, std::size_t> destroy() noexcept
|
||||
{
|
||||
std::pair<void*, std::size_t> mem(this, size_);
|
||||
this->cancellation_handler::~cancellation_handler();
|
||||
return mem;
|
||||
}
|
||||
|
||||
Handler& handler() 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:
|
||||
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() noexcept;
|
||||
|
||||
private:
|
||||
cancellation_signal(const cancellation_signal&) = delete;
|
||||
cancellation_signal& operator=(const cancellation_signal&) = delete;
|
||||
|
||||
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.
|
||||
constexpr cancellation_slot()
|
||||
: handler_(0)
|
||||
{
|
||||
}
|
||||
|
||||
/// 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(Args&&... args)
|
||||
{
|
||||
typedef detail::cancellation_handler<CancellationHandler>
|
||||
cancellation_handler_type;
|
||||
auto_delete_helper del = { prepare_memory(
|
||||
sizeof(cancellation_handler_type),
|
||||
alignof(CancellationHandler)) };
|
||||
cancellation_handler_type* handler_obj =
|
||||
new (del.mem.first) cancellation_handler_type(
|
||||
del.mem.second, static_cast<Args&&>(args)...);
|
||||
del.mem.first = 0;
|
||||
*handler_ = handler_obj;
|
||||
return handler_obj->handler();
|
||||
}
|
||||
|
||||
/// 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>
|
||||
decay_t<CancellationHandler>& assign(CancellationHandler&& handler)
|
||||
{
|
||||
return this->emplace<decay_t<CancellationHandler>>(
|
||||
static_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.
|
||||
constexpr bool is_connected() const noexcept
|
||||
{
|
||||
return handler_ != 0;
|
||||
}
|
||||
|
||||
/// Returns whether the slot is connected and has an installed handler.
|
||||
constexpr bool has_handler() const noexcept
|
||||
{
|
||||
return handler_ != 0 && *handler_ != 0;
|
||||
}
|
||||
|
||||
/// Compare two slots for equality.
|
||||
friend constexpr bool operator==(const cancellation_slot& lhs,
|
||||
const cancellation_slot& rhs) noexcept
|
||||
{
|
||||
return lhs.handler_ == rhs.handler_;
|
||||
}
|
||||
|
||||
/// Compare two slots for inequality.
|
||||
friend constexpr bool operator!=(const cancellation_slot& lhs,
|
||||
const cancellation_slot& rhs) noexcept
|
||||
{
|
||||
return lhs.handler_ != rhs.handler_;
|
||||
}
|
||||
|
||||
private:
|
||||
friend class cancellation_signal;
|
||||
|
||||
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() 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
Packages/asio-1.36.0/include/asio/cancellation_state.hpp
vendored
Normal file
235
Packages/asio-1.36.0/include/asio/cancellation_state.hpp
vendored
Normal file
@@ -0,0 +1,235 @@
|
||||
//
|
||||
// cancellation_state.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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 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.
|
||||
constexpr cancellation_state() 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>
|
||||
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>
|
||||
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>
|
||||
constexpr cancellation_state(CancellationSlot slot,
|
||||
InFilter in_filter, OutFilter out_filter)
|
||||
: impl_(slot.is_connected()
|
||||
? &slot.template emplace<impl<InFilter, OutFilter>>(
|
||||
static_cast<InFilter&&>(in_filter),
|
||||
static_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.
|
||||
*/
|
||||
constexpr cancellation_slot slot() const noexcept
|
||||
{
|
||||
return impl_ ? impl_->signal_.slot() : cancellation_slot();
|
||||
}
|
||||
|
||||
/// Returns the cancellation types that have been triggered.
|
||||
cancellation_type_t cancelled() const 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)
|
||||
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_(static_cast<InFilter&&>(in_filter)),
|
||||
out_filter_(static_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
|
||||
157
Packages/asio-1.36.0/include/asio/cancellation_type.hpp
vendored
Normal file
157
Packages/asio-1.36.0/include/asio/cancellation_type.hpp
vendored
Normal file
@@ -0,0 +1,157 @@
|
||||
//
|
||||
// cancellation_type.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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;
|
||||
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
enum class cancellation_type : unsigned int
|
||||
{
|
||||
none = 0,
|
||||
terminal = 1,
|
||||
partial = 2,
|
||||
total = 4,
|
||||
all = 0xFFFFFFFF
|
||||
};
|
||||
|
||||
typedef cancellation_type cancellation_type_t;
|
||||
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Negation operator.
|
||||
/**
|
||||
* @relates cancellation_type
|
||||
*/
|
||||
inline constexpr bool operator!(cancellation_type_t x)
|
||||
{
|
||||
return static_cast<unsigned int>(x) == 0;
|
||||
}
|
||||
|
||||
/// Bitwise and operator.
|
||||
/**
|
||||
* @relates cancellation_type
|
||||
*/
|
||||
inline 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 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 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 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
|
||||
1319
Packages/asio-1.36.0/include/asio/co_composed.hpp
vendored
Normal file
1319
Packages/asio-1.36.0/include/asio/co_composed.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
523
Packages/asio-1.36.0/include/asio/co_spawn.hpp
vendored
Normal file
523
Packages/asio-1.36.0/include/asio/co_spawn.hpp
vendored
Normal file
@@ -0,0 +1,523 @@
|
||||
//
|
||||
// co_spawn.hpp
|
||||
// ~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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),
|
||||
constraint_t<
|
||||
(is_executor<Executor>::value || execution::is_executor<Executor>::value)
|
||||
&& is_convertible<Executor, AwaitableExecutor>::value
|
||||
> = 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),
|
||||
constraint_t<
|
||||
(is_executor<Executor>::value || execution::is_executor<Executor>::value)
|
||||
&& is_convertible<Executor, AwaitableExecutor>::value
|
||||
> = 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),
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
&& is_convertible<typename ExecutionContext::executor_type,
|
||||
AwaitableExecutor>::value
|
||||
> = 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),
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
&& is_convertible<typename ExecutionContext::executor_type,
|
||||
AwaitableExecutor>::value
|
||||
> = 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<
|
||||
result_of_t<F()>>::type) CompletionToken
|
||||
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(Executor)>
|
||||
ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken,
|
||||
typename detail::awaitable_signature<result_of_t<F()>>::type)
|
||||
co_spawn(const Executor& ex, F&& f,
|
||||
CompletionToken&& token
|
||||
ASIO_DEFAULT_COMPLETION_TOKEN(Executor),
|
||||
constraint_t<
|
||||
is_executor<Executor>::value || execution::is_executor<Executor>::value
|
||||
> = 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<
|
||||
result_of_t<F()>>::type) CompletionToken
|
||||
ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(
|
||||
typename ExecutionContext::executor_type)>
|
||||
ASIO_INITFN_AUTO_RESULT_TYPE(CompletionToken,
|
||||
typename detail::awaitable_signature<result_of_t<F()>>::type)
|
||||
co_spawn(ExecutionContext& ctx, F&& f,
|
||||
CompletionToken&& token
|
||||
ASIO_DEFAULT_COMPLETION_TOKEN(
|
||||
typename ExecutionContext::executor_type),
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 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
|
||||
267
Packages/asio-1.36.0/include/asio/completion_condition.hpp
vendored
Normal file
267
Packages/asio-1.36.0/include/asio/completion_condition.hpp
vendored
Normal file
@@ -0,0 +1,267 @@
|
||||
//
|
||||
// completion_condition.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/type_traits.hpp"
|
||||
#include "asio/error_code.hpp"
|
||||
|
||||
#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_;
|
||||
};
|
||||
|
||||
template <typename T, typename = void>
|
||||
struct is_completion_condition_helper : false_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct is_completion_condition_helper<T,
|
||||
enable_if_t<
|
||||
is_same<
|
||||
result_of_t<T(asio::error_code, std::size_t)>,
|
||||
bool
|
||||
>::value
|
||||
>
|
||||
> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct is_completion_condition_helper<T,
|
||||
enable_if_t<
|
||||
is_same<
|
||||
result_of_t<T(asio::error_code, std::size_t)>,
|
||||
std::size_t
|
||||
>::value
|
||||
>
|
||||
> : true_type
|
||||
{
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Trait for determining whether a function object is a completion condition.
|
||||
template <typename T>
|
||||
struct is_completion_condition
|
||||
{
|
||||
static constexpr bool value = automatically_determined;
|
||||
};
|
||||
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
template <typename T>
|
||||
struct is_completion_condition : detail::is_completion_condition_helper<T>
|
||||
{
|
||||
};
|
||||
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/**
|
||||
* @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
|
||||
128
Packages/asio-1.36.0/include/asio/compose.hpp
vendored
Normal file
128
Packages/asio-1.36.0/include/asio/compose.hpp
vendored
Normal file
@@ -0,0 +1,128 @@
|
||||
//
|
||||
// compose.hpp
|
||||
// ~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/composed.hpp"
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
/// 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 Per-Operation Cancellation
|
||||
* By default, terminal per-operation cancellation is enabled for
|
||||
* composed operations that are implemented using @c async_compose. To
|
||||
* disable cancellation for the composed operation, or to alter its
|
||||
* supported cancellation types, call the @c self object's @c
|
||||
* reset_cancellation_state function.
|
||||
*
|
||||
* @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>
|
||||
inline auto async_compose(Implementation&& implementation,
|
||||
type_identity_t<CompletionToken>& token,
|
||||
IoObjectsOrExecutors&&... io_objects_or_executors)
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signature>(
|
||||
composed<Signature>(static_cast<Implementation&&>(implementation),
|
||||
static_cast<IoObjectsOrExecutors&&>(io_objects_or_executors)...),
|
||||
token))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signature>(
|
||||
composed<Signature>(static_cast<Implementation&&>(implementation),
|
||||
static_cast<IoObjectsOrExecutors&&>(io_objects_or_executors)...),
|
||||
token);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_COMPOSE_HPP
|
||||
413
Packages/asio-1.36.0/include/asio/composed.hpp
vendored
Normal file
413
Packages/asio-1.36.0/include/asio/composed.hpp
vendored
Normal file
@@ -0,0 +1,413 @@
|
||||
//
|
||||
// composed.hpp
|
||||
// ~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_COMPOSED_HPP
|
||||
#define ASIO_COMPOSED_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_cont_helpers.hpp"
|
||||
#include "asio/detail/type_traits.hpp"
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
namespace detail {
|
||||
|
||||
template <typename Impl, typename Work,
|
||||
typename Handler, typename... Signatures>
|
||||
class composed_op;
|
||||
|
||||
template <typename Impl, typename Work, typename Handler>
|
||||
class composed_op<Impl, Work, Handler>
|
||||
: public base_from_cancellation_state<Handler>
|
||||
{
|
||||
public:
|
||||
template <typename I, typename W, typename H>
|
||||
composed_op(I&& impl,
|
||||
W&& work,
|
||||
H&& handler)
|
||||
: base_from_cancellation_state<Handler>(
|
||||
handler, enable_terminal_cancellation()),
|
||||
impl_(static_cast<I&&>(impl)),
|
||||
work_(static_cast<W&&>(work)),
|
||||
handler_(static_cast<H&&>(handler)),
|
||||
invocations_(0)
|
||||
{
|
||||
}
|
||||
|
||||
composed_op(composed_op&& other)
|
||||
: base_from_cancellation_state<Handler>(
|
||||
static_cast<base_from_cancellation_state<Handler>&&>(other)),
|
||||
impl_(static_cast<Impl&&>(other.impl_)),
|
||||
work_(static_cast<Work&&>(other.work_)),
|
||||
handler_(static_cast<Handler&&>(other.handler_)),
|
||||
invocations_(other.invocations_)
|
||||
{
|
||||
}
|
||||
|
||||
typedef typename composed_work_guard<
|
||||
typename Work::head_type>::executor_type io_executor_type;
|
||||
|
||||
io_executor_type get_io_executor() const noexcept
|
||||
{
|
||||
return work_.head_.get_executor();
|
||||
}
|
||||
|
||||
typedef associated_executor_t<Handler, io_executor_type> executor_type;
|
||||
|
||||
executor_type get_executor() const noexcept
|
||||
{
|
||||
return (get_associated_executor)(handler_, work_.head_.get_executor());
|
||||
}
|
||||
|
||||
typedef associated_allocator_t<Handler, std::allocator<void>> allocator_type;
|
||||
|
||||
allocator_type get_allocator() const noexcept
|
||||
{
|
||||
return (get_associated_allocator)(handler_, std::allocator<void>());
|
||||
}
|
||||
|
||||
template <typename... T>
|
||||
void operator()(T&&... t)
|
||||
{
|
||||
if (invocations_ < ~0u)
|
||||
++invocations_;
|
||||
this->get_cancellation_state().slot().clear();
|
||||
impl_(*this, static_cast<T&&>(t)...);
|
||||
}
|
||||
|
||||
template <typename... Args>
|
||||
auto complete(Args&&... args)
|
||||
-> decltype(declval<Handler>()(static_cast<Args&&>(args)...))
|
||||
{
|
||||
return static_cast<Handler&&>(this->handler_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
void reset_cancellation_state()
|
||||
{
|
||||
base_from_cancellation_state<Handler>::reset_cancellation_state(handler_);
|
||||
}
|
||||
|
||||
template <typename Filter>
|
||||
void reset_cancellation_state(Filter&& filter)
|
||||
{
|
||||
base_from_cancellation_state<Handler>::reset_cancellation_state(handler_,
|
||||
static_cast<Filter&&>(filter));
|
||||
}
|
||||
|
||||
template <typename InFilter, typename OutFilter>
|
||||
void reset_cancellation_state(InFilter&& in_filter,
|
||||
OutFilter&& out_filter)
|
||||
{
|
||||
base_from_cancellation_state<Handler>::reset_cancellation_state(handler_,
|
||||
static_cast<InFilter&&>(in_filter),
|
||||
static_cast<OutFilter&&>(out_filter));
|
||||
}
|
||||
|
||||
cancellation_type_t cancelled() const 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 R, typename... Args>
|
||||
class composed_op<Impl, Work, Handler, R(Args...)>
|
||||
: public composed_op<Impl, Work, Handler>
|
||||
{
|
||||
public:
|
||||
using composed_op<Impl, Work, Handler>::composed_op;
|
||||
|
||||
template <typename... T>
|
||||
void operator()(T&&... t)
|
||||
{
|
||||
if (this->invocations_ < ~0u)
|
||||
++this->invocations_;
|
||||
this->get_cancellation_state().slot().clear();
|
||||
this->impl_(*this, static_cast<T&&>(t)...);
|
||||
}
|
||||
|
||||
void complete(Args... args)
|
||||
{
|
||||
this->work_.reset();
|
||||
static_cast<Handler&&>(this->handler_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename Impl, typename Work, typename Handler,
|
||||
typename R, typename... Args, typename... Signatures>
|
||||
class composed_op<Impl, Work, Handler, R(Args...), Signatures...>
|
||||
: public composed_op<Impl, Work, Handler, Signatures...>
|
||||
{
|
||||
public:
|
||||
using composed_op<Impl, Work, Handler, Signatures...>::composed_op;
|
||||
|
||||
template <typename... T>
|
||||
void operator()(T&&... t)
|
||||
{
|
||||
if (this->invocations_ < ~0u)
|
||||
++this->invocations_;
|
||||
this->get_cancellation_state().slot().clear();
|
||||
this->impl_(*this, static_cast<T&&>(t)...);
|
||||
}
|
||||
|
||||
using composed_op<Impl, Work, Handler, Signatures...>::complete;
|
||||
|
||||
void complete(Args... args)
|
||||
{
|
||||
this->work_.reset();
|
||||
static_cast<Handler&&>(this->handler_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
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 Implementation, typename Executors, typename... Signatures>
|
||||
class initiate_composed
|
||||
{
|
||||
public:
|
||||
typedef typename composed_io_executors<Executors>::head_type executor_type;
|
||||
|
||||
template <typename I>
|
||||
initiate_composed(I&& impl, composed_io_executors<Executors>&& executors)
|
||||
: implementation_(std::forward<I>(impl)),
|
||||
executors_(std::move(executors))
|
||||
{
|
||||
}
|
||||
|
||||
executor_type get_executor() const noexcept
|
||||
{
|
||||
return executors_.head_;
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, Args&&... args) const &
|
||||
{
|
||||
composed_op<decay_t<Implementation>, composed_work<Executors>,
|
||||
decay_t<Handler>, Signatures...>(implementation_,
|
||||
composed_work<Executors>(executors_),
|
||||
static_cast<Handler&&>(handler))(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, Args&&... args) &&
|
||||
{
|
||||
composed_op<decay_t<Implementation>, composed_work<Executors>,
|
||||
decay_t<Handler>, Signatures...>(
|
||||
static_cast<Implementation&&>(implementation_),
|
||||
composed_work<Executors>(executors_),
|
||||
static_cast<Handler&&>(handler))(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
Implementation implementation_;
|
||||
composed_io_executors<Executors> executors_;
|
||||
};
|
||||
|
||||
template <typename Implementation, typename... Signatures>
|
||||
class initiate_composed<Implementation, void(), Signatures...>
|
||||
{
|
||||
public:
|
||||
template <typename I>
|
||||
initiate_composed(I&& impl, composed_io_executors<void()>&&)
|
||||
: implementation_(std::forward<I>(impl))
|
||||
{
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, Args&&... args) const &
|
||||
{
|
||||
composed_op<decay_t<Implementation>, composed_work<void()>,
|
||||
decay_t<Handler>, Signatures...>(implementation_,
|
||||
composed_work<void()>(composed_io_executors<void()>()),
|
||||
static_cast<Handler&&>(handler))(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename Handler, typename... Args>
|
||||
void operator()(Handler&& handler, Args&&... args) &&
|
||||
{
|
||||
composed_op<decay_t<Implementation>, composed_work<void()>,
|
||||
decay_t<Handler>, Signatures...>(
|
||||
static_cast<Implementation&&>(implementation_),
|
||||
composed_work<void()>(composed_io_executors<void()>()),
|
||||
static_cast<Handler&&>(handler))(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
private:
|
||||
Implementation implementation_;
|
||||
};
|
||||
|
||||
template <typename... Signatures, typename Implementation, typename Executors>
|
||||
inline initiate_composed<Implementation, Executors, Signatures...>
|
||||
make_initiate_composed(Implementation&& implementation,
|
||||
composed_io_executors<Executors>&& executors)
|
||||
{
|
||||
return initiate_composed<decay_t<Implementation>, Executors, Signatures...>(
|
||||
static_cast<Implementation&&>(implementation),
|
||||
static_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) noexcept
|
||||
{
|
||||
return Associator<Handler, DefaultCandidate>::get(h.handler_);
|
||||
}
|
||||
|
||||
static auto get(const detail::composed_op<Impl, Work, Handler, Signature>& h,
|
||||
const DefaultCandidate& c) noexcept
|
||||
-> decltype(Associator<Handler, DefaultCandidate>::get(h.handler_, c))
|
||||
{
|
||||
return Associator<Handler, DefaultCandidate>::get(h.handler_, c);
|
||||
}
|
||||
};
|
||||
|
||||
#endif // !defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Creates an initiation function object that may be used to launch an
|
||||
/// asynchronous operation with a stateful implementation.
|
||||
/**
|
||||
* The @c composed function simplifies the implementation of composed
|
||||
* asynchronous operations automatically by wrapping a stateful function object
|
||||
* for use as an initiation function object.
|
||||
*
|
||||
* @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 io_objects_or_executors Zero or more I/O objects or I/O executors for
|
||||
* which outstanding work must be maintained.
|
||||
*
|
||||
* @par Per-Operation Cancellation
|
||||
* By default, terminal per-operation cancellation is enabled for composed
|
||||
* operations that are implemented using @c composed. To disable cancellation
|
||||
* for the composed operation, or to alter its supported cancellation types,
|
||||
* call the @c self object's @c reset_cancellation_state function.
|
||||
*
|
||||
* @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)
|
||||
* {
|
||||
* 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_initiate<CompletionToken,
|
||||
* void(asio::error_code, std::size_t)>(
|
||||
* asio::composed(
|
||||
* async_echo_implementation{socket, buffer,
|
||||
* async_echo_implementation::starting}, socket),
|
||||
* token))
|
||||
* {
|
||||
* return asio::async_initiate<CompletionToken,
|
||||
* void(asio::error_code, std::size_t)>(
|
||||
* asio::composed(
|
||||
* async_echo_implementation{socket, buffer,
|
||||
* async_echo_implementation::starting}, socket),
|
||||
* token, asio::error_code{}, 0);
|
||||
* } @endcode
|
||||
*/
|
||||
template <ASIO_COMPLETION_SIGNATURE... Signatures,
|
||||
typename Implementation, typename... IoObjectsOrExecutors>
|
||||
inline auto composed(Implementation&& implementation,
|
||||
IoObjectsOrExecutors&&... io_objects_or_executors)
|
||||
-> decltype(
|
||||
detail::make_initiate_composed<Signatures...>(
|
||||
static_cast<Implementation&&>(implementation),
|
||||
detail::make_composed_io_executors(
|
||||
detail::get_composed_io_executor(
|
||||
static_cast<IoObjectsOrExecutors&&>(
|
||||
io_objects_or_executors))...)))
|
||||
{
|
||||
return detail::make_initiate_composed<Signatures...>(
|
||||
static_cast<Implementation&&>(implementation),
|
||||
detail::make_composed_io_executors(
|
||||
detail::get_composed_io_executor(
|
||||
static_cast<IoObjectsOrExecutors&&>(
|
||||
io_objects_or_executors))...));
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_COMPOSE_HPP
|
||||
193
Packages/asio-1.36.0/include/asio/config.hpp
vendored
Normal file
193
Packages/asio-1.36.0/include/asio/config.hpp
vendored
Normal file
@@ -0,0 +1,193 @@
|
||||
//
|
||||
// config.hpp
|
||||
// ~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_CONFIG_HPP
|
||||
#define ASIO_CONFIG_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/throw_exception.hpp"
|
||||
#include "asio/detail/type_traits.hpp"
|
||||
#include "asio/execution_context.hpp"
|
||||
#include <cstddef>
|
||||
#include <string>
|
||||
|
||||
#include "asio/detail/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
/// Base class for configuration implementations.
|
||||
class config_service :
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
public execution_context::service
|
||||
#else // defined(GENERATING_DOCUMENTATION)
|
||||
public detail::execution_context_service_base<config_service>
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
{
|
||||
public:
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
typedef config_service key_type;
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Constructor.
|
||||
ASIO_DECL explicit config_service(execution_context& ctx);
|
||||
|
||||
/// Shutdown the service.
|
||||
ASIO_DECL void shutdown() override;
|
||||
|
||||
/// Retrieve a configuration value.
|
||||
ASIO_DECL virtual const char* get_value(const char* section,
|
||||
const char* key_name, char* value, std::size_t value_len) const;
|
||||
};
|
||||
|
||||
/// Provides access to the configuration values associated with an execution
|
||||
/// context.
|
||||
class config
|
||||
{
|
||||
public:
|
||||
/// Constructor.
|
||||
/**
|
||||
* This constructor initialises a @c config object to retrieve configuration
|
||||
* values associated with the specified execution context.
|
||||
*/
|
||||
explicit config(execution_context& context)
|
||||
: service_(use_service<config_service>(context))
|
||||
{
|
||||
}
|
||||
|
||||
/// Copy constructor.
|
||||
config(const config& other) noexcept
|
||||
: service_(other.service_)
|
||||
{
|
||||
}
|
||||
|
||||
/// Retrieve an integral configuration value.
|
||||
template <typename T>
|
||||
constraint_t<is_integral<T>::value, T>
|
||||
get(const char* section, const char* key_name, T default_value) const;
|
||||
|
||||
private:
|
||||
config_service& service_;
|
||||
};
|
||||
|
||||
/// Configures an execution context based on a concurrency hint.
|
||||
/**
|
||||
* This configuration service is provided for backwards compatibility with
|
||||
* the existing concurrency hint mechanism.
|
||||
*
|
||||
* @par Example
|
||||
* @code asio::io_context my_io_context{
|
||||
* asio::config_from_concurrency_hint{1}}; @endcode
|
||||
*/
|
||||
class config_from_concurrency_hint : public execution_context::service_maker
|
||||
{
|
||||
public:
|
||||
/// Construct with a default concurrency hint.
|
||||
ASIO_DECL config_from_concurrency_hint();
|
||||
|
||||
/// Construct with a specified concurrency hint.
|
||||
explicit config_from_concurrency_hint(int concurrency_hint)
|
||||
: concurrency_hint_(concurrency_hint)
|
||||
{
|
||||
}
|
||||
|
||||
/// Add a concrete service to the specified execution context.
|
||||
ASIO_DECL void make(execution_context& ctx) const override;
|
||||
|
||||
private:
|
||||
int concurrency_hint_;
|
||||
};
|
||||
|
||||
/// Configures an execution context by reading variables from a string.
|
||||
/**
|
||||
* Each variable must be on a line of its own, and of the form:
|
||||
*
|
||||
* <tt>section.key=value</tt>
|
||||
*
|
||||
* or, if an optional prefix is specified:
|
||||
*
|
||||
* <tt>prefix.section.key=value</tt>
|
||||
*
|
||||
* Blank lines and lines starting with <tt>#</tt> are ignored. It is also
|
||||
* permitted to include a comment starting with <tt>#</tt> after the value.
|
||||
*
|
||||
* @par Example
|
||||
* @code asio::io_context my_io_context{
|
||||
* asio::config_from_string{
|
||||
* "scheduler.concurrency_hint=10\n"
|
||||
* "scheduler.locking=1"}}; @endcode
|
||||
*/
|
||||
class config_from_string : public execution_context::service_maker
|
||||
{
|
||||
public:
|
||||
/// Construct with the default prefix "asio".
|
||||
explicit config_from_string(std::string s)
|
||||
: string_(static_cast<std::string&&>(s)),
|
||||
prefix_()
|
||||
{
|
||||
}
|
||||
|
||||
/// Construct with a specified prefix.
|
||||
config_from_string(std::string s, std::string prefix)
|
||||
: string_(static_cast<std::string&&>(s)),
|
||||
prefix_(static_cast<std::string&&>(prefix))
|
||||
{
|
||||
}
|
||||
|
||||
/// Add a concrete service to the specified execution context.
|
||||
ASIO_DECL void make(execution_context& ctx) const override;
|
||||
|
||||
private:
|
||||
std::string string_;
|
||||
std::string prefix_;
|
||||
};
|
||||
|
||||
/// Configures an execution context by reading environment variables.
|
||||
/**
|
||||
* The environment variable names are formed by concatenating the prefix,
|
||||
* section, and key, with underscore as delimiter, and then converting the
|
||||
* resulting string to upper case.
|
||||
*
|
||||
* @par Example
|
||||
* @code asio::io_context my_io_context{
|
||||
* asio::config_from_env{"my_app"}}; @endcode
|
||||
*/
|
||||
class config_from_env : public execution_context::service_maker
|
||||
{
|
||||
public:
|
||||
/// Construct with the default prefix "asio".
|
||||
ASIO_DECL config_from_env();
|
||||
|
||||
/// Construct with a specified prefix.
|
||||
explicit config_from_env(std::string prefix)
|
||||
: prefix_(static_cast<std::string&&>(prefix))
|
||||
{
|
||||
}
|
||||
|
||||
/// Add a concrete service to the specified execution context.
|
||||
ASIO_DECL void make(execution_context& ctx) const override;
|
||||
|
||||
private:
|
||||
std::string prefix_;
|
||||
};
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/config.hpp"
|
||||
#if defined(ASIO_HEADER_ONLY)
|
||||
# include "asio/impl/config.ipp"
|
||||
#endif // defined(ASIO_HEADER_ONLY)
|
||||
|
||||
#endif // ASIO_CONFIG_HPP
|
||||
1020
Packages/asio-1.36.0/include/asio/connect.hpp
vendored
Normal file
1020
Packages/asio-1.36.0/include/asio/connect.hpp
vendored
Normal file
File diff suppressed because it is too large
Load Diff
83
Packages/asio-1.36.0/include/asio/connect_pipe.hpp
vendored
Normal file
83
Packages/asio-1.36.0/include/asio/connect_pipe.hpp
vendored
Normal file
@@ -0,0 +1,83 @@
|
||||
//
|
||||
// connect_pipe.hpp
|
||||
// ~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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
|
||||
75
Packages/asio-1.36.0/include/asio/consign.hpp
vendored
Normal file
75
Packages/asio-1.36.0/include/asio/consign.hpp
vendored
Normal file
@@ -0,0 +1,75 @@
|
||||
//
|
||||
// consign.hpp
|
||||
// ~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#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>
|
||||
constexpr explicit consign_t(T&& completion_token, V&&... values)
|
||||
: token_(static_cast<T&&>(completion_token)),
|
||||
values_(static_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 constexpr
|
||||
consign_t<decay_t<CompletionToken>, decay_t<Values>...>
|
||||
consign(CompletionToken&& completion_token, Values&&... values)
|
||||
{
|
||||
return consign_t<decay_t<CompletionToken>, decay_t<Values>...>(
|
||||
static_cast<CompletionToken&&>(completion_token),
|
||||
static_cast<Values&&>(values)...);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/consign.hpp"
|
||||
|
||||
#endif // ASIO_CONSIGN_HPP
|
||||
328
Packages/asio-1.36.0/include/asio/coroutine.hpp
vendored
Normal file
328
Packages/asio-1.36.0/include/asio/coroutine.hpp
vendored
Normal file
@@ -0,0 +1,328 @@
|
||||
//
|
||||
// coroutine.hpp
|
||||
// ~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_buffer 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(const coroutine_ref&) = default;
|
||||
~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
|
||||
43
Packages/asio-1.36.0/include/asio/deadline_timer.hpp
vendored
Normal file
43
Packages/asio-1.36.0/include/asio/deadline_timer.hpp
vendored
Normal file
@@ -0,0 +1,43 @@
|
||||
//
|
||||
// deadline_timer.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_NO_DEPRECATED)
|
||||
|
||||
#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 {
|
||||
|
||||
/// (Deprecated: Use system_timer.) 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 // !defined(ASIO_NO_DEPRECATED)
|
||||
|
||||
#endif // ASIO_DEADLINE_TIMER_HPP
|
||||
89
Packages/asio-1.36.0/include/asio/default_completion_token.hpp
vendored
Normal file
89
Packages/asio-1.36.0/include/asio/default_completion_token.hpp
vendored
Normal file
@@ -0,0 +1,89 @@
|
||||
//
|
||||
// default_completion_token.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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_DEFAULT_COMPLETION_TOKEN_HPP
|
||||
#define ASIO_DEFAULT_COMPLETION_TOKEN_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/push_options.hpp"
|
||||
|
||||
namespace asio {
|
||||
|
||||
class deferred_t;
|
||||
|
||||
namespace detail {
|
||||
|
||||
template <typename T, typename = void>
|
||||
struct default_completion_token_impl
|
||||
{
|
||||
typedef deferred_t type;
|
||||
};
|
||||
|
||||
template <typename T>
|
||||
struct default_completion_token_impl<T,
|
||||
void_t<typename T::default_completion_token_type>
|
||||
>
|
||||
{
|
||||
typedef typename T::default_completion_token_type type;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
|
||||
/// Traits type used to determine the default completion token type associated
|
||||
/// with a type (such as an executor).
|
||||
/**
|
||||
* A program may specialise this traits type if the @c T template parameter in
|
||||
* the specialisation is a user-defined type.
|
||||
*
|
||||
* Specialisations of this trait may provide a nested typedef @c type, which is
|
||||
* a default-constructible completion token type.
|
||||
*
|
||||
* If not otherwise specialised, the default completion token type is
|
||||
* asio::deferred_t.
|
||||
*/
|
||||
template <typename T>
|
||||
struct default_completion_token
|
||||
{
|
||||
/// If @c T has a nested type @c default_completion_token_type,
|
||||
/// <tt>T::default_completion_token_type</tt>. Otherwise the typedef @c type
|
||||
/// is asio::deferred_t.
|
||||
typedef see_below type;
|
||||
};
|
||||
#else
|
||||
template <typename T>
|
||||
struct default_completion_token
|
||||
: detail::default_completion_token_impl<T>
|
||||
{
|
||||
};
|
||||
#endif
|
||||
|
||||
template <typename T>
|
||||
using default_completion_token_t = typename default_completion_token<T>::type;
|
||||
|
||||
#define ASIO_DEFAULT_COMPLETION_TOKEN_TYPE(e) \
|
||||
= typename ::asio::default_completion_token<e>::type
|
||||
#define ASIO_DEFAULT_COMPLETION_TOKEN(e) \
|
||||
= typename ::asio::default_completion_token<e>::type()
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/deferred.hpp"
|
||||
|
||||
#endif // ASIO_DEFAULT_COMPLETION_TOKEN_HPP
|
||||
218
Packages/asio-1.36.0/include/asio/defer.hpp
vendored
Normal file
218
Packages/asio-1.36.0/include/asio/defer.hpp
vendored
Normal file
@@ -0,0 +1,218 @@
|
||||
//
|
||||
// defer.hpp
|
||||
// ~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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/initiate_defer.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 {
|
||||
|
||||
/// 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>
|
||||
auto defer(NullaryToken&& token)
|
||||
-> decltype(
|
||||
async_initiate<NullaryToken, void()>(
|
||||
declval<detail::initiate_defer>(), token))
|
||||
{
|
||||
return async_initiate<NullaryToken, void()>(
|
||||
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
|
||||
= default_completion_token_t<Executor>>
|
||||
auto defer(const Executor& ex,
|
||||
NullaryToken&& token
|
||||
= default_completion_token_t<Executor>(),
|
||||
constraint_t<
|
||||
(execution::is_executor<Executor>::value
|
||||
&& can_require<Executor, execution::blocking_t::never_t>::value)
|
||||
|| is_executor<Executor>::value
|
||||
> = 0)
|
||||
-> decltype(
|
||||
async_initiate<NullaryToken, void()>(
|
||||
declval<detail::initiate_defer_with_executor<Executor>>(), token))
|
||||
{
|
||||
return async_initiate<NullaryToken, void()>(
|
||||
detail::initiate_defer_with_executor<Executor>(ex), 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
|
||||
= default_completion_token_t<typename ExecutionContext::executor_type>>
|
||||
auto defer(ExecutionContext& ctx,
|
||||
NullaryToken&& token
|
||||
= default_completion_token_t<typename ExecutionContext::executor_type>(),
|
||||
constraint_t<
|
||||
is_convertible<ExecutionContext&, execution_context&>::value
|
||||
> = 0)
|
||||
-> decltype(
|
||||
async_initiate<NullaryToken, void()>(
|
||||
declval<detail::initiate_defer_with_executor<
|
||||
typename ExecutionContext::executor_type>>(), token))
|
||||
{
|
||||
return async_initiate<NullaryToken, void()>(
|
||||
detail::initiate_defer_with_executor<
|
||||
typename ExecutionContext::executor_type>(
|
||||
ctx.get_executor()), token);
|
||||
}
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#endif // ASIO_DEFER_HPP
|
||||
719
Packages/asio-1.36.0/include/asio/deferred.hpp
vendored
Normal file
719
Packages/asio-1.36.0/include/asio/deferred.hpp
vendored
Normal file
@@ -0,0 +1,719 @@
|
||||
//
|
||||
// deferred.hpp
|
||||
// ~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
#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
|
||||
{
|
||||
};
|
||||
|
||||
/// Helper type to wrap multiple completion signatures.
|
||||
template <typename... Signatures>
|
||||
struct deferred_signatures
|
||||
{
|
||||
};
|
||||
|
||||
namespace detail {
|
||||
|
||||
// Helper trait for getting the completion signatures of the tail in a sequence
|
||||
// when invoked with the specified arguments.
|
||||
|
||||
template <typename Tail, typename... Signatures>
|
||||
struct deferred_sequence_signatures;
|
||||
|
||||
template <typename Tail, typename R, typename... Args, typename... Signatures>
|
||||
struct deferred_sequence_signatures<Tail, R(Args...), Signatures...>
|
||||
: completion_signature_of<decltype(declval<Tail>()(declval<Args>()...))>
|
||||
{
|
||||
static_assert(
|
||||
!is_same<decltype(declval<Tail>()(declval<Args>()...)), void>::value,
|
||||
"deferred functions must produce a deferred return 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(H&& handler, T&& tail)
|
||||
: handler_(static_cast<H&&>(handler)),
|
||||
tail_(static_cast<T&&>(tail))
|
||||
{
|
||||
}
|
||||
|
||||
template <typename... Args>
|
||||
void operator()(Args&&... args)
|
||||
{
|
||||
static_cast<Tail&&>(tail_)(
|
||||
static_cast<Args&&>(args)...)(
|
||||
static_cast<Handler&&>(handler_));
|
||||
}
|
||||
|
||||
//private:
|
||||
Handler handler_;
|
||||
Tail tail_;
|
||||
};
|
||||
|
||||
template <typename Head, typename Tail, typename... Signatures>
|
||||
class deferred_sequence_base
|
||||
{
|
||||
private:
|
||||
struct initiate
|
||||
{
|
||||
template <typename Handler>
|
||||
void operator()(Handler&& handler, Head head, Tail&& tail)
|
||||
{
|
||||
static_cast<Head&&>(head)(
|
||||
deferred_sequence_handler<decay_t<Handler>, decay_t<Tail>>(
|
||||
static_cast<Handler&&>(handler), static_cast<Tail&&>(tail)));
|
||||
}
|
||||
};
|
||||
|
||||
Head head_;
|
||||
Tail tail_;
|
||||
|
||||
public:
|
||||
template <typename H, typename T>
|
||||
constexpr explicit deferred_sequence_base(H&& head, T&& tail)
|
||||
: head_(static_cast<H&&>(head)),
|
||||
tail_(static_cast<T&&>(tail))
|
||||
{
|
||||
}
|
||||
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(Signatures...) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) &&
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signatures...>(
|
||||
initiate(), token, static_cast<Head&&>(this->head_),
|
||||
static_cast<Tail&&>(this->tail_)))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signatures...>(initiate(),
|
||||
token, static_cast<Head&&>(head_), static_cast<Tail&&>(tail_));
|
||||
}
|
||||
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(Signatures...) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) const &
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signatures...>(
|
||||
initiate(), token, this->head_, this->tail_))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signatures...>(
|
||||
initiate(), token, head_, tail_);
|
||||
}
|
||||
};
|
||||
|
||||
// Two-step application of variadic Signatures to determine correct base type.
|
||||
|
||||
template <typename Head, typename Tail>
|
||||
struct deferred_sequence_types
|
||||
{
|
||||
template <typename... Signatures>
|
||||
struct op1
|
||||
{
|
||||
typedef deferred_sequence_base<Head, Tail, Signatures...> type;
|
||||
};
|
||||
|
||||
template <typename... Signatures>
|
||||
struct op2
|
||||
{
|
||||
typedef typename deferred_sequence_signatures<Tail, Signatures...>::template
|
||||
apply<op1>::type::type type;
|
||||
};
|
||||
|
||||
typedef typename completion_signature_of<Head>::template
|
||||
apply<op2>::type::type base;
|
||||
};
|
||||
|
||||
} // namespace detail
|
||||
|
||||
/// Used to represent an empty deferred action.
|
||||
struct deferred_noop
|
||||
{
|
||||
/// No effect.
|
||||
template <typename... Args>
|
||||
void operator()(Args&&...) &&
|
||||
{
|
||||
}
|
||||
|
||||
/// No effect.
|
||||
template <typename... Args>
|
||||
void operator()(Args&&...) const &
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
#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>
|
||||
constexpr explicit deferred_function(deferred_init_tag, F&& function)
|
||||
: function_(static_cast<F&&>(function))
|
||||
{
|
||||
}
|
||||
|
||||
//private:
|
||||
Function function_;
|
||||
|
||||
public:
|
||||
template <typename... Args>
|
||||
auto operator()(Args&&... args) &&
|
||||
-> decltype(
|
||||
static_cast<Function&&>(this->function_)(static_cast<Args&&>(args)...))
|
||||
{
|
||||
return static_cast<Function&&>(function_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
template <typename... Args>
|
||||
auto operator()(Args&&... args) const &
|
||||
-> decltype(Function(function_)(static_cast<Args&&>(args)...))
|
||||
{
|
||||
return Function(function_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
};
|
||||
|
||||
#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, V&&... values)
|
||||
{
|
||||
static_cast<Handler&&>(handler)(static_cast<V&&>(values)...);
|
||||
}
|
||||
};
|
||||
|
||||
template <typename CompletionToken, std::size_t... I>
|
||||
auto invoke_helper(CompletionToken&& token, detail::index_sequence<I...>)
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, void(Values...)>(initiate(), token,
|
||||
std::get<I>(static_cast<std::tuple<Values...>&&>(this->values_))...))
|
||||
{
|
||||
return async_initiate<CompletionToken, void(Values...)>(initiate(), token,
|
||||
std::get<I>(static_cast<std::tuple<Values...>&&>(values_))...);
|
||||
}
|
||||
|
||||
template <typename CompletionToken, std::size_t... I>
|
||||
auto const_invoke_helper(CompletionToken&& token,
|
||||
detail::index_sequence<I...>)
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, void(Values...)>(
|
||||
initiate(), token, std::get<I>(values_)...))
|
||||
{
|
||||
return async_initiate<CompletionToken, void(Values...)>(
|
||||
initiate(), token, std::get<I>(values_)...);
|
||||
}
|
||||
|
||||
public:
|
||||
/// Construct a deferred asynchronous operation from the arguments to an
|
||||
/// initiation function object.
|
||||
template <typename... V>
|
||||
constexpr explicit deferred_values(
|
||||
deferred_init_tag, V&&... values)
|
||||
: values_(static_cast<V&&>(values)...)
|
||||
{
|
||||
}
|
||||
|
||||
/// Initiate the deferred operation using the supplied completion token.
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(void(Values...)) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) &&
|
||||
-> decltype(
|
||||
this->invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<Values...>()))
|
||||
{
|
||||
return this->invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<Values...>());
|
||||
}
|
||||
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(void(Values...)) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) const &
|
||||
-> decltype(
|
||||
this->const_invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<Values...>()))
|
||||
{
|
||||
return this->const_invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<Values...>());
|
||||
}
|
||||
};
|
||||
|
||||
#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 decay_t<Initiation> initiation_t;
|
||||
initiation_t initiation_;
|
||||
typedef std::tuple<decay_t<InitArgs>...> init_args_t;
|
||||
init_args_t init_args_;
|
||||
|
||||
template <typename CompletionToken, std::size_t... I>
|
||||
auto invoke_helper(CompletionToken&& token, detail::index_sequence<I...>)
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signature>(
|
||||
static_cast<initiation_t&&>(initiation_), token,
|
||||
std::get<I>(static_cast<init_args_t&&>(init_args_))...))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signature>(
|
||||
static_cast<initiation_t&&>(initiation_), token,
|
||||
std::get<I>(static_cast<init_args_t&&>(init_args_))...);
|
||||
}
|
||||
|
||||
template <typename CompletionToken, std::size_t... I>
|
||||
auto const_invoke_helper(CompletionToken&& token,
|
||||
detail::index_sequence<I...>) const &
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signature>(
|
||||
conditional_t<true, initiation_t, CompletionToken>(initiation_),
|
||||
token, std::get<I>(init_args_)...))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signature>(
|
||||
initiation_t(initiation_), token, std::get<I>(init_args_)...);
|
||||
}
|
||||
|
||||
public:
|
||||
/// Construct a deferred asynchronous operation from the arguments to an
|
||||
/// initiation function object.
|
||||
template <typename I, typename... A>
|
||||
constexpr explicit deferred_async_operation(
|
||||
deferred_init_tag, I&& initiation, A&&... init_args)
|
||||
: initiation_(static_cast<I&&>(initiation)),
|
||||
init_args_(static_cast<A&&>(init_args)...)
|
||||
{
|
||||
}
|
||||
|
||||
/// Initiate the asynchronous operation using the supplied completion token.
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(Signature) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) &&
|
||||
-> decltype(
|
||||
this->invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>()))
|
||||
{
|
||||
return this->invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>());
|
||||
}
|
||||
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(Signature) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) const &
|
||||
-> decltype(
|
||||
this->const_invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>()))
|
||||
{
|
||||
return this->const_invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>());
|
||||
}
|
||||
};
|
||||
|
||||
/// Encapsulates a deferred asynchronous operation thas has multiple completion
|
||||
/// signatures.
|
||||
template <typename... Signatures, typename Initiation, typename... InitArgs>
|
||||
class ASIO_NODISCARD deferred_async_operation<
|
||||
deferred_signatures<Signatures...>, Initiation, InitArgs...>
|
||||
{
|
||||
private:
|
||||
typedef decay_t<Initiation> initiation_t;
|
||||
initiation_t initiation_;
|
||||
typedef std::tuple<decay_t<InitArgs>...> init_args_t;
|
||||
init_args_t init_args_;
|
||||
|
||||
template <typename CompletionToken, std::size_t... I>
|
||||
auto invoke_helper(CompletionToken&& token, detail::index_sequence<I...>)
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signatures...>(
|
||||
static_cast<initiation_t&&>(initiation_), token,
|
||||
std::get<I>(static_cast<init_args_t&&>(init_args_))...))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signatures...>(
|
||||
static_cast<initiation_t&&>(initiation_), token,
|
||||
std::get<I>(static_cast<init_args_t&&>(init_args_))...);
|
||||
}
|
||||
|
||||
template <typename CompletionToken, std::size_t... I>
|
||||
auto const_invoke_helper(CompletionToken&& token,
|
||||
detail::index_sequence<I...>) const &
|
||||
-> decltype(
|
||||
async_initiate<CompletionToken, Signatures...>(
|
||||
initiation_t(initiation_), token, std::get<I>(init_args_)...))
|
||||
{
|
||||
return async_initiate<CompletionToken, Signatures...>(
|
||||
initiation_t(initiation_), token, std::get<I>(init_args_)...);
|
||||
}
|
||||
|
||||
public:
|
||||
/// Construct a deferred asynchronous operation from the arguments to an
|
||||
/// initiation function object.
|
||||
template <typename I, typename... A>
|
||||
constexpr explicit deferred_async_operation(
|
||||
deferred_init_tag, I&& initiation, A&&... init_args)
|
||||
: initiation_(static_cast<I&&>(initiation)),
|
||||
init_args_(static_cast<A&&>(init_args)...)
|
||||
{
|
||||
}
|
||||
|
||||
/// Initiate the asynchronous operation using the supplied completion token.
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(Signatures...) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) &&
|
||||
-> decltype(
|
||||
this->invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>()))
|
||||
{
|
||||
return this->invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>());
|
||||
}
|
||||
|
||||
template <ASIO_COMPLETION_TOKEN_FOR(Signatures...) CompletionToken>
|
||||
auto operator()(CompletionToken&& token) const &
|
||||
-> decltype(
|
||||
this->const_invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>()))
|
||||
{
|
||||
return this->const_invoke_helper(
|
||||
static_cast<CompletionToken&&>(token),
|
||||
detail::index_sequence_for<InitArgs...>());
|
||||
}
|
||||
};
|
||||
|
||||
#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 :
|
||||
public detail::deferred_sequence_types<Head, Tail>::base
|
||||
{
|
||||
public:
|
||||
template <typename H, typename T>
|
||||
constexpr explicit deferred_sequence(deferred_init_tag, H&& head, T&& tail)
|
||||
: detail::deferred_sequence_types<Head, Tail>::base(
|
||||
static_cast<H&&>(head), static_cast<T&&>(tail))
|
||||
{
|
||||
}
|
||||
|
||||
#if defined(GENERATING_DOCUMENTATION)
|
||||
template <typename CompletionToken>
|
||||
auto operator()(CompletionToken&& token) &&;
|
||||
|
||||
template <typename CompletionToken>
|
||||
auto operator()(CompletionToken&& token) const &;
|
||||
#endif // defined(GENERATING_DOCUMENTATION)
|
||||
};
|
||||
|
||||
#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, T&& on_true, F&& on_false)
|
||||
: on_true_(static_cast<T&&>(on_true)),
|
||||
on_false_(static_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.
|
||||
constexpr explicit deferred_conditional(bool b)
|
||||
: on_true_(),
|
||||
on_false_(),
|
||||
bool_(b)
|
||||
{
|
||||
}
|
||||
|
||||
/// Invoke the conditional branch bsaed on the stored value.
|
||||
template <typename... Args>
|
||||
auto operator()(Args&&... args) &&
|
||||
-> decltype(static_cast<OnTrue&&>(on_true_)(static_cast<Args&&>(args)...))
|
||||
{
|
||||
if (bool_)
|
||||
{
|
||||
return static_cast<OnTrue&&>(on_true_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
else
|
||||
{
|
||||
return static_cast<OnFalse&&>(on_false_)(static_cast<Args&&>(args)...);
|
||||
}
|
||||
}
|
||||
|
||||
template <typename... Args>
|
||||
auto operator()(Args&&... args) const &
|
||||
-> decltype(on_true_(static_cast<Args&&>(args)...))
|
||||
{
|
||||
if (bool_)
|
||||
{
|
||||
return on_true_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
else
|
||||
{
|
||||
return on_false_(static_cast<Args&&>(args)...);
|
||||
}
|
||||
}
|
||||
|
||||
/// Set the true branch of the conditional.
|
||||
template <typename T>
|
||||
deferred_conditional<T, OnFalse> then(T on_true,
|
||||
constraint_t<
|
||||
is_deferred<T>::value
|
||||
>* = 0,
|
||||
constraint_t<
|
||||
is_same<
|
||||
conditional_t<true, OnTrue, T>,
|
||||
deferred_noop
|
||||
>::value
|
||||
>* = 0) &&
|
||||
{
|
||||
return deferred_conditional<T, OnFalse>(
|
||||
bool_, static_cast<T&&>(on_true),
|
||||
static_cast<OnFalse&&>(on_false_));
|
||||
}
|
||||
|
||||
/// Set the false branch of the conditional.
|
||||
template <typename T>
|
||||
deferred_conditional<OnTrue, T> otherwise(T on_false,
|
||||
constraint_t<
|
||||
is_deferred<T>::value
|
||||
>* = 0,
|
||||
constraint_t<
|
||||
!is_same<
|
||||
conditional_t<true, OnTrue, T>,
|
||||
deferred_noop
|
||||
>::value
|
||||
>* = 0,
|
||||
constraint_t<
|
||||
is_same<
|
||||
conditional_t<true, OnFalse, T>,
|
||||
deferred_noop
|
||||
>::value
|
||||
>* = 0) &&
|
||||
{
|
||||
return deferred_conditional<OnTrue, T>(
|
||||
bool_, static_cast<OnTrue&&>(on_true_),
|
||||
static_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 as the default completion token:
|
||||
*
|
||||
* @code auto my_deferred_op = my_socket.async_read_some(my_buffer); @endcode
|
||||
*
|
||||
* or by explicitly passing the special value @c asio::deferred:
|
||||
*
|
||||
* @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.
|
||||
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,
|
||||
constraint_t<
|
||||
conditional_t<
|
||||
!is_same<InnerExecutor1, executor_with_default>::value,
|
||||
is_convertible<InnerExecutor1, InnerExecutor>,
|
||||
false_type
|
||||
>::value
|
||||
> = 0) noexcept
|
||||
: InnerExecutor(ex)
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
/// Type alias to adapt an I/O object to use @c deferred_t as its
|
||||
/// default completion token type.
|
||||
template <typename T>
|
||||
using as_default_on_t = typename T::template rebind_executor<
|
||||
executor_with_default<typename T::executor_type>>::other;
|
||||
|
||||
/// 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<T>::template rebind_executor<
|
||||
executor_with_default<typename decay_t<T>::executor_type>
|
||||
>::other
|
||||
as_default_on(T&& object)
|
||||
{
|
||||
return typename decay_t<T>::template rebind_executor<
|
||||
executor_with_default<typename decay_t<T>::executor_type>
|
||||
>::other(static_cast<T&&>(object));
|
||||
}
|
||||
|
||||
/// Creates a new deferred from a function.
|
||||
template <typename Function>
|
||||
constraint_t<
|
||||
!is_deferred<decay_t<Function>>::value,
|
||||
deferred_function<decay_t<Function>>
|
||||
> operator()(Function&& function) const
|
||||
{
|
||||
return deferred_function<decay_t<Function>>(
|
||||
deferred_init_tag{}, static_cast<Function&&>(function));
|
||||
}
|
||||
|
||||
/// Passes through anything that is already deferred.
|
||||
template <typename T>
|
||||
constraint_t<
|
||||
is_deferred<decay_t<T>>::value,
|
||||
decay_t<T>
|
||||
> operator()(T&& t) const
|
||||
{
|
||||
return static_cast<T&&>(t);
|
||||
}
|
||||
|
||||
/// Returns a deferred operation that returns the provided values.
|
||||
template <typename... Args>
|
||||
static constexpr deferred_values<decay_t<Args>...> values(Args&&... args)
|
||||
{
|
||||
return deferred_values<decay_t<Args>...>(
|
||||
deferred_init_tag{}, static_cast<Args&&>(args)...);
|
||||
}
|
||||
|
||||
/// Creates a conditional object for branching deferred operations.
|
||||
static 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, Tail&& tail)
|
||||
-> constraint_t<
|
||||
is_deferred<Head>::value,
|
||||
decltype(static_cast<Head&&>(head)(static_cast<Tail&&>(tail)))
|
||||
>
|
||||
{
|
||||
return static_cast<Head&&>(head)(static_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.
|
||||
*/
|
||||
ASIO_INLINE_VARIABLE constexpr deferred_t deferred;
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/deferred.hpp"
|
||||
|
||||
#endif // ASIO_DEFERRED_HPP
|
||||
105
Packages/asio-1.36.0/include/asio/detached.hpp
vendored
Normal file
105
Packages/asio-1.36.0/include/asio/detached.hpp
vendored
Normal file
@@ -0,0 +1,105 @@
|
||||
//
|
||||
// detached.hpp
|
||||
// ~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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.
|
||||
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) 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,
|
||||
constraint_t<
|
||||
is_convertible<OtherExecutor, InnerExecutor>::value
|
||||
> = 0) noexcept
|
||||
: InnerExecutor(ex)
|
||||
{
|
||||
}
|
||||
};
|
||||
|
||||
/// Type alias to adapt an I/O object to use @c detached_t as its
|
||||
/// default completion token type.
|
||||
template <typename T>
|
||||
using as_default_on_t = typename T::template rebind_executor<
|
||||
executor_with_default<typename T::executor_type>>::other;
|
||||
|
||||
/// 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<T>::template rebind_executor<
|
||||
executor_with_default<typename decay_t<T>::executor_type>
|
||||
>::other
|
||||
as_default_on(T&& object)
|
||||
{
|
||||
return typename decay_t<T>::template rebind_executor<
|
||||
executor_with_default<typename decay_t<T>::executor_type>
|
||||
>::other(static_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.
|
||||
*/
|
||||
ASIO_INLINE_VARIABLE constexpr detached_t detached;
|
||||
|
||||
} // namespace asio
|
||||
|
||||
#include "asio/detail/pop_options.hpp"
|
||||
|
||||
#include "asio/impl/detached.hpp"
|
||||
|
||||
#endif // ASIO_DETACHED_HPP
|
||||
30
Packages/asio-1.36.0/include/asio/detail/array.hpp
vendored
Normal file
30
Packages/asio-1.36.0/include/asio/detail/array.hpp
vendored
Normal file
@@ -0,0 +1,30 @@
|
||||
//
|
||||
// detail/array.hpp
|
||||
// ~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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"
|
||||
|
||||
#include <array>
|
||||
|
||||
namespace asio {
|
||||
namespace detail {
|
||||
|
||||
using std::array;
|
||||
|
||||
} // namespace detail
|
||||
} // namespace asio
|
||||
|
||||
#endif // ASIO_DETAIL_ARRAY_HPP
|
||||
32
Packages/asio-1.36.0/include/asio/detail/array_fwd.hpp
vendored
Normal file
32
Packages/asio-1.36.0/include/asio/detail/array_fwd.hpp
vendored
Normal file
@@ -0,0 +1,32 @@
|
||||
//
|
||||
// detail/array_fwd.hpp
|
||||
// ~~~~~~~~~~~~~~~~~~~~
|
||||
//
|
||||
// Copyright (c) 2003-2025 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.
|
||||
#include <array>
|
||||
|
||||
#endif // ASIO_DETAIL_ARRAY_FWD_HPP
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user