# localeconv

> C++ Atlas: `cppatlas.com/w/c/locale/localeconv` | Source: https://en.cppreference.com/w/c/locale/localeconv | Domain: Localization support

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

## Official Specification Summary (cppreference)

```cpp
// Defined in header <locale.h>
struct lconv* localeconv(void);
```

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

### Parameters

(none)

### Return value

pointer to the current `lconv` object.

### Notes

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

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

### Example

```c
#include <locale.h>
#include <stdio.h>

int main(void)
{
    setlocale(LC_MONETARY, "en_IN.utf8");
    struct lconv* lc = localeconv();
    printf("Local Currency Symbol        : %s\n", lc->currency_symbol);
    printf("International Currency Symbol: %s\n", lc->int_curr_symbol);
}
```

Output:

```text
Local Currency Symbol        : ₹
International Currency Symbol: INR
```

### References

- C23 standard (ISO/IEC 9899:2024):

  - 7.11.2.1 The localeconv function (p: TBD)

- C17 standard (ISO/IEC 9899:2018):

  - 7.11.2.1 The localeconv function (p: TBD)

- C11 standard (ISO/IEC 9899:2011):

  - 7.11.2.1 The localeconv function (p: 225-230)

- C99 standard (ISO/IEC 9899:1999):

  - 7.11.2.1 The localeconv function (p: 206-211)

- C89/C90 standard (ISO/IEC 9899:1990):

  - 4.4.2.1 The localeconv function

### See also

- [`setlocale`](https://en.cppreference.com/w/c/locale/setlocale): gets and sets the current C locale (function)
- [`lconv`](https://en.cppreference.com/w/c/locale/lconv): formatting details, returned by `localeconv` (struct)
- [C++ documentation for `localeconv`](https://en.cppreference.com/w/cpp/locale/localeconv)

---
Attribution: content from https://en.cppreference.com/w/c/locale/localeconv (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.