# std::basic_string<CharT,Traits,Allocator>::begin, std::basic_string<CharT,Traits,Allocator>::cbegin

> C++ Atlas: `cppatlas.com/w/cpp/string/basic_string/begin` | Source: https://en.cppreference.com/w/cpp/string/basic_string/begin | Domain: Strings | Standards: C++11, C++20

Returns an iterator to the first character of the string.

## Official Specification Summary (cppreference)

```cpp
iterator begin(); // (1) (noexcept since C++11) (constexpr since C++20)
const_iterator begin() const; // (2) (noexcept since C++11) (constexpr since C++20)
const_iterator cbegin() const noexcept; // (3) (since C++11) (constexpr since C++20)
```

Returns an iterator to the first character of the string.

`begin()` returns a mutable or constant iterator, depending on the constness of `*this`.

`cbegin()` always returns a constant iterator. It is equivalent to `const_cast<const basic_string&>(*this).begin()`.

### Parameters

(none)

### Return value

Iterator to the first character.

### Complexity

Constant.

### Notes

libc++ backports `cbegin()` to C++98 mode.

### Example

```cpp
#include <iostream>
#include <string>

int main()
{
    std::string s("Exemplar");
    *s.begin() = 'e';
    std::cout << s << '\n';

    auto i = s.cbegin();
    std::cout << *i << '\n';
//  *i = 'E'; // error: i is a constant iterator
}
```

Output:

```text
exemplar
e
```

### See also

- [`end`](https://en.cppreference.com/w/cpp/string/basic_string/end), [`cend`](https://en.cppreference.com/w/cpp/string/basic_string/end) (C++11): returns an iterator to the end (public member function)
- [`begin`](https://en.cppreference.com/w/cpp/string/basic_string_view/begin), [`cbegin`](https://en.cppreference.com/w/cpp/string/basic_string_view/begin): returns an iterator to the beginning (public member function of `std::basic_string_view<CharT,Traits>`)

---
Attribution: content from https://en.cppreference.com/w/cpp/string/basic_string/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.