strcpy, wcscpy, _mbscpy

Статья
06/09/2015

Копирует строку. Существуют более безопасные версии этих функций; см. раздел strcpy_s, wcscpy_s, _mbscpy_s.

Важно!

_mbscpy невозможно использовать в приложениях, выполняемых в Среда выполнения Windows.Дополнительные сведения см. в статье Функции CRT, которые не поддерживаются с ключом /ZW.

char *strcpy(
   char *strDestination,
   const char *strSource 
);
wchar_t *wcscpy(
   wchar_t *strDestination,
   const wchar_t *strSource 
);
unsigned char *_mbscpy(
   unsigned char *strDestination,
   const unsigned char *strSource 
);
template <size_t size>
char *strcpy(
   char (&strDestination)[size],
   const char *strSource 
); // C++ only
template <size_t size>
wchar_t *wcscpy(
   wchar_t (&strDestination)[size],
   const wchar_t *strSource 
); // C++ only
template <size_t size>
unsigned char *_mbscpy(
   unsigned char (&strDestination)[size],
   const unsigned char *strSource 
); // C++ only

Параметры

strDestination
Конечная строка.
strSource
Исходная строка, завершающаяся символом NULL.

Возвращаемое значение

Каждая из этих функций возвращает строку назначения. Нет зарезервированных возвращаемых значений для указания ошибки.

Заметки

Функция strcpy копирует strSource, включая завершающий символ null, в расположение, указанное strDestination. При перекрытии исходной и конечной строк поведение инструкции strcpy не определено.

Примечание по безопасности
Поскольку strcpy не проверяет наличие достаточного места в strDestination перед копированием strSource, эта функция является потенциальной причиной переполнение буфера.Поэтому рекомендуется использовать strcpy_s.

wcscpy и _mbscpy являются соответственно версиями функции strcpy для расширенных и многобайтовых символов. Аргументы и возвращаемое значение wcscpy представляют собой двухбайтовые строки; аргументы и возвращаемое значение _mbscpy представляют собой многобайтовые строки. В остальных случаях эти три функции ведут себя идентично.

В C++ эти функции имеют шаблонные перегрузки, которые вызывают более новые и безопасные аналоги этих функций. Дополнительные сведения см. в разделе Безопасные перегрузки шаблонов.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_tcscpy	strcpy	_mbscpy	wcscpy

Требования

Подпрограмма	Обязательный заголовок
strcpy	<string.h>
wcscpy	<string.h> или <wchar.h>
_mbscpy	<mbstring.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_strcpy.c
// compile with: /W3
// This program uses strcpy
// and strcat to build a phrase.

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

int main( void )
{
   char string[80];

   // If you change the previous line to
   //   char string[20];
   // strcpy and strcat will happily overrun the string
   // buffer.  See the examples for strncpy and strncat
   // for safer string handling.

   strcpy( string, "Hello world from " ); // C4996
   // Note: strcpy is deprecated; use strcpy_s instead
   strcat( string, "strcpy " );           // C4996
   // Note: strcat is deprecated; use strcat_s instead
   strcat( string, "and " );              // C4996
   strcat( string, "strcat!" );           // C4996
   printf( "String = %s\n", string );
}