locale imbue ( const locale& loc );

Imbue locale

Associates loc to the stream as the new locale object to be used with locale-sensitive operations.

Before that, all callback functions registered through register_callback member with imbue_event as its first parameter are called.

Parameters

loc

locale object to be imbued as the new locale for the stream.

Return value

Example

// imbue example
#include <iostream>
#include <locale>
using namespace std;
  
int main()
{
  locale mylocale("");      // Construct locale object with the user's default preferences
  cout.imbue( mylocale );   // Imbue that locale
  cout << (double) 3.14159 << endl;
  return 0;
}

This code writes a floating point number using the user's prefered locale. For example, in a system configured with a Spanish locale as default, this should write the number using a comma decimal separator:

3,14159

See also