man stpcpy

名称

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

概要

        #include <string.h>

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

    对于glibc来说要有功能测试宏才能使用（参考feature_test_macros）：

        stpcpy():

            自glibc 2.10起：

                _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L

            glibc 2.10之前的版本：

                _GNU_SOURCE

说明

        stpcpy将src指向的字符串（包括结束符（'\0'））复制到dest指向的数组中。字符

        串不能重叠，并且目标字符串dest必须足够大以接收复制的内容。

返回值

        stpcpy返回指向字符串dest结尾（即结束符的地址）而不是开头的指针。

线程安全特征

接口	特征	值
stpcpy()	线程安全	多线程安全

标准

        此函数被添加到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，memccpy，memcpy，memmove，stpncpy，strcpy，string，wcpcpy

版本记录

        这个页面是Linux man-pages项目4.04版本的一部分。关于该项目的信息和bug报

        道可以在该网站找到：http://www.kernel.org/doc/man-pages/。

                                2015-03-02