codecvt::out

Converts a sequence of internal CharTypes to a sequence of external Bytes.

result out(
     StateType& _State,
      const CharType* _First1, 
     const CharType* _Last1,
      const CharType*& _Next1,
     Byte* _First2, 
      Byte* _Last2, 
       Byte*& _Next2
) const;

Parameters

• _State
  The conversion state that is maintained between calls to the member function.

• _First1
  Pointer to the beginning of the sequence to be converted.

• _Last1
  Pointer to the end of the sequence to be converted.

• _Next1
  Reference to a pointer to the first unconverted CharType after the last CharType converted.

• _First2
  Pointer to the beginning of the converted sequence.

• _Last2
  Pointer to the end of the converted sequence.

• _Next2
  Reference to a pointer to the first unconverted Byte after the last converted Byte.

Return Value

The member function returns do_out(_State, _First1, _Last1, _Next1, _First2, _Last2, _Next2).

Remarks

For more information, see codecvt::do_out.

Example

// codecvt_out.cpp
// compile with: /EHsc
#define _INTL
#include <locale>
#include <iostream>
#include <wchar.h>
using namespace std;
#define LEN 90
int main( )   
{
   char pszExt[LEN+1];
   wchar_t *pwszInt = L"This is the wchar_t string to be converted.";
   memset( &pszExt[0], 0, ( sizeof( char ) )*( LEN+1 ) );
   char* pszNext;
   const wchar_t* pwszNext;
   mbstate_t state;
   locale loc("C");//English_Britain");//German_Germany
   int res = use_facet<codecvt<wchar_t, char, mbstate_t> >
      ( loc ).out( state,
      pwszInt, &pwszInt[wcslen( pwszInt )], pwszNext ,
      pszExt, &pszExt[wcslen( pwszInt )], pszNext );
   pszExt[wcslen( pwszInt )] = 0;
   cout << ( ( res!=codecvt_base::error ) ? "It worked: " : "It didn't work: " )
   << "The converted string is:\n ["
   << &pszExt[0]
   << "]" << endl;
}

It worked: The converted string is:
 [This is the wchar_t string to be converted.]

Requirements

Header: <locale>

Namespace: std

See Also

Concepts

codecvt Class

codecvt Members