75. Contradiction in codecvt::length's argument types

Section: [locale.codecvt] Status: TC1 Submitter: Matt Austern Opened: 1998-09-18 Last modified: 2023-03-24 13:58:25 UTC

Priority: Not Prioritized

View all other issues in [locale.codecvt].

View all issues with TC1 status.


The class synopses for classes codecvt<> ( and codecvt_byname<> ( say that the first parameter of the member functions length and do_length is of type const stateT&. The member function descriptions, however (, paragraph 6;, paragraph 9) say that the type is stateT&. Either the synopsis or the summary must be changed.

If (as I believe) the member function descriptions are correct, then we must also add text saying how do_length changes its stateT argument.

Proposed resolution:

In [locale.codecvt], and also in [locale.codecvt.byname], change the stateT argument type on both member length() and member do_length() from

const stateT&



In [locale.codecvt.virtuals], add to the definition for member do_length a paragraph:

Effects: The effect on the state argument is ``as if'' it called do_in(state, from, from_end, from, to, to+max, to) for to pointing to a buffer of at least max elements.