strcat()

concatenate two strings 

Function

SYNOPSIS

#include <string.h>

char *strcat(char *s1, const char *s2);

DESCRIPTION

The strcat() function appends a copy of the string pointed to by s2 (including the terminating null character) to the end of the string pointed to by s1. The initial character of s2 overwrites the null character at the end of s1. If copying occurs between objects that overlap, the behavior is undefined.

The function strcat() does not allocate any storage. The caller must insure that the buffer pointed to by s1 is long enough for string s2 and its terminating null character.

PARAMETERS

s1 

Is the null-terminated string to be modified.

s2 

Is the null-terminated string to be copied to the end of s1.

RETURN VALUES

The strcat() function returns the value of s1.

CONFORMANCE

ANSI/ISO 9899-1990.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

None.

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Functions:
strcpy(), strncat(), strncpy()

PTC MKS Toolkit 10.5 Documentation Build 40.