C++ Locale Library - unshift

Description

It is a unshift translation state and the function stops converting as soon as it fails to convert a character, or once from_end is reached and its character is successfully converted.

Declaration

Following is the declaration for std::ctype::unshift.

C++98

	
result unshift (state_type& state, 
   extern_type* to, extern_type* to_limit, extern_type*& to_next) const;

C++11

result unshift (state_type& state, 
   extern_type* to, extern_type* to_limit, extern_type*& to_next) const;

Parameters

• state − It is a state object.

• from, from_end − It is used to find initial and final characters of the source sequence.

• from_next − It is used to find an element in the above range.

• to_next − It is used to find an element in the above range.

Return Value

It returns codecvt_base::result.

Exceptions

If an exception is thrown, there are no changes in the facet object, although characters in the range may have been affected.

Data races