man3/localeconv.3

   1 '\" t
   2 .\" Copyright (c) 1993 by Thomas Koenig (ig25@rz.uni-karlsruhe.de)
   3 .\"
   4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   5 .\"
   6 .\" Modified Sat Jul 24 19:01:20 1993 by Rik Faith (faith@cs.unc.edu)
   7 .TH localeconv 3 (date) "Linux man-pages (unreleased)"
   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)