summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlejandro Colomar <alx@kernel.org>2023-12-04 19:03:07 +0100
committerAlejandro Colomar <alx@kernel.org>2023-12-04 19:03:07 +0100
commit2d77337a843f863a4408c2d7254bd9492d2fdccf (patch)
tree172324f488821b97ee051af7f0697ad5fb76ca91
parent6003785ef825e4f89242d467620d1c69d4a7a0e3 (diff)
string_copying.7: Say 'known-length' for character sequences whose length is known
Signed-off-by: Alejandro Colomar <alx@kernel.org>
-rw-r--r--man7/string_copying.720
1 files changed, 10 insertions, 10 deletions
diff --git a/man7/string_copying.7 b/man7/string_copying.7
index 9d7e06b4b..e0a80dd60 100644
--- a/man7/string_copying.7
+++ b/man7/string_copying.7
@@ -62,15 +62,15 @@ const char *restrict " src ,
.BI "char *strncat(char *restrict " dst ", const char " src "[restrict ." ssize ],
.BI " size_t " ssize );
.fi
-.\" ----- SYNOPSIS :: Measured character sequences --------------------/
-.SS Measured character sequences
+.\" ----- SYNOPSIS :: Known-length character sequences --------------------/
+.SS Known-length character sequences
.nf
-// Chain-copy a measured character sequence.
+// Chain-copy a known-length character sequence.
.BI "void *mempcpy(void " dst "[restrict ." size "], \
const void " src "[restrict ." size ],
.BI " size_t " size );
.P
-// Chain-copy a measured character sequence into a string.
+// Chain-copy a known-length character sequence into a string.
.I stpcpy(mempcpy(dst, src, ssize), \[dq]\[dq]);
.fi
.SH DESCRIPTION
@@ -98,9 +98,9 @@ however, those padding null bytes are not part of the character sequence.
Don't confuse zero-padded with null-terminated:
zero-padded means 0 or more padding zeros (null characters),
while null-terminated means exactly 1 terminating null character.
-.\" ----- DESCRIPTION :: Terms (and abbreviations) :: measured character sequence
+.\" ----- DESCRIPTION :: Terms (and abbreviations) :: known-length character sequence
.TP
-.I measured character sequence
+.I known-length character sequence
Character sequence delimited by its length.
It may be a slice of a larger character sequence,
or even of a string.
@@ -258,8 +258,8 @@ into a character sequence,
ignoring any trailing null bytes in the source fixed-size buffer,
you should use
.IR "\%mempcpy(dst,\ src,\ strnlen(src,\ NITEMS(src)))" .
-.\" ----- DESCRIPTION :: Measured character sequences -----------------/
-.SS Measured character sequences
+.\" ----- DESCRIPTION :: Known-length character sequences -----------------/
+.SS Known-length character sequences
The simplest character sequence copying function is
.BR mempcpy (3).
It requires always knowing the length of your character sequences,
@@ -284,10 +284,10 @@ C library APIs use strings,
so programs that use character sequences
will have to take care of differentiating strings from character sequences.
.P
-To copy a measured character sequence, use
+To copy a known-length character sequence, use
.BR mempcpy (3).
.P
-To copy a measured character sequence into a string, use
+To copy a known-length character sequence into a string, use
.IR "\%stpcpy(mempcpy(dst,\ src,\ ssize),\ \[dq]\[dq])" .
.P
A string is also accepted as input,