strcpy, strcpy_s

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

char* strcpy( char* restrict dest, const char* restrict src );

errno_t strcpy_s( char* restrict dest, rsize_t destsz, const char* restrict src );

Параметры

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

Примечания

strcpy_s разрешено перезаписывать целевой массив от последнего записанного символа до destsz для повышения эффективности: она может копировать многобайтовыми блоками, а затем проверять наличие нулевых байтов.

Функция strcpy_s похожа на функцию BSD strlcpy, за исключением того, что

• strlcpy усекает исходную строку, чтобы она поместилась в целевой (что является угрозой безопасности)
• strlcpy не выполняет все проверки во время выполнения, которые выполняет strcpy_s
• strlcpy не делает ошибки очевидными, устанавливая целевую строку в пустую строку или вызывая обработчик в случае неудачного вызова.

Хотя strcpy_s запрещает усечение из-за потенциальных рисков безопасности, можно усечь строку, используя для этого проверенную на границы strncpy.

Пример

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main(void)
{
    const char* src = "Take the test.";
//  src[0] = 'M' ; // this would be undefined behavior
    char dst[strlen(src) + 1]; // +1 to accommodate for the null terminator
    strcpy(dst, src);
    dst[0] = 'M'; // OK
    printf("src = %s\ndst = %s\n", src, dst);

#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s);
    int r = strcpy_s(dst, sizeof dst, src);
    printf("dst = \"%s\", r = %d\n", dst, r);
    r = strcpy_s(dst, sizeof dst, "Take even more tests.");
    printf("dst = \"%s\", r = %d\n", dst, r);
#endif
}

src = Take the test.
dst = Make the test.
dst = "Take the test.", r = 0
dst = "", r = 22

Ссылки

См. также