From Jason Turner

[stacktrace.basic.cons]

C++23 → Trunk 3.2 KB 31 lines
Current Draft | LaTeX Source
Archived: C++23
Markdown: C++23 | Trunk
Explore in Adventure Game

Diff to HTML by rtfpessoa

Files changed (1) hide show
  1. tmp/tmpb1ka6d63/{from.md → to.md} +14 -13
tmp/tmpb1ka6d63/{from.md → to.md} RENAMED
@@ -2,48 +2,49 @@
2
 
3
  ``` cpp
4
  static basic_stacktrace current(const allocator_type& alloc = allocator_type()) noexcept;
5
  ```
6
 
7
- *Returns:* A `basic_stacktrace` object with `frames_` storing the
8
  stacktrace of the current evaluation in the current thread of execution,
9
- or an empty `basic_stacktrace` object if the initialization of `frames_`
10
- failed. `alloc` is passed to the constructor of the `frames_` object.
 
11
 
12
  [*Note 1*: If the stacktrace was successfully obtained, then
13
- `frames_.front()` is the `stacktrace_entry` representing approximately
14
- the current evaluation, and `frames_.back()` is the `stacktrace_entry`
15
- representing approximately the initial function of the current thread of
16
- execution. — *end note*]
17
 
18
  ``` cpp
19
  static basic_stacktrace current(size_type skip,
20
  const allocator_type& alloc = allocator_type()) noexcept;
21
  ```
22
 
23
  Let `t` be a stacktrace as-if obtained via
24
  `basic_stacktrace::current(alloc)`. Let `n` be `t.size()`.
25
 
26
- *Returns:* A `basic_stacktrace` object where `frames_` is
27
  direct-non-list-initialized from arguments `t.begin() + min(n, skip)`,
28
  `t.end()`, and `alloc`, or an empty `basic_stacktrace` object if the
29
- initialization of `frames_` failed.
30
 
31
  ``` cpp
32
  static basic_stacktrace current(size_type skip, size_type max_depth,
33
  const allocator_type& alloc = allocator_type()) noexcept;
34
  ```
35
 
36
  Let `t` be a stacktrace as-if obtained via
37
  `basic_stacktrace::current(alloc)`. Let `n` be `t.size()`.
38
 
39
- *Preconditions:* `skip <= skip + max_depth` is `true`.
40
 
41
- *Returns:* A `basic_stacktrace` object where `frames_` is
42
  direct-non-list-initialized from arguments `t.begin() + min(n, skip)`,
43
  `t.begin() + min(n, skip + max_depth)`, and `alloc`, or an empty
44
- `basic_stacktrace` object if the initialization of `frames_` failed.
45
 
46
  ``` cpp
47
  basic_stacktrace() noexcept(is_nothrow_default_constructible_v<allocator_type>);
48
  ```
49
 
@@ -51,11 +52,11 @@ basic_stacktrace() noexcept(is_nothrow_default_constructible_v<allocator_type>);
51
 
52
  ``` cpp
53
  explicit basic_stacktrace(const allocator_type& alloc) noexcept;
54
  ```
55
 
56
- *Effects:* `alloc` is passed to the `frames_` constructor.
57
 
58
  *Ensures:* `empty()` is `true`.
59
 
60
  ``` cpp
61
  basic_stacktrace(const basic_stacktrace& other);
 
2
 
3
  ``` cpp
4
  static basic_stacktrace current(const allocator_type& alloc = allocator_type()) noexcept;
5
  ```
6
 
7
+ *Returns:* A `basic_stacktrace` object with *frames\_* storing the
8
  stacktrace of the current evaluation in the current thread of execution,
9
+ or an empty `basic_stacktrace` object if the initialization of
10
+ *frames\_* failed. `alloc` is passed to the constructor of the
11
+ *frames\_* object.
12
 
13
  [*Note 1*: If the stacktrace was successfully obtained, then
14
+ *`frames_`*`.front()` is the `stacktrace_entry` representing
15
+ approximately the current evaluation, and *`frames_`*`.back()` is the
16
+ `stacktrace_entry` representing approximately the initial function of
17
+ the current thread of execution. — *end note*]
18
 
19
  ``` cpp
20
  static basic_stacktrace current(size_type skip,
21
  const allocator_type& alloc = allocator_type()) noexcept;
22
  ```
23
 
24
  Let `t` be a stacktrace as-if obtained via
25
  `basic_stacktrace::current(alloc)`. Let `n` be `t.size()`.
26
 
27
+ *Returns:* A `basic_stacktrace` object where *frames\_* is
28
  direct-non-list-initialized from arguments `t.begin() + min(n, skip)`,
29
  `t.end()`, and `alloc`, or an empty `basic_stacktrace` object if the
30
+ initialization of *frames\_* failed.
31
 
32
  ``` cpp
33
  static basic_stacktrace current(size_type skip, size_type max_depth,
34
  const allocator_type& alloc = allocator_type()) noexcept;
35
  ```
36
 
37
  Let `t` be a stacktrace as-if obtained via
38
  `basic_stacktrace::current(alloc)`. Let `n` be `t.size()`.
39
 
40
+ `skip <= skip + max_depth` is `true`.
41
 
42
+ *Returns:* A `basic_stacktrace` object where *frames\_* is
43
  direct-non-list-initialized from arguments `t.begin() + min(n, skip)`,
44
  `t.begin() + min(n, skip + max_depth)`, and `alloc`, or an empty
45
+ `basic_stacktrace` object if the initialization of *frames\_* failed.
46
 
47
  ``` cpp
48
  basic_stacktrace() noexcept(is_nothrow_default_constructible_v<allocator_type>);
49
  ```
50
 
 
52
 
53
  ``` cpp
54
  explicit basic_stacktrace(const allocator_type& alloc) noexcept;
55
  ```
56
 
57
+ *Effects:* `alloc` is passed to the *frames\_* constructor.
58
 
59
  *Ensures:* `empty()` is `true`.
60
 
61
  ``` cpp
62
  basic_stacktrace(const basic_stacktrace& other);