async_connect.html
12.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>async_connect</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="../../index.html" title="Asio">
<link rel="up" href="../reference.html" title="Reference">
<link rel="prev" href="async_compose.html" title="async_compose">
<link rel="next" href="async_connect/overload1.html" title="async_connect (1 of 6 overloads)">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr><td valign="top"><img alt="asio C++ library" width="250" height="60" src="../../asio.png"></td></tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="async_compose.html"><img src="../../prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../home.png" alt="Home"></a><a accesskey="n" href="async_connect/overload1.html"><img src="../../next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="asio.reference.async_connect"></a><a class="link" href="async_connect.html" title="async_connect">async_connect</a>
</h3></div></div></div>
<p>
<a class="indexterm" name="asio.indexterm.async_connect"></a>
The <code class="computeroutput">async_connect</code> function
is a composed asynchronous operation that establishes a socket connection
by trying each endpoint in a sequence.
</p>
<p>
Asynchronously establishes a socket connection by trying each endpoint in
a sequence.
</p>
<pre class="programlisting">template<
typename <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a>,
typename <a class="link" href="Executor1.html" title="Executor requirements">Executor</a>,
typename <a class="link" href="EndpointSequence.html" title="Endpoint sequence requirements">EndpointSequence</a>,
typename <a class="link" href="RangeConnectHandler.html" title="Range connect handler requirements">RangeConnectHandler</a> = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>>
<a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type"><span class="emphasis"><em>DEDUCED</em></span></a> <a class="link" href="async_connect/overload1.html" title="async_connect (1 of 6 overloads)">async_connect</a>(
basic_socket< Protocol, Executor > & s,
const EndpointSequence & endpoints,
RangeConnectHandler && handler = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>,
typename enable_if< is_endpoint_sequence< EndpointSequence >::value >::type * = 0);
<span class="emphasis"><em>» <a class="link" href="async_connect/overload1.html" title="async_connect (1 of 6 overloads)">more...</a></em></span>
</pre>
<p>
(Deprecated: Use range overload.) Asynchronously establishes a socket connection
by trying each endpoint in a sequence.
</p>
<pre class="programlisting">template<
typename <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a>,
typename <a class="link" href="Executor1.html" title="Executor requirements">Executor</a>,
typename Iterator,
typename <a class="link" href="IteratorConnectHandler.html" title="Iterator connect handler requirements">IteratorConnectHandler</a> = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>>
<a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type"><span class="emphasis"><em>DEDUCED</em></span></a> <a class="link" href="async_connect/overload2.html" title="async_connect (2 of 6 overloads)">async_connect</a>(
basic_socket< Protocol, Executor > & s,
Iterator begin,
IteratorConnectHandler && handler = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>,
typename enable_if<!is_endpoint_sequence< Iterator >::value >::type * = 0);
<span class="emphasis"><em>» <a class="link" href="async_connect/overload2.html" title="async_connect (2 of 6 overloads)">more...</a></em></span>
</pre>
<p>
Asynchronously establishes a socket connection by trying each endpoint in
a sequence.
</p>
<pre class="programlisting">template<
typename <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a>,
typename <a class="link" href="Executor1.html" title="Executor requirements">Executor</a>,
typename Iterator,
typename <a class="link" href="IteratorConnectHandler.html" title="Iterator connect handler requirements">IteratorConnectHandler</a> = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>>
<a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type"><span class="emphasis"><em>DEDUCED</em></span></a> <a class="link" href="async_connect/overload3.html" title="async_connect (3 of 6 overloads)">async_connect</a>(
basic_socket< Protocol, Executor > & s,
Iterator begin,
Iterator end,
IteratorConnectHandler && handler = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>);
<span class="emphasis"><em>» <a class="link" href="async_connect/overload3.html" title="async_connect (3 of 6 overloads)">more...</a></em></span>
template<
typename <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a>,
typename <a class="link" href="Executor1.html" title="Executor requirements">Executor</a>,
typename <a class="link" href="EndpointSequence.html" title="Endpoint sequence requirements">EndpointSequence</a>,
typename <a class="link" href="ConnectCondition.html" title="Connect condition requirements">ConnectCondition</a>,
typename <a class="link" href="RangeConnectHandler.html" title="Range connect handler requirements">RangeConnectHandler</a> = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>>
<a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type"><span class="emphasis"><em>DEDUCED</em></span></a> <a class="link" href="async_connect/overload4.html" title="async_connect (4 of 6 overloads)">async_connect</a>(
basic_socket< Protocol, Executor > & s,
const EndpointSequence & endpoints,
ConnectCondition connect_condition,
RangeConnectHandler && handler = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>,
typename enable_if< is_endpoint_sequence< EndpointSequence >::value >::type * = 0);
<span class="emphasis"><em>» <a class="link" href="async_connect/overload4.html" title="async_connect (4 of 6 overloads)">more...</a></em></span>
</pre>
<p>
(Deprecated: Use range overload.) Asynchronously establishes a socket connection
by trying each endpoint in a sequence.
</p>
<pre class="programlisting">template<
typename <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a>,
typename <a class="link" href="Executor1.html" title="Executor requirements">Executor</a>,
typename Iterator,
typename <a class="link" href="ConnectCondition.html" title="Connect condition requirements">ConnectCondition</a>,
typename <a class="link" href="IteratorConnectHandler.html" title="Iterator connect handler requirements">IteratorConnectHandler</a> = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>>
<a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type"><span class="emphasis"><em>DEDUCED</em></span></a> <a class="link" href="async_connect/overload5.html" title="async_connect (5 of 6 overloads)">async_connect</a>(
basic_socket< Protocol, Executor > & s,
Iterator begin,
ConnectCondition connect_condition,
IteratorConnectHandler && handler = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>,
typename enable_if<!is_endpoint_sequence< Iterator >::value >::type * = 0);
<span class="emphasis"><em>» <a class="link" href="async_connect/overload5.html" title="async_connect (5 of 6 overloads)">more...</a></em></span>
</pre>
<p>
Asynchronously establishes a socket connection by trying each endpoint in
a sequence.
</p>
<pre class="programlisting">template<
typename <a class="link" href="Protocol.html" title="Protocol requirements">Protocol</a>,
typename <a class="link" href="Executor1.html" title="Executor requirements">Executor</a>,
typename Iterator,
typename <a class="link" href="ConnectCondition.html" title="Connect condition requirements">ConnectCondition</a>,
typename <a class="link" href="IteratorConnectHandler.html" title="Iterator connect handler requirements">IteratorConnectHandler</a> = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>>
<a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.automatic_deduction_of_initiating_function_return_type"><span class="emphasis"><em>DEDUCED</em></span></a> <a class="link" href="async_connect/overload6.html" title="async_connect (6 of 6 overloads)">async_connect</a>(
basic_socket< Protocol, Executor > & s,
Iterator begin,
Iterator end,
ConnectCondition connect_condition,
IteratorConnectHandler && handler = <a class="link" href="asynchronous_operations.html#asio.reference.asynchronous_operations.default_completion_tokens"><span class="emphasis"><em>DEFAULT</em></span></a>);
<span class="emphasis"><em>» <a class="link" href="async_connect/overload6.html" title="async_connect (6 of 6 overloads)">more...</a></em></span>
</pre>
<h5>
<a name="asio.reference.async_connect.h0"></a>
<span><a name="asio.reference.async_connect.requirements"></a></span><a class="link" href="async_connect.html#asio.reference.async_connect.requirements">Requirements</a>
</h5>
<p>
<span class="emphasis"><em>Header: </em></span><code class="literal">asio/connect.hpp</code>
</p>
<p>
<span class="emphasis"><em>Convenience header: </em></span><code class="literal">asio.hpp</code>
</p>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright © 2003-2020 Christopher M.
Kohlhoff<p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
</p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="async_compose.html"><img src="../../prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../home.png" alt="Home"></a><a accesskey="n" href="async_connect/overload1.html"><img src="../../next.png" alt="Next"></a>
</div>
</body>
</html>