strcat, wcscat (Windows CE 5.0)

Article
09/14/2012

Developing an Application > Microsoft C Run-time Library for Windows CE > Run-time Library Reference

Append a string.

char *strcat( char *strDestination, const char *strSource);wchar_t *wcscat( wchar_t *strDestination, const wchar_t *strSource);

Parameters

strDestination
Null-terminated destination string.
strSource
Null-terminated source string.

Return Values

Each of these functions returns the destination string (strDestination). No return value is reserved to indicate an error.

Remarks

These functions are supported by all versions of the C run-time libraries.

The strcat function appends strSource to strDestination and terminates the resulting string with a null character. The initial character of strSource overwrites the terminating null character of strDestination. No overflow checking is performed when strings are copied or appended. The behavior of strcat is undefined if the source and destination strings overlap.

wcscat is the wide-character version of strcat. The arguments and return value of wcscat are wide-character strings. These two functions behave identically otherwise.

The first argument, strDestination, must be large enough to hold the current strDestination and strSource combined and a closing '\0'; otherwise, a buffer overrun can occur.

This can lead to a denial of service attack against the application if an access violation occurs, or in the worst case, allow an attacker to inject executable code into your process. This is especially true if strDestination is a stack-based buffer. Consider using strncat or wcsncat, or consider using an appropriate strsafe function.

For more information, see Safe String Functions.

The following table shows generic-text routine mappings for this function.

TCHAR.H Routine	_UNICODE Defined
_tcscat	wcscat

For more information about TCHAR.H routines, see Generic Text Mappings.

Example

Description

This program uses strcpy and strcat to build a phrase.

Code

#include <string.h>
#include <stdio.h>

void main( void )
{
   char string[80];
   strcpy( string, "Hello world from " );
   strcat( string, "strcpy " );
   strcat( string, "and " );
   strcat( string, "strcat!" );
   printf( "String = %s\n", string );
}
// Output
String = Hello world from strcpy and strcat!

Requirements

OS Versions: Windows CE 2.0 and later.

Header: stdio.h, string.h.

Link Library: coredll.dll.