.\" (C) 2002 Ian Gulliver
.TH firestring_strncat 3 2002-03-31
.SH NAME
firestring_strncat \-
.BR strncat (3)
with slightly saner semantics
.SH SYNOPSIS
.B #include <firestring.h>
.br
.B -lfirestring
.LP
.BI "void firestring_strncat(char * const " "to" ", const char * const " "from" ", const size_t " "size" ")"
.SH DESCRIPTION
firestring_strncpy() acts like
.BR strncat (3)
except that
.I to
will always contain a trailing nil, even if the function runs
out of space and the
.I size
argument is the maximum size of all of
.IR to ,
not just the amount of space remaining in it.  In simpler terms, firestring_strncat() appends the string
.I from
to
.IR to ,
where
.I to
is a buffer of
.I size
bytes.
.SH RETURN VALUE
Always succeeds.
.SH AUTHOR
Ian Gulliver <ian@penguinhosting.net>
.SH SEE ALSO
.BR libfirestring (3)