d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

strfmon(3): Wording improvements

Browse Source 
Use the same terminology as the other `_l` xlocale(3) functions.

Reviewed by:	kib
MFC after:	1 week
This commit is contained in:
Jose Luis Duran 2022-11-08 17:53:17 -03:00 committed by Konstantin Belousov
parent cdd9d92dad
commit 59cc636d94
1 changed files with 11 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
lib/libc/stdlib/strfmon.3
View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd October 28, 2022
.Dd January 25, 2023
.Dt STRFMON 3
.Os
.Sh NAME
@ -37,13 +37,15 @@
.In monetary.h
.Ft ssize_t
.Fn strfmon "char * restrict s" "size_t maxsize" "const char * restrict format" "..."
.In monetary.h
.In xlocale.h
.Ft ssize_t
.Fn strfmon_l "char * restrict s" "size_t maxsize" "locale_t loc" "const char * restrict format" "..."
.Sh DESCRIPTION
The
.Fn strfmon
function places characters into the array pointed to by
.Fa s
.Fa s ,
as controlled by the string pointed to by
.Fa format .
No more than
@ -52,9 +54,9 @@ bytes are placed into the array.
.Pp
The
.Fn strfmon_l
function does the same as
function takes an explicit locale argument, whereas the
.Fn strfmon
but takes an explicit locale rather than using the current locale.
function uses the current global or per-thread locale.
.Pp
The format string is composed of zero or more directives:
ordinary characters (not
@ -129,12 +131,14 @@ character is written.
.El
.El
.Sh RETURN VALUES
If the total number of resulting bytes including the terminating
If the total number of resulting bytes, including the terminating
.Dv NUL
byte is not more than
byte, is not more than
.Fa maxsize ,
.Fn strfmon
returns the number of bytes placed into the array pointed to by
and
.Fn strfmon_l
return the number of bytes placed into the array pointed to by
.Fa s ,
not including the terminating
.Dv NUL
@ -144,11 +148,6 @@ the contents of the array are indeterminate,
and
.Va errno
is set to indicate the error.
.Pp
The
.Fn strfmon_l
function returns the same values as
.Fn strfmon .
.Sh EXAMPLES
The following example will format the value
.Dq Li 1234567.89