Copies a null-terminated string.

#include <string.h>

char *strcpy(char *string1, const char *string2);
errno_t strcpy_s(char *string1, rsize_t s1max, const char *string2);

#include <wchar.h>

wchar_t *wcscpy(wchar_t *string1, const wchar_t *string2);
errno_t wcscpy_s(wchar_t *string1, size_t s1max, const wchar_t *string2);

Parameters

string1

Destination string; must contain a null character \0 marking the end of the string.

s1max

The maximum size of the string1 buffer.

string2

Source string, including the terminating null character.

Remarks

No overflow checking is performed in strcpy when strings are copied.

The strcpy_s function copies the string pointed to by string2 (including the terminating null character) into the array pointed to by string1.

The strcpy_s function is subject to contraints:

• Neither string1 nor string2 shall be a null pointer.
• s1max shall not be greater than RSIZE_MAX.
• s1max shall not equal zero.
• s1max shall be greater than strnlen_s(string2, s1max).
• Copying shall not take place between objects that overlap.

If there is a runtime-constraint violation, then if string1 is not a null pointer and s1max is greater than zero and not greater than RSIZE_MAX, then strcpy_s sets string1[0] to the null character.

wcscpy and wcscpy_s are wide-character versions of strcpy and strcpy_s respectively.

Return Values

The strcpy function returns string1.

The strcpy_s function returns 0 on successful completion, or else a non-zero value.

Generic Text Routines

Requirements