Click above to get retro games delivered to your door ever month!

Synopsis:
    #include <string.h>
    char *strncpy( char *dst,
                   const char *src,
                   size_t n );
    char __far *_fstrncpy( char __far *dst,
                           const char __far *src,
                           size_t n );
    #include <wchar.h>
    wchar_t *wcsncpy( wchar_t *dst,
                      const wchar_t *src,
                      size_t n );
    #include <mbstring.h>
    unsigned char *_mbsncpy( unsigned char *dst,
                       const unsigned char *src,
                             size_t n );
    unsigned char __far *_fmbsncpy( unsigned char __far *dst,
                              const unsigned char __far *src,
                                    size_t n );

Description:
    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.  See the
     memmove function if you wish to copy objects that overlap.

    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, then the result will not be
    terminated by a null character.

    The _fstrncpy function is a data model independent form of the strncpy
    function.  It accepts far pointer arguments and returns a far pointer.
     It is most useful in mixed memory model applications.

    The wcsncpy function is a wide-character version of strncpy that
    operates with wide-character strings.

    The _mbsncpy function is a multibyte character version of strncpy that
    operates with multibyte character strings.

    The _fmbsncpy function is a data model independent form of the _mbsncpy
    function that accepts far pointer arguments.  It is most useful in mixed
    memory model applications.

Returns:
    The strncpy function returns the value of dst.

Example:
    #include <stdio.h>
    #include <string.h>

    void main()
      {
        char buffer[15];

        printf( "%s\n", strncpy( buffer, "abcdefg", 10 ) );
        printf( "%s\n", strncpy( buffer, "1234567",  6 ) );
        printf( "%s\n", strncpy( buffer, "abcdefg",  3 ) );
        printf( "%s\n", strncpy( buffer, "*******",  0 ) );
      }

    produces the following:

    abcdefg
    123456g
    abc456g
    abc456g

Classification:
    strncpy is ANSI, _fstrncpy is not ANSI, wcsncpy is ANSI, _mbsncpy is not
    ANSI, _fmbsncpy is not ANSI

Systems:
     strncpy - All, Netware

    _fstrncpy - All
    wcsncpy - All
    _mbsncpy - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32
    _fmbsncpy - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

See Also:
    strcpy, strdup