cpp/locale/codecvt/in

@1@ Public member function, calls the member function of the most derived class.

@2@ If this facet defines a conversion, translates the external characters from the source range  to internal characters, placing the results in the subsequent locations starting at. Converts no more than external characters and writes no more than  internal characters. Leaves and  pointing one beyond the last element successfully converted.

If this facet does not define a conversion, no characters are converted. is set to be equal to, is unchanged, and std is returned.

must return if
 * this facet is used by, and
 * would return where.

Return value
A value of type std, indicating the success status as follows:

The non-converting specialization always returns std.