diff options
author | Alejandro Colomar <alx@kernel.org> | 2023-12-04 19:03:07 +0100 |
---|---|---|
committer | Alejandro Colomar <alx@kernel.org> | 2023-12-04 19:03:07 +0100 |
commit | 2d77337a843f863a4408c2d7254bd9492d2fdccf (patch) | |
tree | 172324f488821b97ee051af7f0697ad5fb76ca91 | |
parent | 6003785ef825e4f89242d467620d1c69d4a7a0e3 (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.7 | 20 |
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, |