strncpy

Copies a specified number of characters from one string to another string.

Library:LibC
Classification:ANSI
Service:Characters and Strings

Syntax

  #include <string.h> 
   
  char *strncpy (
     char         *dst,
     const char   *src,
     size_t        n);

Parameters

dst

(OUT) Points to the array into which to copy the characters.

src

(IN) Points to the string containing the characters to copy.

n

(IN) Specifies the number of characters to copy.

Return Values

Returns the value of dst.

Remarks

The strncpy function copies no more than n characters from the string pointed to by src into the array pointed to by dst. Copying of overlapping objects is not guaranteed to work properly.

If the string pointed to by src is shorter than n characters, NULL characters are appended to the copy in the array pointed to by dst, until n characters in all have been written. If the string pointed to by src is longer than n characters, only n characters are copied and the dst string is not null terminated.

See Also