- tmp/tmp4yopfo_x/{from.md → to.md} +151 -132
tmp/tmp4yopfo_x/{from.md → to.md}
RENAMED
|
@@ -13,43 +13,43 @@ capture-default:
|
|
| 13 |
'='
|
| 14 |
```
|
| 15 |
|
| 16 |
``` bnf
|
| 17 |
capture-list:
|
| 18 |
-
capture
|
| 19 |
-
capture-list ',' capture
|
| 20 |
```
|
| 21 |
|
| 22 |
``` bnf
|
| 23 |
capture:
|
| 24 |
simple-capture
|
| 25 |
init-capture
|
| 26 |
```
|
| 27 |
|
| 28 |
``` bnf
|
| 29 |
simple-capture:
|
| 30 |
-
identifier
|
| 31 |
-
'&' identifier
|
| 32 |
-
|
| 33 |
-
'* this'
|
| 34 |
```
|
| 35 |
|
| 36 |
``` bnf
|
| 37 |
init-capture:
|
| 38 |
-
identifier initializer
|
| 39 |
-
'&' identifier initializer
|
| 40 |
```
|
| 41 |
|
| 42 |
The body of a *lambda-expression* may refer to variables with automatic
|
| 43 |
storage duration and the `*this` object (if any) of enclosing block
|
| 44 |
scopes by capturing those entities, as described below.
|
| 45 |
|
| 46 |
If a *lambda-capture* includes a *capture-default* that is `&`, no
|
| 47 |
identifier in a *simple-capture* of that *lambda-capture* shall be
|
| 48 |
preceded by `&`. If a *lambda-capture* includes a *capture-default* that
|
| 49 |
is `=`, each *simple-capture* of that *lambda-capture* shall be of the
|
| 50 |
-
form “`&` *identifier*” or “`* this`”.
|
| 51 |
|
| 52 |
[*Note 1*: The form `[&,this]` is redundant but accepted for
|
| 53 |
compatibility with ISO C++14. — *end note*]
|
| 54 |
|
| 55 |
Ignoring appearances in *initializer*s of *init-capture*s, an identifier
|
|
@@ -59,66 +59,62 @@ or `this` shall not appear more than once in a *lambda-capture*.
|
|
| 59 |
|
| 60 |
``` cpp
|
| 61 |
struct S2 { void f(int i); };
|
| 62 |
void S2::f(int i) {
|
| 63 |
[&, i]{ }; // OK
|
|
|
|
| 64 |
[&, &i]{ }; // error: i preceded by & when & is the default
|
| 65 |
[=, *this]{ }; // OK
|
| 66 |
-
[=, this]{ }; //
|
| 67 |
[i, i]{ }; // error: i repeated
|
| 68 |
[this, *this]{ }; // error: this appears twice
|
| 69 |
}
|
| 70 |
```
|
| 71 |
|
| 72 |
— *end example*]
|
| 73 |
|
| 74 |
-
A *lambda-expression*
|
| 75 |
-
|
| 76 |
-
|
| 77 |
-
|
| 78 |
-
|
| 79 |
-
including the innermost enclosing function and its parameters.
|
| 80 |
-
|
| 81 |
-
[*Note 2*: This reaching scope includes any intervening
|
| 82 |
-
*lambda-expression*s. — *end note*]
|
| 83 |
|
| 84 |
The *identifier* in a *simple-capture* is looked up using the usual
|
| 85 |
-
rules for unqualified name lookup
|
| 86 |
-
lookup shall find
|
| 87 |
-
*
|
| 88 |
-
|
| 89 |
-
variable with automatic storage duration declared in the reaching scope
|
| 90 |
-
of the local lambda expression.
|
| 91 |
|
| 92 |
If an *identifier* in a *simple-capture* appears as the *declarator-id*
|
| 93 |
of a parameter of the *lambda-declarator*'s
|
| 94 |
*parameter-declaration-clause*, the program is ill-formed.
|
| 95 |
|
| 96 |
[*Example 2*:
|
| 97 |
|
| 98 |
``` cpp
|
| 99 |
void f() {
|
| 100 |
int x = 0;
|
| 101 |
-
auto g = [x](int x) { return 0; } // error: parameter and simple-capture have the same name
|
| 102 |
}
|
| 103 |
```
|
| 104 |
|
| 105 |
— *end example*]
|
| 106 |
|
| 107 |
-
An *init-capture* behaves as if it declares and
|
| 108 |
-
variable of the form “`auto` *init-capture* `;`”
|
| 109 |
-
region is the *lambda-expression*’s
|
|
|
|
| 110 |
|
| 111 |
- if the capture is by copy (see below), the non-static data member
|
| 112 |
declared for the capture and the variable are treated as two different
|
| 113 |
ways of referring to the same object, which has the lifetime of the
|
| 114 |
non-static data member, and no additional copy and destruction is
|
| 115 |
performed, and
|
| 116 |
- if the capture is by reference, the variable’s lifetime ends when the
|
| 117 |
closure object’s lifetime ends.
|
| 118 |
|
| 119 |
-
[*Note
|
| 120 |
the second “`x`” must bind to a declaration in the surrounding
|
| 121 |
context. — *end note*]
|
| 122 |
|
| 123 |
[*Example 3*:
|
| 124 |
|
|
@@ -127,72 +123,101 @@ int x = 4;
|
|
| 127 |
auto y = [&r = x, x = x+1]()->int {
|
| 128 |
r += 2;
|
| 129 |
return x+2;
|
| 130 |
}(); // Updates ::x to 6, and initializes y to 7.
|
| 131 |
|
| 132 |
-
auto z = [a = 42](int a) { return 1; }
|
| 133 |
```
|
| 134 |
|
| 135 |
— *end example*]
|
| 136 |
|
| 137 |
-
|
| 138 |
-
|
| 139 |
-
(this excludes any *id-expression* that has been found to refer to an
|
| 140 |
-
*init-capture*'s associated non-static data member), is said to
|
| 141 |
-
*implicitly capture* the entity (i.e., `*this` or a variable) if the
|
| 142 |
-
*compound-statement*:
|
| 143 |
|
| 144 |
-
-
|
| 145 |
-
|
| 146 |
-
|
| 147 |
-
|
| 148 |
-
|
| 149 |
-
|
| 150 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 151 |
|
| 152 |
[*Example 4*:
|
| 153 |
|
| 154 |
``` cpp
|
| 155 |
-
void f(int, const int (&)[2] = {})
|
| 156 |
-
void f(const int&, const int (&)[1])
|
| 157 |
void test() {
|
| 158 |
const int x = 17;
|
| 159 |
auto g = [](auto a) {
|
| 160 |
f(x); // OK: calls #1, does not capture x
|
| 161 |
};
|
| 162 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 163 |
auto g2 = [=](auto a) {
|
| 164 |
int selector[sizeof(a) == 1 ? 1 : 2]{};
|
| 165 |
-
f(x, selector); // OK:
|
|
|
|
|
|
|
|
|
|
|
|
|
| 166 |
};
|
| 167 |
}
|
| 168 |
```
|
| 169 |
|
|
|
|
|
|
|
|
|
|
| 170 |
— *end example*]
|
| 171 |
|
| 172 |
-
|
| 173 |
-
reaching scope of the lambda expression.
|
| 174 |
|
| 175 |
-
|
| 176 |
-
|
| 177 |
-
|
| 178 |
-
in implicit capture. — *end note*]
|
| 179 |
-
|
| 180 |
-
An entity is *captured* if it is captured explicitly or implicitly. An
|
| 181 |
-
entity captured by a *lambda-expression* is odr-used (
|
| 182 |
-
[[basic.def.odr]]) in the scope containing the *lambda-expression*. If
|
| 183 |
-
`*this` is captured by a local lambda expression, its nearest enclosing
|
| 184 |
-
function shall be a non-static member function. If a *lambda-expression*
|
| 185 |
-
or an instantiation of the function call operator template of a generic
|
| 186 |
-
lambda odr-uses ([[basic.def.odr]]) `this` or a variable with automatic
|
| 187 |
-
storage duration from its reaching scope, that entity shall be captured
|
| 188 |
-
by the *lambda-expression*. If a *lambda-expression* captures an entity
|
| 189 |
-
and that entity is not defined or captured in the immediately enclosing
|
| 190 |
-
lambda expression or function, the program is ill-formed.
|
| 191 |
|
| 192 |
[*Example 5*:
|
| 193 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 194 |
``` cpp
|
| 195 |
void f1(int i) {
|
| 196 |
int const N = 20;
|
| 197 |
auto m1 = [=]{
|
| 198 |
int const M = 30;
|
|
@@ -205,14 +230,15 @@ void f1(int i) {
|
|
| 205 |
int f;
|
| 206 |
void work(int n) {
|
| 207 |
int m = n*n;
|
| 208 |
int j = 40;
|
| 209 |
auto m3 = [this,m] {
|
| 210 |
-
auto m4 = [&,j] { // error: j not
|
| 211 |
-
int x = n; // error: n
|
| 212 |
x += m; // OK: m implicitly captured by m4 and explicitly captured by m3
|
| 213 |
-
x += i; // error: i is
|
|
|
|
| 214 |
x += f; // OK: this captured implicitly by m4 and explicitly by m3
|
| 215 |
};
|
| 216 |
};
|
| 217 |
}
|
| 218 |
};
|
|
@@ -222,11 +248,11 @@ struct s2 {
|
|
| 222 |
double ohseven = .007;
|
| 223 |
auto f() {
|
| 224 |
return [this] {
|
| 225 |
return [*this] {
|
| 226 |
return ohseven; // OK
|
| 227 |
-
}
|
| 228 |
}();
|
| 229 |
}
|
| 230 |
auto g() {
|
| 231 |
return [] {
|
| 232 |
return [*this] { }; // error: *this not captured by outer lambda-expression
|
|
@@ -235,23 +261,30 @@ struct s2 {
|
|
| 235 |
};
|
| 236 |
```
|
| 237 |
|
| 238 |
— *end example*]
|
| 239 |
|
| 240 |
-
|
| 241 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 242 |
|
| 243 |
-
[*Example
|
| 244 |
|
| 245 |
``` cpp
|
| 246 |
void f2() {
|
| 247 |
int i = 1;
|
| 248 |
-
void g1(int = ([i]{ return i; })()); //
|
| 249 |
-
void g2(int = ([i]{ return 0; })()); //
|
| 250 |
-
void g3(int = ([=]{ return i; })()); //
|
| 251 |
void g4(int = ([=]{ return 0; })()); // OK
|
| 252 |
void g5(int = ([]{ return sizeof i; })()); // OK
|
|
|
|
|
|
|
| 253 |
}
|
| 254 |
```
|
| 255 |
|
| 256 |
— *end example*]
|
| 257 |
|
|
@@ -269,36 +302,24 @@ the entity is a reference to an object, an lvalue reference to the
|
|
| 269 |
referenced function type if the entity is a reference to a function, or
|
| 270 |
the type of the corresponding captured entity otherwise. A member of an
|
| 271 |
anonymous union shall not be captured by copy.
|
| 272 |
|
| 273 |
Every *id-expression* within the *compound-statement* of a
|
| 274 |
-
*lambda-expression* that is an odr-use
|
| 275 |
captured by copy is transformed into an access to the corresponding
|
| 276 |
unnamed data member of the closure type.
|
| 277 |
|
| 278 |
-
[*Note
|
| 279 |
-
original entity, never to a member of the closure type.
|
| 280 |
-
|
| 281 |
entity. — *end note*]
|
| 282 |
|
| 283 |
-
If `*this` is captured by copy, each odr-
|
| 284 |
-
|
| 285 |
-
|
| 286 |
|
| 287 |
-
[*
|
| 288 |
-
prvalue. — *end note*]
|
| 289 |
-
|
| 290 |
-
An *id-expression* within the *compound-statement* of a
|
| 291 |
-
*lambda-expression* that is an odr-use of a reference captured by
|
| 292 |
-
reference refers to the entity to which the captured reference is bound
|
| 293 |
-
and not to the captured reference.
|
| 294 |
-
|
| 295 |
-
[*Note 7*: The validity of such captures is determined by the lifetime
|
| 296 |
-
of the object to which the reference refers, not by the lifetime of the
|
| 297 |
-
reference itself. — *end note*]
|
| 298 |
-
|
| 299 |
-
[*Example 7*:
|
| 300 |
|
| 301 |
``` cpp
|
| 302 |
void f(const int*);
|
| 303 |
void g() {
|
| 304 |
const int N = 10;
|
|
@@ -306,27 +327,21 @@ void g() {
|
|
| 306 |
int arr[N]; // OK: not an odr-use, refers to automatic variable
|
| 307 |
f(&N); // OK: causes N to be captured; &N points to
|
| 308 |
// the corresponding member of the closure type
|
| 309 |
};
|
| 310 |
}
|
| 311 |
-
auto h(int &r) {
|
| 312 |
-
return [&] {
|
| 313 |
-
++r; // Valid after h returns if the lifetime of the
|
| 314 |
-
// object to which r is bound has not ended
|
| 315 |
-
};
|
| 316 |
-
}
|
| 317 |
```
|
| 318 |
|
| 319 |
— *end example*]
|
| 320 |
|
| 321 |
An entity is *captured by reference* if it is implicitly or explicitly
|
| 322 |
captured but not captured by copy. It is unspecified whether additional
|
| 323 |
unnamed non-static data members are declared in the closure type for
|
| 324 |
entities captured by reference. If declared, such non-static data
|
| 325 |
members shall be of literal type.
|
| 326 |
|
| 327 |
-
[*Example
|
| 328 |
|
| 329 |
``` cpp
|
| 330 |
// The inner closure type must be a literal type regardless of how reference captures are represented.
|
| 331 |
static_assert([](int n) { return [&n] { return ++n; }(); }(3) == 4);
|
| 332 |
```
|
|
@@ -334,22 +349,44 @@ static_assert([](int n) { return [&n] { return ++n; }(); }(3) == 4);
|
|
| 334 |
— *end example*]
|
| 335 |
|
| 336 |
A bit-field or a member of an anonymous union shall not be captured by
|
| 337 |
reference.
|
| 338 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 339 |
If a *lambda-expression* `m2` captures an entity and that entity is
|
| 340 |
captured by an immediately enclosing *lambda-expression* `m1`, then
|
| 341 |
`m2`’s capture is transformed as follows:
|
| 342 |
|
| 343 |
- if `m1` captures the entity by copy, `m2` captures the corresponding
|
| 344 |
non-static data member of `m1`’s closure type;
|
| 345 |
- if `m1` captures the entity by reference, `m2` captures the same
|
| 346 |
entity captured by `m1`.
|
| 347 |
|
| 348 |
-
[*Example
|
| 349 |
|
| 350 |
-
The nested lambda
|
| 351 |
`123234`.
|
| 352 |
|
| 353 |
``` cpp
|
| 354 |
int a = 1, b = 1, c = 1;
|
| 355 |
auto m1 = [a, &b, &c]() mutable {
|
|
@@ -365,61 +402,43 @@ m1();
|
|
| 365 |
std::cout << a << b << c;
|
| 366 |
```
|
| 367 |
|
| 368 |
— *end example*]
|
| 369 |
|
| 370 |
-
Every occurrence of `decltype((x))` where `x` is a possibly
|
| 371 |
-
parenthesized *id-expression* that names an entity of automatic storage
|
| 372 |
-
duration is treated as if `x` were transformed into an access to a
|
| 373 |
-
corresponding data member of the closure type that would have been
|
| 374 |
-
declared if `x` were an odr-use of the denoted entity.
|
| 375 |
-
|
| 376 |
-
[*Example 10*:
|
| 377 |
-
|
| 378 |
-
``` cpp
|
| 379 |
-
void f3() {
|
| 380 |
-
float x, &r = x;
|
| 381 |
-
[=] { // x and r are not captured (appearance in a decltype operand is not an odr-use)
|
| 382 |
-
decltype(x) y1; // y1 has type float
|
| 383 |
-
decltype((x)) y2 = y1; // y2 has type float const& because this lambda is not mutable and x is an lvalue
|
| 384 |
-
decltype(r) r1 = y1; // r1 has type float& (transformation not considered)
|
| 385 |
-
decltype((r)) r2 = y2; // r2 has type float const&
|
| 386 |
-
};
|
| 387 |
-
}
|
| 388 |
-
```
|
| 389 |
-
|
| 390 |
-
— *end example*]
|
| 391 |
-
|
| 392 |
When the *lambda-expression* is evaluated, the entities that are
|
| 393 |
captured by copy are used to direct-initialize each corresponding
|
| 394 |
non-static data member of the resulting closure object, and the
|
| 395 |
non-static data members corresponding to the *init-capture*s are
|
| 396 |
initialized as indicated by the corresponding *initializer* (which may
|
| 397 |
be copy- or direct-initialization). (For array members, the array
|
| 398 |
elements are direct-initialized in increasing subscript order.) These
|
| 399 |
initializations are performed in the (unspecified) order in which the
|
| 400 |
non-static data members are declared.
|
| 401 |
|
| 402 |
-
[*Note
|
| 403 |
order of the constructions. — *end note*]
|
| 404 |
|
| 405 |
-
[*Note
|
| 406 |
captured by reference, invoking the function call operator of the
|
| 407 |
corresponding *lambda-expression* after the lifetime of the entity has
|
| 408 |
ended is likely to result in undefined behavior. — *end note*]
|
| 409 |
|
| 410 |
-
A *simple-capture*
|
| 411 |
-
[[temp.variadic]]
|
| 412 |
-
|
|
|
|
| 413 |
|
| 414 |
-
[*Example
|
| 415 |
|
| 416 |
``` cpp
|
| 417 |
template<class... Args>
|
| 418 |
void f(Args... args) {
|
| 419 |
auto lm = [&, args...] { return g(args...); };
|
| 420 |
lm();
|
|
|
|
|
|
|
|
|
|
| 421 |
}
|
| 422 |
```
|
| 423 |
|
| 424 |
— *end example*]
|
| 425 |
|
|
|
|
| 13 |
'='
|
| 14 |
```
|
| 15 |
|
| 16 |
``` bnf
|
| 17 |
capture-list:
|
| 18 |
+
capture
|
| 19 |
+
capture-list ',' capture
|
| 20 |
```
|
| 21 |
|
| 22 |
``` bnf
|
| 23 |
capture:
|
| 24 |
simple-capture
|
| 25 |
init-capture
|
| 26 |
```
|
| 27 |
|
| 28 |
``` bnf
|
| 29 |
simple-capture:
|
| 30 |
+
identifier '...'ₒₚₜ
|
| 31 |
+
'&' identifier '...'ₒₚₜ
|
| 32 |
+
this
|
| 33 |
+
'*' 'this'
|
| 34 |
```
|
| 35 |
|
| 36 |
``` bnf
|
| 37 |
init-capture:
|
| 38 |
+
'...'ₒₚₜ identifier initializer
|
| 39 |
+
'&' '...'ₒₚₜ identifier initializer
|
| 40 |
```
|
| 41 |
|
| 42 |
The body of a *lambda-expression* may refer to variables with automatic
|
| 43 |
storage duration and the `*this` object (if any) of enclosing block
|
| 44 |
scopes by capturing those entities, as described below.
|
| 45 |
|
| 46 |
If a *lambda-capture* includes a *capture-default* that is `&`, no
|
| 47 |
identifier in a *simple-capture* of that *lambda-capture* shall be
|
| 48 |
preceded by `&`. If a *lambda-capture* includes a *capture-default* that
|
| 49 |
is `=`, each *simple-capture* of that *lambda-capture* shall be of the
|
| 50 |
+
form “`&` *identifier* `...`ₒₚₜ ”, “`this`”, or “`* this`”.
|
| 51 |
|
| 52 |
[*Note 1*: The form `[&,this]` is redundant but accepted for
|
| 53 |
compatibility with ISO C++14. — *end note*]
|
| 54 |
|
| 55 |
Ignoring appearances in *initializer*s of *init-capture*s, an identifier
|
|
|
|
| 59 |
|
| 60 |
``` cpp
|
| 61 |
struct S2 { void f(int i); };
|
| 62 |
void S2::f(int i) {
|
| 63 |
[&, i]{ }; // OK
|
| 64 |
+
[&, this, i]{ }; // OK, equivalent to [&, i]
|
| 65 |
[&, &i]{ }; // error: i preceded by & when & is the default
|
| 66 |
[=, *this]{ }; // OK
|
| 67 |
+
[=, this]{ }; // OK, equivalent to [=]
|
| 68 |
[i, i]{ }; // error: i repeated
|
| 69 |
[this, *this]{ }; // error: this appears twice
|
| 70 |
}
|
| 71 |
```
|
| 72 |
|
| 73 |
— *end example*]
|
| 74 |
|
| 75 |
+
A *lambda-expression* shall not have a *capture-default* or
|
| 76 |
+
*simple-capture* in its *lambda-introducer* unless its innermost
|
| 77 |
+
enclosing scope is a block scope [[basic.scope.block]] or it appears
|
| 78 |
+
within a default member initializer and its innermost enclosing scope is
|
| 79 |
+
the corresponding class scope [[basic.scope.class]].
|
|
|
|
|
|
|
|
|
|
|
|
|
| 80 |
|
| 81 |
The *identifier* in a *simple-capture* is looked up using the usual
|
| 82 |
+
rules for unqualified name lookup [[basic.lookup.unqual]]; each such
|
| 83 |
+
lookup shall find a local entity. The *simple-capture*s `this` and
|
| 84 |
+
`* this` denote the local entity `*this`. An entity that is designated
|
| 85 |
+
by a *simple-capture* is said to be *explicitly captured*.
|
|
|
|
|
|
|
| 86 |
|
| 87 |
If an *identifier* in a *simple-capture* appears as the *declarator-id*
|
| 88 |
of a parameter of the *lambda-declarator*'s
|
| 89 |
*parameter-declaration-clause*, the program is ill-formed.
|
| 90 |
|
| 91 |
[*Example 2*:
|
| 92 |
|
| 93 |
``` cpp
|
| 94 |
void f() {
|
| 95 |
int x = 0;
|
| 96 |
+
auto g = [x](int x) { return 0; }; // error: parameter and simple-capture have the same name
|
| 97 |
}
|
| 98 |
```
|
| 99 |
|
| 100 |
— *end example*]
|
| 101 |
|
| 102 |
+
An *init-capture* without ellipsis behaves as if it declares and
|
| 103 |
+
explicitly captures a variable of the form “`auto` *init-capture* `;`”
|
| 104 |
+
whose declarative region is the *lambda-expression*’s
|
| 105 |
+
*compound-statement*, except that:
|
| 106 |
|
| 107 |
- if the capture is by copy (see below), the non-static data member
|
| 108 |
declared for the capture and the variable are treated as two different
|
| 109 |
ways of referring to the same object, which has the lifetime of the
|
| 110 |
non-static data member, and no additional copy and destruction is
|
| 111 |
performed, and
|
| 112 |
- if the capture is by reference, the variable’s lifetime ends when the
|
| 113 |
closure object’s lifetime ends.
|
| 114 |
|
| 115 |
+
[*Note 2*: This enables an *init-capture* like “`x = std::move(x)`”;
|
| 116 |
the second “`x`” must bind to a declaration in the surrounding
|
| 117 |
context. — *end note*]
|
| 118 |
|
| 119 |
[*Example 3*:
|
| 120 |
|
|
|
|
| 123 |
auto y = [&r = x, x = x+1]()->int {
|
| 124 |
r += 2;
|
| 125 |
return x+2;
|
| 126 |
}(); // Updates ::x to 6, and initializes y to 7.
|
| 127 |
|
| 128 |
+
auto z = [a = 42](int a) { return 1; }; // error: parameter and local variable have the same name
|
| 129 |
```
|
| 130 |
|
| 131 |
— *end example*]
|
| 132 |
|
| 133 |
+
For the purposes of lambda capture, an expression potentially references
|
| 134 |
+
local entities as follows:
|
|
|
|
|
|
|
|
|
|
|
|
|
| 135 |
|
| 136 |
+
- An *id-expression* that names a local entity potentially references
|
| 137 |
+
that entity; an *id-expression* that names one or more non-static
|
| 138 |
+
class members and does not form a pointer to member [[expr.unary.op]]
|
| 139 |
+
potentially references `*this`. \[*Note 3*: This occurs even if
|
| 140 |
+
overload resolution selects a static member function for the
|
| 141 |
+
*id-expression*. — *end note*]
|
| 142 |
+
- A `this` expression potentially references `*this`.
|
| 143 |
+
- A *lambda-expression* potentially references the local entities named
|
| 144 |
+
by its *simple-capture*s.
|
| 145 |
+
|
| 146 |
+
If an expression potentially references a local entity within a
|
| 147 |
+
declarative region in which it is odr-usable, and the expression would
|
| 148 |
+
be potentially evaluated if the effect of any enclosing `typeid`
|
| 149 |
+
expressions [[expr.typeid]] were ignored, the entity is said to be
|
| 150 |
+
*implicitly captured* by each intervening *lambda-expression* with an
|
| 151 |
+
associated *capture-default* that does not explicitly capture it. The
|
| 152 |
+
implicit capture of `*this` is deprecated when the *capture-default* is
|
| 153 |
+
`=`; see [[depr.capture.this]].
|
| 154 |
|
| 155 |
[*Example 4*:
|
| 156 |
|
| 157 |
``` cpp
|
| 158 |
+
void f(int, const int (&)[2] = {}); // #1
|
| 159 |
+
void f(const int&, const int (&)[1]); // #2
|
| 160 |
void test() {
|
| 161 |
const int x = 17;
|
| 162 |
auto g = [](auto a) {
|
| 163 |
f(x); // OK: calls #1, does not capture x
|
| 164 |
};
|
| 165 |
|
| 166 |
+
auto g1 = [=](auto a) {
|
| 167 |
+
f(x); // OK: calls #1, captures x
|
| 168 |
+
};
|
| 169 |
+
|
| 170 |
auto g2 = [=](auto a) {
|
| 171 |
int selector[sizeof(a) == 1 ? 1 : 2]{};
|
| 172 |
+
f(x, selector); // OK: captures x, might call #1 or #2
|
| 173 |
+
};
|
| 174 |
+
|
| 175 |
+
auto g3 = [=](auto a) {
|
| 176 |
+
typeid(a + x); // captures x regardless of whether a + x is an unevaluated operand
|
| 177 |
};
|
| 178 |
}
|
| 179 |
```
|
| 180 |
|
| 181 |
+
Within `g1`, an implementation might optimize away the capture of `x` as
|
| 182 |
+
it is not odr-used.
|
| 183 |
+
|
| 184 |
— *end example*]
|
| 185 |
|
| 186 |
+
[*Note 4*:
|
|
|
|
| 187 |
|
| 188 |
+
The set of captured entities is determined syntactically, and entities
|
| 189 |
+
might be implicitly captured even if the expression denoting a local
|
| 190 |
+
entity is within a discarded statement [[stmt.if]].
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 191 |
|
| 192 |
[*Example 5*:
|
| 193 |
|
| 194 |
+
``` cpp
|
| 195 |
+
template<bool B>
|
| 196 |
+
void f(int n) {
|
| 197 |
+
[=](auto a) {
|
| 198 |
+
if constexpr (B && sizeof(a) > 4) {
|
| 199 |
+
(void)n; // captures n regardless of the value of B and sizeof(int)
|
| 200 |
+
}
|
| 201 |
+
}(0);
|
| 202 |
+
}
|
| 203 |
+
```
|
| 204 |
+
|
| 205 |
+
— *end example*]
|
| 206 |
+
|
| 207 |
+
— *end note*]
|
| 208 |
+
|
| 209 |
+
An entity is *captured* if it is captured explicitly or implicitly. An
|
| 210 |
+
entity captured by a *lambda-expression* is odr-used [[basic.def.odr]]
|
| 211 |
+
in the scope containing the *lambda-expression*.
|
| 212 |
+
|
| 213 |
+
[*Note 5*: As a consequence, if a *lambda-expression* explicitly
|
| 214 |
+
captures an entity that is not odr-usable, the program is ill-formed
|
| 215 |
+
[[basic.def.odr]]. — *end note*]
|
| 216 |
+
|
| 217 |
+
[*Example 6*:
|
| 218 |
+
|
| 219 |
``` cpp
|
| 220 |
void f1(int i) {
|
| 221 |
int const N = 20;
|
| 222 |
auto m1 = [=]{
|
| 223 |
int const M = 30;
|
|
|
|
| 230 |
int f;
|
| 231 |
void work(int n) {
|
| 232 |
int m = n*n;
|
| 233 |
int j = 40;
|
| 234 |
auto m3 = [this,m] {
|
| 235 |
+
auto m4 = [&,j] { // error: j not odr-usable due to intervening lambda m3
|
| 236 |
+
int x = n; // error: n is odr-used but not odr-usable due to intervening lambda m3
|
| 237 |
x += m; // OK: m implicitly captured by m4 and explicitly captured by m3
|
| 238 |
+
x += i; // error: i is odr-used but not odr-usable
|
| 239 |
+
// due to intervening function and class scopes
|
| 240 |
x += f; // OK: this captured implicitly by m4 and explicitly by m3
|
| 241 |
};
|
| 242 |
};
|
| 243 |
}
|
| 244 |
};
|
|
|
|
| 248 |
double ohseven = .007;
|
| 249 |
auto f() {
|
| 250 |
return [this] {
|
| 251 |
return [*this] {
|
| 252 |
return ohseven; // OK
|
| 253 |
+
};
|
| 254 |
}();
|
| 255 |
}
|
| 256 |
auto g() {
|
| 257 |
return [] {
|
| 258 |
return [*this] { }; // error: *this not captured by outer lambda-expression
|
|
|
|
| 261 |
};
|
| 262 |
```
|
| 263 |
|
| 264 |
— *end example*]
|
| 265 |
|
| 266 |
+
[*Note 6*: Because local entities are not odr-usable within a default
|
| 267 |
+
argument [[basic.def.odr]], a *lambda-expression* appearing in a default
|
| 268 |
+
argument cannot implicitly or explicitly capture any local entity. Such
|
| 269 |
+
a *lambda-expression* can still have an *init-capture* if any
|
| 270 |
+
full-expression in its *initializer* satisfies the constraints of an
|
| 271 |
+
expression appearing in a default argument
|
| 272 |
+
[[dcl.fct.default]]. — *end note*]
|
| 273 |
|
| 274 |
+
[*Example 7*:
|
| 275 |
|
| 276 |
``` cpp
|
| 277 |
void f2() {
|
| 278 |
int i = 1;
|
| 279 |
+
void g1(int = ([i]{ return i; })()); // error
|
| 280 |
+
void g2(int = ([i]{ return 0; })()); // error
|
| 281 |
+
void g3(int = ([=]{ return i; })()); // error
|
| 282 |
void g4(int = ([=]{ return 0; })()); // OK
|
| 283 |
void g5(int = ([]{ return sizeof i; })()); // OK
|
| 284 |
+
void g6(int = ([x=1]{ return x; })()); // OK
|
| 285 |
+
void g7(int = ([x=i]{ return x; })()); // error
|
| 286 |
}
|
| 287 |
```
|
| 288 |
|
| 289 |
— *end example*]
|
| 290 |
|
|
|
|
| 302 |
referenced function type if the entity is a reference to a function, or
|
| 303 |
the type of the corresponding captured entity otherwise. A member of an
|
| 304 |
anonymous union shall not be captured by copy.
|
| 305 |
|
| 306 |
Every *id-expression* within the *compound-statement* of a
|
| 307 |
+
*lambda-expression* that is an odr-use [[basic.def.odr]] of an entity
|
| 308 |
captured by copy is transformed into an access to the corresponding
|
| 309 |
unnamed data member of the closure type.
|
| 310 |
|
| 311 |
+
[*Note 7*: An *id-expression* that is not an odr-use refers to the
|
| 312 |
+
original entity, never to a member of the closure type. However, such an
|
| 313 |
+
*id-expression* can still cause the implicit capture of the
|
| 314 |
entity. — *end note*]
|
| 315 |
|
| 316 |
+
If `*this` is captured by copy, each expression that odr-uses `*this` is
|
| 317 |
+
transformed to instead refer to the corresponding unnamed data member of
|
| 318 |
+
the closure type.
|
| 319 |
|
| 320 |
+
[*Example 8*:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 321 |
|
| 322 |
``` cpp
|
| 323 |
void f(const int*);
|
| 324 |
void g() {
|
| 325 |
const int N = 10;
|
|
|
|
| 327 |
int arr[N]; // OK: not an odr-use, refers to automatic variable
|
| 328 |
f(&N); // OK: causes N to be captured; &N points to
|
| 329 |
// the corresponding member of the closure type
|
| 330 |
};
|
| 331 |
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 332 |
```
|
| 333 |
|
| 334 |
— *end example*]
|
| 335 |
|
| 336 |
An entity is *captured by reference* if it is implicitly or explicitly
|
| 337 |
captured but not captured by copy. It is unspecified whether additional
|
| 338 |
unnamed non-static data members are declared in the closure type for
|
| 339 |
entities captured by reference. If declared, such non-static data
|
| 340 |
members shall be of literal type.
|
| 341 |
|
| 342 |
+
[*Example 9*:
|
| 343 |
|
| 344 |
``` cpp
|
| 345 |
// The inner closure type must be a literal type regardless of how reference captures are represented.
|
| 346 |
static_assert([](int n) { return [&n] { return ++n; }(); }(3) == 4);
|
| 347 |
```
|
|
|
|
| 349 |
— *end example*]
|
| 350 |
|
| 351 |
A bit-field or a member of an anonymous union shall not be captured by
|
| 352 |
reference.
|
| 353 |
|
| 354 |
+
An *id-expression* within the *compound-statement* of a
|
| 355 |
+
*lambda-expression* that is an odr-use of a reference captured by
|
| 356 |
+
reference refers to the entity to which the captured reference is bound
|
| 357 |
+
and not to the captured reference.
|
| 358 |
+
|
| 359 |
+
[*Note 8*: The validity of such captures is determined by the lifetime
|
| 360 |
+
of the object to which the reference refers, not by the lifetime of the
|
| 361 |
+
reference itself. — *end note*]
|
| 362 |
+
|
| 363 |
+
[*Example 10*:
|
| 364 |
+
|
| 365 |
+
``` cpp
|
| 366 |
+
auto h(int &r) {
|
| 367 |
+
return [&] {
|
| 368 |
+
++r; // Valid after h returns if the lifetime of the
|
| 369 |
+
// object to which r is bound has not ended
|
| 370 |
+
};
|
| 371 |
+
}
|
| 372 |
+
```
|
| 373 |
+
|
| 374 |
+
— *end example*]
|
| 375 |
+
|
| 376 |
If a *lambda-expression* `m2` captures an entity and that entity is
|
| 377 |
captured by an immediately enclosing *lambda-expression* `m1`, then
|
| 378 |
`m2`’s capture is transformed as follows:
|
| 379 |
|
| 380 |
- if `m1` captures the entity by copy, `m2` captures the corresponding
|
| 381 |
non-static data member of `m1`’s closure type;
|
| 382 |
- if `m1` captures the entity by reference, `m2` captures the same
|
| 383 |
entity captured by `m1`.
|
| 384 |
|
| 385 |
+
[*Example 11*:
|
| 386 |
|
| 387 |
+
The nested *lambda-expression*s and invocations below will output
|
| 388 |
`123234`.
|
| 389 |
|
| 390 |
``` cpp
|
| 391 |
int a = 1, b = 1, c = 1;
|
| 392 |
auto m1 = [a, &b, &c]() mutable {
|
|
|
|
| 402 |
std::cout << a << b << c;
|
| 403 |
```
|
| 404 |
|
| 405 |
— *end example*]
|
| 406 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 407 |
When the *lambda-expression* is evaluated, the entities that are
|
| 408 |
captured by copy are used to direct-initialize each corresponding
|
| 409 |
non-static data member of the resulting closure object, and the
|
| 410 |
non-static data members corresponding to the *init-capture*s are
|
| 411 |
initialized as indicated by the corresponding *initializer* (which may
|
| 412 |
be copy- or direct-initialization). (For array members, the array
|
| 413 |
elements are direct-initialized in increasing subscript order.) These
|
| 414 |
initializations are performed in the (unspecified) order in which the
|
| 415 |
non-static data members are declared.
|
| 416 |
|
| 417 |
+
[*Note 9*: This ensures that the destructions will occur in the reverse
|
| 418 |
order of the constructions. — *end note*]
|
| 419 |
|
| 420 |
+
[*Note 10*: If a non-reference entity is implicitly or explicitly
|
| 421 |
captured by reference, invoking the function call operator of the
|
| 422 |
corresponding *lambda-expression* after the lifetime of the entity has
|
| 423 |
ended is likely to result in undefined behavior. — *end note*]
|
| 424 |
|
| 425 |
+
A *simple-capture* containing an ellipsis is a pack expansion
|
| 426 |
+
[[temp.variadic]]. An *init-capture* containing an ellipsis is a pack
|
| 427 |
+
expansion that introduces an *init-capture* pack [[temp.variadic]] whose
|
| 428 |
+
declarative region is the *lambda-expression*’s *compound-statement*.
|
| 429 |
|
| 430 |
+
[*Example 12*:
|
| 431 |
|
| 432 |
``` cpp
|
| 433 |
template<class... Args>
|
| 434 |
void f(Args... args) {
|
| 435 |
auto lm = [&, args...] { return g(args...); };
|
| 436 |
lm();
|
| 437 |
+
|
| 438 |
+
auto lm2 = [...xs=std::move(args)] { return g(xs...); };
|
| 439 |
+
lm2();
|
| 440 |
}
|
| 441 |
```
|
| 442 |
|
| 443 |
— *end example*]
|
| 444 |
|