.TH LIBABORT_STRACAT 3 LIBABORT
.SH NAME
libabort_stracat \- Append a string with bounds checking

.SH SYNOPSIS
.nf
#include <libabort.h>

char *\fBlibabort_stracat\fP(char *\fIdst\fP, const char *\fIsrc\fP, size_t \fIsize\fP);

#if !defined(LIBABORT_NO_SHORTHANDS) && !defined(stracat)
# define \fBstracat\fP libabort_stracat
#endif
.fi
.PP
Link with
.IR -labort .

.SH DESCRIPTION
The
.BR libabort_stracat ()
function appends the NUL terminated string
.I src
to the NUL terminated string
.I dst
in the buffer
.IR dst ,
which is assumed to be
.I size
bytes long.
.PP
If the concatenated string does not fit in the destination buffer
(including the terminating NUL byte), or if
.I dst
is not NUL terminated within the first
.I size
bytes, the
.BR libabort_stracat ()
function calls
.BR abort (3).

.SH RETURN VALUE
The
.BR libabort_stracat ()
function returns
.IR dst .

.SH ERRORS
The
.BR libabort_stracat ()
function cannot fail.

.SH HISTORY
The
.BR libabort_stracat ()
function added in version 1.0 of
.BR libabort .

.SH SEE ALSO
.BR libabort (7),
.BR libabort_stpacat (3),
.BR libabort_stracpy (3)