The C++ std::ios::imbue() function is used to set or change the locale for input and output streams. It is used to customize the formatting of data by changing the locale associated with the stream. It allows you to handle the locale-specific requirements like number formatting, date and time representation.It takes the std::locale object as its parameter and returns the previous locale of the stream.
SyntaxFollowing is the syntax for std::ios::imbue() function.
locale imbue (const locale& loc);Parameters
The locale object associated with the stream before the call.
ExceptionsIf an exception is thrown, the stream is in a valid state.
Data racesModifies the stream object.
Concurrent access to the same stream object may cause data races.
ExampleIn the following example, we are going to consider the basic usage of the imbue() function.
#include <iostream> #include <locale> int main() { std::cout.imbue(std::locale()); std::cout << "Current Locale : " << std::cout.getloc().name() << std::endl; return 0; }Output
Output of the above code is as follows −
Current Locale : CExample
Consider the following example, where we are going to use the US English locale, which formats numbers with commas as thousand separators.
#include <iostream> #include <locale> int main() { std::locale a("en_US.utf8"); std::cout.imbue(a); std::cout << 1122343.89 << std::endl; return 0; }Output
Following is the output of the above code −
1,122,343.89Example
Let's look at the following example, where we are going to use the US English to print a monetary value in the appropriate format.
#include <iostream> #include <locale> #include <iomanip> int main() { std::locale a("en_US.utf8"); std::cout.imbue(a); std::cout << std::showbase << std::put_money(123431232) << std::endl; return 0; }Output
If we run the above code it will generate the following output −
$1,234,312.32
ios.htm
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4