1STRCAT(P)                  POSIX Programmer's Manual                 STRCAT(P)
2
3
4

NAME

6       strcat - concatenate two strings
7

SYNOPSIS

9       #include <string.h>
10
11       char *strcat(char *restrict s1, const char *restrict s2);
12
13

DESCRIPTION

15       The  strcat()  function shall append a copy of the string pointed to by
16       s2 (including the terminating null byte)  to  the  end  of  the  string
17       pointed  to  by  s1. The initial byte of s2 overwrites the null byte at
18       the end of s1. If copying takes place between objects that overlap, the
19       behavior is undefined.
20

RETURN VALUE

22       The  strcat()  function shall return s1; no return value is reserved to
23       indicate an error.
24

ERRORS

26       No errors are defined.
27
28       The following sections are informative.
29

EXAMPLES

31       None.
32

APPLICATION USAGE

34       This issue is aligned with the ISO C standard;  this  does  not  affect
35       compatibility  with XPG3 applications. Reliable error detection by this
36       function was never guaranteed.
37

RATIONALE

39       None.
40

FUTURE DIRECTIONS

42       None.
43

SEE ALSO

45       strncat()  ,  the  Base  Definitions  volume  of  IEEE Std 1003.1-2001,
46       <string.h>
47

49       Portions  of  this text are reprinted and reproduced in electronic form
50       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
51       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
52       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
53       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
54       event of any discrepancy between this version and the original IEEE and
55       The  Open Group Standard, the original IEEE and The Open Group Standard
56       is the referee document. The original Standard can be  obtained  online
57       at http://www.opengroup.org/unix/online.html .
58
59
60
61IEEE/The Open Group                  2003                            STRCAT(P)
Impressum