C++ streambuf::getloc() function

The std::streambuf::getloc() function is used to retrieve the current locale associated with a stream buffer. A locale includes various facets, such as number formatting, character classification and more affecting how data is processed by streams.

Syntax

Following is the syntax for std::tuple::.

locale getloc() const;

Parameters

It does not accepts any parameter.

Return Value

This function returns the locale object currently associated to the stream buffer.

Exceptions

If an exception is thrown, there are no changes in the stream buffer.

Data races

It accesses the stream buffer object.

Example 1

In the following example, we are going to consider the basic usage of the getloc() function.

#include <iostream>
#include <sstream>
#include <locale>
int main() {
   std::stringstream a;
   std::locale b = a.rdbuf() -> getloc();
   std::cout << "Default locale: " << b.name() << std::endl;
   return 0;
}

Output

Output of the above code is as follows −

Default locale: C

Example 2

Consider the following example, where we are going to use the imbue() along with thw getloc() function.

#include <iostream>
#include <sstream>
#include <locale>
int main() {
   std::stringstream a;
   std::locale b("en_US.UTF-8");
   a.imbue(b);
   std::locale x = a.rdbuf() -> getloc();
   std::cout << "Current locale: " << x.name() << std::endl;
   return 0;
}

Output

Following is the output of the above code −

Current locale: en_US.UTF-8

Example 3

Let's look at the following example, where we are going to set the locale of the stringstream to fr_FR.UTF-8 and applying the getloc() function.

#include <iostream>
#include <sstream>
#include <locale>
int main() {
   std::stringstream a;
   a.imbue(std::locale("fr_FR.UTF-8"));
   std::locale b = a.rdbuf() -> getloc();
   std::cout << "Locale: " << b.name() << std::endl;
   a << 1123228.33;
   std::cout << "Formatted number: " << a.str() << std::endl;
   return 0;
}

Output

If we run the above code it will generate the following output −

Locale: fr_FR.UTF-8
Formatted number: 1 123 228,33