DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5

strncat(D3)


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)

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.

Arguments

The arguments sptr1 and sptr2 each point to strings, and each string is an array of characters terminated by a null-character.

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.

Context and synchronization

All contexts.

Hardware applicability

All

Version applicability

ddi: 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

bcmp(D3), bcopy(D3), strcat(D3), strlen(D3)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005