public member function

std::basic_string::size

size_type size() const noexcept;

Return size

Returns the length of the string, in terms of number of characters.

This is the number of actual characters that conform the contents of the basic_string, which is not necessarily equal to its storage capacity.

Both

basic_string::size and basic_string::length are synonyms and return the same value.

Parameters

none

Return Value

The number of characters in the string.

Member type

size_type is an unsigned integral type.

Example

// string::size
#include <iostream>
#include <string>

int main ()
{
  std::string str ("Test string");
  std::cout << "The size of str is " << str.size() << " characters.\n";
  return 0;
}

Output:

The size of str is 11 characters

Complexity

Iterator validity

No changes.

Data races

The object is accessed.

Exception safety

No-throw guarantee: this member function never throws exceptions.