NAME¶

stpcpy - string return-offset-pointer copy

LIBRARY¶

Standard C library (libc, -lc)

SYNOPSIS¶

#include <string.h>

char *stpcpy(char *restrict dst, const char *restrict src);

stpcpy():

    Since glibc 2.10:


        _POSIX_C_SOURCE >= 200809L


    Before glibc 2.10:


        _GNU_SOURCE

DESCRIPTION¶

stpcpy() is similar to strcpy(3), but returns a pointer to the terminating null byte in dst.

It is equivalent to both of the following expressions:

memset(mempcpy(dst, src, strlen(src)), '\0', 1);
strcpy(dst, src) + strlen(src)

RETURN VALUE¶

This function returns a pointer to the terminating null byte of the copied string.

ATTRIBUTES¶

For an explanation of the terms used in this section, see attributes(7).

STANDARDS¶

POSIX.1-2008.

HISTORY¶

POSIX.1-2008.

EXAMPLES¶

#include <err.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int
main(void)
{


    char    *p;


    char    *buf1;


    size_t  len, size;


    size = strlen("Hello ") + strlen("world") + strlen("!") + 1;


    buf1 = malloc(sizeof(*buf1) * size);


    if (buf1 == NULL)


        err(EXIT_FAILURE, "malloc()");


    p = buf1;


    p = stpcpy(p, "Hello ");


    p = stpcpy(p, "world");


    p = stpcpy(p, "!");


    len = p - buf1;


    printf("[len = %zu]: ", len);


    puts(buf1);  // "Hello world!"


    free(buf1);


    exit(EXIT_SUCCESS);
}

SEE ALSO¶

strcpy(3), strdup(3), string(3), wcpcpy(3), string_copying(7)