Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
Miscellaneous
Miscellaneous
complex
exception
functional
iterator
limits
locale
memory
new
numeric
stdexcept
typeinfo
utility
valarray
locale
has_facet
isalnum
isalpha
iscntrl
isdigit
isgraph
islower
isprint
ispunct
isspace
isupper
isxdigit
locale
tolower
toupper
use_facet
standard facets:
codecvt
codecvt_base
codecvt_byname
collate
collate_byname
ctype
ctype_base
ctype_byname
messages
messages_base
messages_byname
moneypunct
moneypunct_byname
money_base
money_get
money_put
numpunct
numpunct_byname
num_get
num_put
time_base
time_get
time_get_byname
time_put
time_put_byname
codecvt
codecvt::codecvt
public member functions:
codecvt::always_noconv
codecvt::encoding
codecvt::in
codecvt::length
codecvt::max_length
codecvt::out
codecvt::unshift
public member types:
codecvt::extern_type
codecvt::intern_type
codecvt::result
codecvt::state_type
protected members:
codecvt::do_always_noconv
codecvt::do_encoding
codecvt::do_in
codecvt::do_length
codecvt::do_max_length
codecvt::do_out
codecvt::do_unshift
codecvt::~codecvt


codecvt::max_length

public member function
int max_length ( ) const throw();

Return max length of one character

Returns the maximum amount of external characters needed for one internal character.

During its operation, this function simply calls the virtual protected member codecvt::do_max_length, which is the member function in charge of performing the actions described above.

Parameters

none

Return value

The maximum length of one external character if translated to internal characters.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
// codecvt::max_length example
#include <iostream>
#include <locale>
using namespace std;
int main ()
{
  locale loc;
  cout << "max_length for codecvt<char,char,mbstate_t>: ";
  cout << use_facet<codecvt<char,char,mbstate_t> >(loc).max_length();
  cout << endl;
  cout << "max_length for codecvt<wchar_t,char,mbstate_t>: ";
  cout << use_facet<codecvt<wchar_t,char,mbstate_t> >(loc).max_length();
  cout << endl;
  return 0;
} 


Output:

max_length for codecvt<char,char,mbstate_t>: 1
max_length for codecvt<wchar_t,char,mbstate_t>: 5

See also