strcat(D3)

NAME
     strcat - concatenate strings

SYNOPSIS
     #include <sys/types.h>
     #include <sys/ddi.h>
     char *strcat(char *sptr1, const char *sptr2)

   Arguments
     The arguments sptr1 and sptr2 each point to strings, and each string is
     an array of characters terminated by a null-character.

DESCRIPTION
     The function strcat appends a copy of the string pointed to by sptr2
     including the terminating null-character to the end of the string pointed
     to by sptr1.  The initial character in the string pointed to by sptr2
     replaces the null-character at the end of the string pointed to by sptr1.

     The function strcat alters sptr1 without checking for overflow of the
     array pointed to by sptr1.  If copying takes place between strings that
     overlap, the behavior is undefined.

   Return Values
     The function strcat returns the value of sptr1, which points to the
     null-terminated result.

USAGE
     Character movement is performed differently in different implementations;
     thus, overlapping moves may yield surprises.

   Level
     Base or Interrupt.

   Synchronization Constraints
     Does not sleep.

     Driver-defined basic locks, read/write locks, and sleep locks may be held
     across calls to this function.

REFERENCES
     bcopy(D3)