Strcpy

strcpy

strcpy — функция стандартной библиотеки языка программирования Си, для копирования нуль-терминированной строки в заданный буфер.

Прототип функции

Прототип, описанный в заголовочном файле string.h:

char *strcpy (char *dst, const char *src);

• dst — указатель (пойнтер) на буфер назначения.
• src — указатель (пойнтер) на исходную строку.

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

Функция возвращает значение dst.

Пример использования

#include <string.h>
#include <stdio.h>                       /* для printf() */
 
 
int main()
{
   char *str = "образец строки";
   char  buf[32];                        // буфер размером больше строки
 
   memset(buf, 0, sizeof(buf));          // очистка буфера для вывода
 
   printf("строка: \"%s\"\n\n", str);
   printf("буфер перед копированием: \"%s\"\n", buf);
 
   strcpy(buf, str);
 
   printf("буфер после копирования:  \"%s\"\n", buf);
 
   return 0;
}

Вывод:

строка: "образец строки"

буфер перед копированием: ""
буфер после копирования:  "образец строки"

Безопасность

Поскольку функция не проверяет длину строки и размер буфера, она не должна использоваться для работы с внешними данными во избежание переполнения буфера dst.

Вместо strcpy рекомендуется использовать стандартную функцию strncpy (внимание, функция с небезопасным дизайном!) или нестандарную функцию strlcpy (безопасную реализацию strncpy).

Внешние ссылки

• strcpy(1) (англ.) — Мануал функции strcpy на сайте OpenBSD
• strcpy (англ.) — описание strcpy в руководстве программиста GNU/Linux.
• C++ reference: cstring: strcpy (англ.) — описание strcpy с примером.