Debian Codegraph @

upstream/debian-unstable/man3/localeconv.3

raw
1 '\" t
2 .\" Copyright 1993, Thomas Koenig <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\"
7 .TH localeconv 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 localeconv \- get numeric formatting information
10 .SH LIBRARY
11 Standard C library
12 .RI ( libc ,\~ \-lc )
13 .SH SYNOPSIS
14 .nf
15 .B #include <locale.h>
16 .P
17 .B struct lconv *localeconv(void);
18 .fi
19 .SH DESCRIPTION
20 The
21 .BR localeconv ()
22 function returns a pointer to a
23 .I struct lconv
24 for the current locale.
25 This structure is shown in
26 .BR locale (7),
27 and contains all values associated with the locale categories
28 .B LC_NUMERIC
29 and
30 .BR LC_MONETARY .
31 Programs may also use the functions
32 .BR printf (3)
33 and
34 .BR strfmon (3),
35 which behave according to the actual locale in use.
36 .SH RETURN VALUE
37 The
38 .BR localeconv ()
39 function returns a pointer to a filled in
40 .IR "struct lconv" .
41 This structure may be (in glibc,
42 .IR is )
43 statically allocated, and may be overwritten by subsequent calls.
44 According to POSIX,
45 the caller should not modify the contents of this structure.
46 The
47 .BR localeconv ()
48 function always succeeds.
49 .SH ATTRIBUTES
50 For an explanation of the terms used in this section, see
51 .BR attributes (7).
52 .TS
53 allbox;
54 lb lb lbx
55 l l l.
56 Interface Attribute Value
57 T{
58 .na
59 .nh
60 .BR localeconv ()
61 T} Thread safety T{
62 .na
63 .nh
64 MT-Unsafe race:localeconv locale
65 T}
66 .TE
67 .SH STANDARDS
68 C11.
69 .SH HISTORY
70 C89.
71 .SH BUGS
72 The
73 .BR printf (3)
74 family of functions may or may not honor the current locale.
75 .SH SEE ALSO
76 .BR locale (1),
77 .BR localedef (1),
78 .BR isalpha (3),
79 .BR nl_langinfo (3),
80 .BR setlocale (3),
81 .BR strcoll (3),
82 .BR strftime (3),
83 .BR locale (7)