Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::localeconv

The localeconv function obtains a pointer to a static object of type std::lconv, which represents numeric and monetary formatting rules of the current C locale.

NotebookLM
Defined in header <clocale>
std::lconv* localeconv();

The localeconv function obtains a pointer to a static object of type std::lconv, which represents numeric and monetary formatting rules of the current C locale.

Parameters

(none)

Return value

Pointer to the current std::lconv object.

Notes

Modifying the object references through the returned pointer is undefined behavior.

std::localeconv modifies a static object, calling it from different threads without synchronization is undefined behavior.

Example

example.cpp
#include <clocale>
#include <iostream>
 
int main()
{
    std::setlocale(LC_ALL, "ja_JP.UTF-8");
    std::lconv* lc = std::localeconv();
    std::cout << "Japanese currency symbol: " << lc->currency_symbol
              << '(' << lc->int_curr_symbol << ")\n";
}
Output
Japanese currency symbol: ¥(JPY )

See also

gets and sets the current C locale
(function)
formatting details, returned by std::localeconv
(class)
C documentation for localeconv

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.