Lstrncpy

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

Library:LibC
Classification:Other
Service:Characters and Strings

Syntax

  #include <string.h> 
   
  char *Lstrncpy (
     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 Lstrncpy function is a double-byte character interface. It 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-1 characters are copied and the dst string is null terminated.

See Also

Lstrcpy