From 7c545b4b9c31dbfb2e8430aded030654a92e967a Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sat, 28 Feb 2026 19:17:45 +0100 Subject: First commit MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- libabort_stpacat.3 | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 libabort_stpacat.3 (limited to 'libabort_stpacat.3') diff --git a/libabort_stpacat.3 b/libabort_stpacat.3 new file mode 100644 index 0000000..2efdc23 --- /dev/null +++ b/libabort_stpacat.3 @@ -0,0 +1,61 @@ +.TH LIBABORT_STPACAT 3 LIBABORT +.SH NAME +libabort_stpacat \- Append a string with bounds checking + +.SH SYNOPSIS +.nf +#include + +char *\fBlibabort_stpacat\fP(char *\fIdst\fP, const char *\fIsrc\fP, size_t \fIsize\fP); + +#if !defined(LIBABORT_NO_SHORTHANDS) && !defined(stpacat) +# define \fBstpacat\fP libabort_stpacat +#endif +.fi +.PP +Link with +.IR -labort . + +.SH DESCRIPTION +The +.BR libabort_stpacat () +function appends the NUL terminated string +.I src +to the NUL terminated string +.I dst +which is assumed to refer to a buffer of +.I size +bytes. +.PP +The function verifies that the concatenated +string fits in the destination buffer +(including the terminating NUL). If the +destination buffer is too small, or if +.I dst +is not NUL terminated within the first +.I size +bytes, the +.BR libabort_stpacat () +function calls +.BR abort (3). + +.SH RETURN VALUE +The +.BR libabort_stpacat () +function returns a pointer to the terminating NUL byte of the +resulting string. + +.SH ERRORS +The +.BR libabort_stpacat () +function cannot fail. + +.SH HISTORY +The +.BR libabort_stpacat () +function added in version 1.0 of +.BR libabort . + +.SH SEE ALSO +.BR libabort (7), +.BR libabort_stralen (3) -- cgit v1.2.3-70-g09d2