Character string copy with number of characters specified

[Classification]

Standard library

[Syntax]

#include <string.h>

char __near * __far strncpy(char __near *s1, const char __near *s2, size_t n);

char __far * __far _COM_strncpy_ff(char __far *s1, const char __far *s2, size_t n);

[Return value]

Returns the value of s1.

[Description]

This function copies up to n characters (null character and string following the null character are not appended) from the array indicated by s2 to the array indicated by s1. If the array indicate by s2 is shorter than n characters, null characters (\0) are appended to the duplication in the array indicated by s1, until all n characters are written. If the array indicated by s2 is equal to or greater than n characters, null characters are not appended.

The operation is undefined if the copy source and copy destination areas overlap.