summaryrefslogtreecommitdiffstats
path: root/man3/newlocale.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/newlocale.3')
-rw-r--r--man3/newlocale.334
1 files changed, 17 insertions, 17 deletions
diff --git a/man3/newlocale.3 b/man3/newlocale.3
index 2c602a4..4bbaf14 100644
--- a/man3/newlocale.3
+++ b/man3/newlocale.3
@@ -2,7 +2,7 @@
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
-.TH newlocale 3 2023-05-03 "Linux man-pages 6.05.01"
+.TH newlocale 3 2023-10-31 "Linux man-pages 6.7"
.SH NAME
newlocale, freelocale \- create, modify, and free a locale object
.SH LIBRARY
@@ -11,17 +11,17 @@ Standard C library
.SH SYNOPSIS
.nf
.B #include <locale.h>
-.PP
+.P
.BI "locale_t newlocale(int " category_mask ", const char *" locale ,
.BI " locale_t " base );
.BI "void freelocale(locale_t " locobj );
.fi
-.PP
+.P
.RS -4
Feature Test Macro Requirements for glibc (see
.BR feature_test_macros (7)):
.RE
-.PP
+.P
.BR newlocale (),
.BR freelocale ():
.nf
@@ -67,7 +67,7 @@ reference returned as the function result.
If the call fails, the contents of
.I base
remain valid and unchanged.
-.PP
+.P
If
.I base
is the special locale object
@@ -78,7 +78,7 @@ or is not
.I (locale_t)\ 0
and is not a valid locale object handle,
the behavior is undefined.
-.PP
+.P
The
.I category_mask
argument is a bit mask that specifies the locale categories
@@ -101,7 +101,7 @@ and
Alternatively, the mask can be specified as
.BR LC_ALL_MASK ,
which is equivalent to ORing all of the preceding constants.
-.PP
+.P
For each category specified in
.IR category_mask ,
the locale data from
@@ -112,7 +112,7 @@ If a new locale object is being created,
data for all categories not specified in
.I category_mask
is taken from the default ("POSIX") locale.
-.PP
+.P
The following preset values of
.I locale
are defined for all categories that can be specified in
@@ -146,7 +146,7 @@ If
is
.B LC_GLOBAL_LOCALE
or is not valid locale object handle, the results are undefined.
-.PP
+.P
Once a locale object has been freed,
the program should make no further use of it.
.SH RETURN VALUE
@@ -202,7 +202,7 @@ The second command-line argument is optional;
if it is present, it is used to set the
.B LC_TIME
category of the locale object.
-.PP
+.P
Having created and initialized the locale object,
the program then applies it using
.BR uselocale (3),
@@ -220,15 +220,15 @@ Displaying the date.
The format and language of the output will be affected by the
.B LC_TIME
setting.
-.PP
+.P
The following shell sessions show some example runs of this program.
-.PP
+.P
Set the
.B LC_NUMERIC
category to
.I fr_FR
(French):
-.PP
+.P
.in +4n
.EX
$ \fB./a.out fr_FR\fP
@@ -236,7 +236,7 @@ $ \fB./a.out fr_FR\fP
Fri Mar 7 00:25:08 2014
.EE
.in
-.PP
+.P
Set the
.B LC_NUMERIC
category to
@@ -247,7 +247,7 @@ and the
category to
.I it_IT
(Italian):
-.PP
+.P
.in +4n
.EX
$ \fB./a.out fr_FR it_IT\fP
@@ -255,7 +255,7 @@ $ \fB./a.out fr_FR it_IT\fP
ven 07 mar 2014 00:26:01 CET
.EE
.in
-.PP
+.P
Specify the
.B LC_TIME
setting as an empty string,
@@ -263,7 +263,7 @@ which causes the value to be taken from environment variable settings
(which, here, specify
.IR mi_NZ ,
New Zealand Māori):
-.PP
+.P
.in +4n
.EX
$ LC_ALL=mi_NZ ./a.out fr_FR ""