STRCPY(3)               NetBSD Library Functions Manual              STRCPY(3)

NAME
     strcpy, strncpy -- copy strings

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <string.h>

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

     char *
     strncpy(char * restrict dst, const char * restrict src, size_t len);

DESCRIPTION
     The strcpy() and strncpy() functions copy the string src to dst (includ-
     ing the terminating `\0' character).

     The strncpy() function copies not more than len characters into dst,
     appending `\0' characters if src is less than len characters long, and
     not terminating dst if src is len or more characters long.

RETURN VALUES
     The strcpy() and strncpy() functions return dst.

EXAMPLES
     The following sets ``chararray'' to ``abc\0\0\0''.

           (void)strncpy(chararray, "abc", 6);

     The following sets ``chararray'' to ``abcdef'' and does not nul-terminate
     chararray because the source string is >= the length parameter.
     strncpy() only nul-terminates the destination string when the length of
     the source string is less than the length parameter.

           (void)strncpy(chararray, "abcdefgh", 6);

     The following copies as many characters from input to buf as will fit and
     nul-terminates the result.  Because strncpy() does not guarantee to nul-
     terminate the string itself, we must do this by hand.

           char buf[BUFSIZ];

           (void)strncpy(buf, input, sizeof(buf) - 1);
           buf[sizeof(buf) - 1] = '\0';

     Note that strlcpy(3) is a better choice for this kind of operation.  The
     equivalent using strlcpy(3) is simply:

           (void)strlcpy(buf, input, sizeof(buf));

SEE ALSO
     bcopy(3), memccpy(3), memcpy(3), memmove(3), strlcpy(3)

STANDARDS
     The strcpy() and strncpy() functions conform to ISO/IEC 9899:1999
     (``ISO C99'').

NetBSD 5.0.1                      May 6, 2002                     NetBSD 5.0.1

You can also request any man page by name and (optionally) by section:

Command: 
Section: 
Architecture: 
Collection: 
 

Use the DEFAULT collection to view manual pages for third-party software.


©1994 Man-cgi 1.15, Panagiotis Christias <christia@softlab.ntua.gr>
©1996-2014 Modified for NetBSD by Kimmo Suominen