Просмотр кода страницы Strcpy

{{lowercase}}
'''strcpy''' — функция [[стандартная библиотека|стандартной библиотеки]] [[язык программирования|языка программирования]] [[Си (язык программирования)|Си]] для копирования [[нуль-терминированная строка|нуль-терминированной строки]] (включая нуль-терминатор) в заданный буфер.

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

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

<source lang="c">char *strcpy (char *dst, const char *src);</source>

* <code>dst</code> — [[указатель (тип данных)|указатель]] на буфер назначения.
* <code>src</code> — [[указатель (тип данных)|указатель]] на исходную строку.

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

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

<source lang="c">
#include <string.h>
#include <stdio.h>                       /* для printf() */

int main()
{
   char *str = "string example";
   char  buf[32];                        // буфер размером больше строки

   buf[0] = '\0';                        // помечаем буфер как пустую строку, либо char buf[32] = "";

   printf("string: \"%s\"\n", str);
   printf("buffer before copying: \"%s\"\n", buf);

   strcpy(buf, str);

   printf("buffer after copying: \"%s\"\n", buf);

   return 0;
}
</source>

Вывод:
<pre>
string: "string example"
buffer before copying: ""
buffer after copying: "string example"
</pre>

== Безопасность ==
Поскольку функция не проверяет длину строки и размер буфера, она '''не должна''' использоваться для работы с данными, размер которых неизвестен, во избежание [[переполнение буфера|переполнения буфера]] <code>dst</code>.

Вместо <code>strcpy</code> рекомендуется использовать стандартную функцию <code>[[strncpy]]</code> ('''добавляя нуль-терминатор при необходимости!''') или не входящие в стандарт функции <code>[[strlcpy]]</code> или <code>strncpy_s</code>.

== Ссылки ==
* [http://www.openbsd.org/cgi-bin/man.cgi?query=strcpy&apropos=0&sektion=0&manpath=OpenBSD+Current&arch=i386&format=html strcpy(1)]{{Недоступная ссылка|date=Март 2020 |bot=InternetArchiveBot }} {{ref|en}} — Мануал функции <code>strcpy</code> на сайте OpenBSD
* [http://www.cplusplus.com/reference/clibrary/cstring/strcpy/ C++ reference: cstring: strcpy] {{ref|en}} — описание strcpy с примером.
* [http://www.ardatov.wordpress.com/2010/07/09/strcpy.html strcpy()] {{ref|ru}} — реализация функции strcpy.

[[Категория:String.h]]
[[Категория:Небезопасные функции Си]]