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

Synopsis:
    #include <string.h>
    char *strcat( char *dst, const char *src );
    char __far *_fstrcat( char __far *dst,
                          const char __far *src );
    #include <wchar.h>
    wchar_t *wcscat( wchar_t *dst, const wchar_t *src );
    #include <mbstring.h>
    unsigned char *_mbscat( unsigned char *dst,
                      const unsigned char *src );
    unsigned char __far *_fmbscat( unsigned char __far *dst,
                             const unsigned char __far *src );

Description:
    The strcat function appends a copy of the string pointed to by src
    (including the terminating null character) to the end of the string
    pointed to by dst.  The first character of src overwrites the null
    character at the end of dst.

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

    The wcscat function is a wide-character version of strcat that operates
    with wide-character strings.

    The _mbscat function is a multibyte character version of strcat that
    operates with multibyte character strings.

Returns:
    The value of dst is returned.

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

    void main()
      {
        char buffer[80];

        strcpy( buffer, "Hello " );
        strcat( buffer, "world" );
        printf( "%s\n", buffer );
      }

    produces the following:

    Hello world

Classification:
    strcat is ANSI, _fstrcat is not ANSI, wcscat is ANSI, _mbscat is not
    ANSI, _fmbscat is not ANSI

Systems:
     strcat - All, Netware

    _fstrcat - All
    wcscat - All
    _mbscat - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32
    _fmbscat - DOS, Windows, Win386, Win32, OS/2 1.x(all), OS/2-32

See Also:
    strncat