diff options
| author | Alejandro Colomar <alx@kernel.org> | 2024-11-17 18:47:53 +0100 |
|---|---|---|
| committer | Alejandro Colomar <alx@kernel.org> | 2024-11-17 21:51:23 +0100 |
| commit | 18e7c4597c4e72fa5210c7887273e363c456c9ee (patch) | |
| tree | 97cfd22e731a4c859ae71783d70943ff72e6cb60 /man/man3/wcsrtombs.3 | |
| parent | 8fc6fdd8291d906e58a175b5e1b20da680aaeb4a (diff) | |
| download | man-pages-18e7c4597c4e.tar.gz | |
man/: Terminology consistency reforms (n, size, length)
Use 'length' for the lenght of a string.
Use 'n' for the number of elements.
Use 'size' for the number of bytes. (And in wide-character string
functions, 'size' also refers to the number of wide characters.)
The change is quite large, and I might have made some mistakes.
But overall, this should improve consistency in use of these terms.
Signed-off-by: Alejandro Colomar <alx@kernel.org>
Diffstat (limited to 'man/man3/wcsrtombs.3')
| -rw-r--r-- | man/man3/wcsrtombs.3 | 14 |
1 files changed, 7 insertions, 7 deletions
diff --git a/man/man3/wcsrtombs.3 b/man/man3/wcsrtombs.3 index 2bbc364c77..ad6ee7b45b 100644 --- a/man/man3/wcsrtombs.3 +++ b/man/man3/wcsrtombs.3 @@ -19,9 +19,9 @@ Standard C library .nf .B #include <wchar.h> .P -.BI "size_t wcsrtombs(char " dest "[restrict ." len "], \ +.BI "size_t wcsrtombs(char " dest "[restrict ." size "], \ const wchar_t **restrict " src , -.BI " size_t " len ", mbstate_t *restrict " ps ); +.BI " size_t " size ", mbstate_t *restrict " ps ); .fi .SH DESCRIPTION If @@ -35,7 +35,7 @@ the wide-character string to a multibyte string starting at .IR dest . At most -.I len +.I size bytes are written to .IR dest . The shift state @@ -65,7 +65,7 @@ and is set to .BR EILSEQ . .IP \[bu] -The length limit forces a stop. +The size limit forces a stop. In this case, .I *src is left pointing @@ -90,11 +90,11 @@ is returned. If .I dest is NULL, -.I len +.I size is ignored, and the conversion proceeds as above, except that the converted bytes are not written out to memory, and that -no length limit exists. +no size limit exists. .P In both of the above cases, if @@ -105,7 +105,7 @@ state known only to the function is used instead. .P The programmer must ensure that there is room for at least -.I len +.I size bytes at .IR dest . |