cpp / latest / string / basic_string_view / begin.html /

std::basic_string_view<CharT,Traits>::begin, std::basic_string_view<CharT,Traits>::cbegin

constexpr const_iterator begin() const noexcept;
(since C++17)
constexpr const_iterator cbegin() const noexcept;
(since C++17)

Returns an iterator to the first character of the view.

range-begin-end.svg

Parameters

(none).

Return value

const_iterator to the first character.

Complexity

Constant.

Example

#include <iostream>
#include <string_view>
#include <type_traits>
 
int main()
{
    std::string_view str_view("abcd");
 
    auto begin = str_view.begin();
    auto cbegin = str_view.cbegin();
 
    std::cout << *begin << '\n';
    std::cout << *cbegin << '\n';
 
    std::cout << std::boolalpha << (begin == cbegin) << '\n';
    std::cout << std::boolalpha << (*begin == *cbegin) << '\n';
 
    static_assert(std::is_same<decltype(begin), decltype(cbegin)>{});
}

Output:

a
a
true
true

See also

(C++17)
returns an iterator to the end
(public member function)
(C++11)
returns an iterator to the beginning
(public member function of std::basic_string<CharT,Traits,Allocator>)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string_view/begin