aboutsummaryrefslogtreecommitdiffstats
path: root/man/man3/mbsnrtowcs.3
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2024-11-17 18:47:53 +0100
committerAlejandro Colomar <alx@kernel.org>2024-11-17 21:51:23 +0100
commit18e7c4597c4e72fa5210c7887273e363c456c9ee (patch)
tree97cfd22e731a4c859ae71783d70943ff72e6cb60 /man/man3/mbsnrtowcs.3
parent8fc6fdd8291d906e58a175b5e1b20da680aaeb4a (diff)
downloadman-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/mbsnrtowcs.3')
-rw-r--r--man/man3/mbsnrtowcs.314
1 files changed, 7 insertions, 7 deletions
diff --git a/man/man3/mbsnrtowcs.3 b/man/man3/mbsnrtowcs.3
index 9cfe92ab93..27ece4221a 100644
--- a/man/man3/mbsnrtowcs.3
+++ b/man/man3/mbsnrtowcs.3
@@ -18,8 +18,8 @@ Standard C library
.nf
.B #include <wchar.h>
.P
-.BI "size_t mbsnrtowcs(wchar_t " dest "[restrict ." len "], const char **restrict " src ,
-.BI " size_t " nms ", size_t " len \
+.BI "size_t mbsnrtowcs(wchar_t " dest "[restrict ." size "], const char **restrict " src ,
+.BI " size_t " nms ", size_t " size \
", mbstate_t *restrict " ps );
.fi
.P
@@ -60,7 +60,7 @@ multibyte string
to a wide-character string starting at
.IR dest .
At most
-.I len
+.I size
wide characters are written to
.IR dest .
The shift state
@@ -95,7 +95,7 @@ The
.I nms
limit forces a stop,
or
-.I len
+.I size
non-L\[aq]\[rs]0\[aq] wide characters
have been stored at
.IR dest .
@@ -130,11 +130,11 @@ The glibc implementation adopts the former behavior.
If
.I dest
is NULL,
-.I len
+.I size
is ignored, and the conversion proceeds as
above, except that the converted wide characters
are not written out to memory,
-and that no destination length limit exists.
+and that no destination size limit exists.
.P
In both of the above cases, if
.I ps
@@ -144,7 +144,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
wide
characters at
.IR dest .