Linux程序员手册 第3部分
更新日期： 2020-06-09

名称

stpcpy-复制一个字符串，返回指向其末尾的指针

语法

#include <string.h>

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

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

stpcpy()：

Since glibc 2.10:

_POSIX_C_SOURCE>= 200809L

Before glibc 2.10:

_GNU_SOURCE

说明

stpcpy()函数将src指向的字符串(包括终止的空字节(aq \ 0aq))复制到dest指向的数组。字符串可能不会重叠，并且目标字符串dest必须足够大才能接收副本。

返回值

stpcpy()返回一个指向字符串dest末尾(即终止的空字节的地址)而不是开头的指针。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

此功能已添加到POSIX.1-2008。在此之前，它不是C或POSIX.1标准的一部分，也不是UNIX系统上的惯例。它至少早在1986年就出现在Lattice C AmigaDOS编译器中，然后在1989年出现在GNU fileutils和GNU textutils中，到1992年出现在GNU C库中。它也出现在BSD上。

BUGS

此功能可能会超出缓冲区目标。

示例

例如，此程序使用stpcpy()连接foo和bar以生成foobar，然后将其打印。

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

int
main(void)
{
    char buffer[20];
    char *to = buffer;

    to = stpcpy(to, "foo");
    to = stpcpy(to, "bar");
    printf("%s\n", buffer);
}

另外参见

bcopy(3)，memccpy(3)，memcpy(3)，memmove(3)，stpncpy(3)，strcpy(3)，字符串(3)，wcpcpy(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。