strncat(D3) strncat(D3)
NAME
strncat - concatenate strings appending a specified number of
characters
SYNOPSIS
#include <sys/types.h>
#include <sys/ddi.h>
char *strncat (char *sptr1, const char *sptr2, size_t nchr)
Arguments
The arguments sptr1 and sptr2 each point to strings, and each
string is an array of characters terminated by a null-
character.
DESCRIPTION
The function strncat appends to the end of the string pointed
to by sptr1 at most nchr characters from the string pointed to
by sptr2 (a null-character and characters that follow it are
not appended). The initial character of sptr2 replaces the
null-character at the end of sptr1. Thus, the maximum number
of characters that can end up in the string pointed to by
sptr1 equals strlen(sptr1)+nchr+1 [see strlen(D3)].
The function strncat alters sptr1 without checking for
overflow of the string pointed to by sptr1. If copying takes
place between strings that overlap, the behavior is undefined.
Return Values
The function strncat returns the value of sptr1, which points
to the null-terminated result.
USAGE
Character movement is performed differently in different
implementations; thus, overlapping moves may yield surprises.
The <sys/ddi.h> header file declares this function.
Level
Base or Interrupt.
Synchronization Constraints
Does not sleep.
Driver-defined basic locks, read/write locks, and sleep locks
may be held across calls to this function.
Copyright 1994 Novell, Inc. Page 1
strncat(D3) strncat(D3)
REFERENCES
bcmp(D3), bcopy(D3), strcat(D3), strlen(D3)
NOTICES
Portability
All processors
Applicability
ddi: 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2