# std::basic_stacktrace<Allocator>::begin, std::basic_stacktrace<Allocator>::cbegin

> C++ Atlas: `cppatlas.com/w/cpp/utility/basic_stacktrace/begin` | Source: https://en.cppreference.com/w/cpp/utility/basic_stacktrace/begin | Domain: Utility | Standards: C++23

Returns an iterator to the first entry of the basic_stacktrace.

## Official Specification Summary (cppreference)

```cpp
const_iterator begin()  const noexcept; // (1) (since C++23)
const_iterator cbegin() const noexcept; // (2) (since C++23)
```

Returns an iterator to the first entry of the `basic_stacktrace`.

If the `basic_stacktrace` is empty, the returned iterator is equal to `end()`.

### Parameters

(none)

### Return value

Iterator to the first entry.

### Complexity

Constant.

### Example

```cpp
#include <algorithm>
#include <iostream>
#include <stacktrace>

int main()
{
    auto trace       = std::stacktrace::current();
    auto empty_trace = std::stacktrace{};

    // Print stacktrace.
    std::for_each(trace.begin(), trace.end(),
                  [](const auto& f) { std::cout << f << '\n'; });

    if (empty_trace.begin() == empty_trace.end())
        std::cout << "stacktrace 'empty_trace' is indeed empty.\n";
}
```

Possible output:

```text
0x0000000000402BA8 in ./prog.exe
__libc_start_main in /lib/x86_64-linux-gnu/libc.so.6
0x0000000000402A29 in ./prog.exe
stacktrace 'empty_trace' is indeed empty.
```

### See also

- [`end`](https://en.cppreference.com/w/cpp/utility/basic_stacktrace/end), [`cend`](https://en.cppreference.com/w/cpp/utility/basic_stacktrace/end): returns an iterator to the end (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/utility/basic_stacktrace/begin (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.