diff options
| author | наб <nabijaczleweli@nabijaczleweli.xyz> | 2022-07-20 00:28:10 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-07-20 10:15:00 +0200 |
| commit | 23b628c715a54b78335a1e0479f21f4814264e17 (patch) | |
| tree | f7c9a700362922b1353485d542814ad2cb0d7b63 | |
| parent | 935e3374330f4a677b83a00a459feb811b692cf5 (diff) | |
strftime.3, strftime_l.3: mention strftime_l() with .so link
POSIX.1-2008 TC2:
> [CX] The strftime_l() function shall be equivalent to the strftime()
function, except that the locale data used is from the locale
represented by locale.
> [CX] The behavior is undefined if the locale argument to strftime_l()
is the special locale object LC_GLOBAL_LOCALE or is not a valid locale
object handle.
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
| -rw-r--r-- | man3/strftime.3 | 26 | ||||
| -rw-r--r-- | man3/strftime_l.3 | 1 |
2 files changed, 26 insertions, 1 deletions
diff --git a/man3/strftime.3 b/man3/strftime.3 index dc98a5122..6eff815ad 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -27,6 +27,11 @@ Standard C library .BI "size_t strftime(char *restrict " s ", size_t " max , .BI " const char *restrict " format , .BI " const struct tm *restrict " tm ); +.PP +.BI "size_t strftime_l(char *restrict " s ", size_t " max , +.BI " const char *restrict " format , +.BI " const struct tm *restrict " tm , +.BI " locale_t " locale ); .fi .SH DESCRIPTION The @@ -471,6 +476,17 @@ as an argument to a One example of such alternative forms is the Japanese era calendar scheme in the .B ja_JP glibc locale. +.PP +.BR strftime_l () +is equivalent to +.BR strftime (), +except it uses the specified +.I locale +instead of the current locale. +The behaviour is undefined if +.I locale +is invalid or +.BR LC_GLOBAL_LOCALE . .SH RETURN VALUE Provided that the result string, including the terminating null byte, does not exceed @@ -516,14 +532,22 @@ lbx lb lb l l l. Interface Attribute Value T{ -.BR strftime () +.BR strftime (), +.BR strftime_l () T} Thread safety MT-Safe env locale .TE .hy .ad .sp 1 .SH CONFORMING TO +.BR strftime (): SVr4, C89, C99. +.PD 0 +.PP +.PD +.BR strftime_l (): +POSIX.1-2008. +.PP .\" FIXME strftime() is in POSIX.1-2001 and POSIX.1-2008, but the details .\" in the standards changed across versions. Investigate and .\" write up. diff --git a/man3/strftime_l.3 b/man3/strftime_l.3 new file mode 100644 index 000000000..02e797a23 --- /dev/null +++ b/man3/strftime_l.3 @@ -0,0 +1 @@ +.so man3/strftime.3 |