#C 语言标准库函数 strcpy

/*********************************************
 * @brief 复制字符串
 * @param dest 目标地址
 * @param src 源字符串
 * @return 目标地址
 ********************************************/
char* strcpy(char* restrict dest, const char* restrict src);

说明

将 src 指向的字符串复制到 dest 指向的内存。

注意：

• dest 必须有足够的空间
• dest 和 src 指向的字符串不可以存在重叠

参数

• dest - 指向要复制到的内存地址
• src - 指向要被复制的字符串

返回值

• 返回目标地址 dest 本身

#示例

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

int main(void)
{
    char dest[10];

    strcpy(dest, "hello");
    printf("%s\n", dest);

    return 0;
}

说明：

• 将 "hello" 复制到 dest，包含结尾的 0

运行结果：

hello
Never gon

#注意

通过 strcpy 进行字符串复制时，dest 和 src 指向的内存不能重叠，否则可能产生错误。例如：

char array[10] = "abcde";
strcpy(array + 1, array); // 复制

期望结果是 "aabcde"，而实际结果可能是 "aaaaaa"，因为会这样复制：

如果要进行这样的重叠复制，请使用 memmove 函数。

编译器可能会在 strcpy 进行重叠复制时纠正该问题，导致上述错误无法复现。

#推荐阅读

• C 语言标准库函数 strncpy
• strcpy - cppreference

#参考标准

• C23 standard (ISO/IEC 9899:2024):
  • 7.24.2.3 The strcpy function (p: TBD)
• C17 standard (ISO/IEC 9899:2018):
  • 7.24.2.3 The strcpy function (p: 264-265)
• C11 standard (ISO/IEC 9899:2011):
  • 7.24.2.3 The strcpy function (p: 363)
• C99 standard (ISO/IEC 9899:1999):
  • 7.21.2.3 The strcpy function (p: 326)
• C89/C90 standard (ISO/IEC 9899:1990):
  • 4.11.2.3 The strcpy function