std::basic_string<CharT,Traits,Allocator>::max_size (3) - Linux Manuals

std::basic_string<CharT,Traits,Allocator>::max_size: std::basic_string<CharT,Traits,Allocator>::max_size

NAME

std::basic_string<CharT,Traits,Allocator>::max_size - std::basic_string<CharT,Traits,Allocator>::max_size

Synopsis

size_type max_size() const; (until C++11)
size_type max_size() const noexcept; (since C++11)

Returns the maximum number of elements the string is able to hold due to system or library implementation limitations, i.e. std::distance(begin(), end()) for the largest string.

Parameters

(none)

Return value

Maximum number of characters

Complexity

Constant.

Example

// Run this code

  #include <iostream>
  #include <string>

  int main()
  {
      std::string s;
      std::cout << "Maximum size of a string is " << s.max_size() << "\n";
  }

Possible output:

  Maximum size of a string is 4294967294