NAZWA

       stpcpy, strcpy, strcat - kopiuje lub łączy łańcuch znaków

BIBLIOTEKA

       Standardowa biblioteka C (libc, -lc)

SKŁADNIA

       #include <string.h>

       char *stpcpy(char *restrict dst, const char *restrict src);
       char *strcpy(char *restrict dst, const char *restrict src);
       char *strcat(char *restrict dst, const char *restrict src);

   Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)):

       stpcpy():
           Od glibc 2.10:
               _POSIX_C_SOURCE >= 200809L
           Przed glibc 2.10:
               _GNU_SOURCE

OPIS

       stpcpy()
       strcpy()
              Funkcje  kopiują  łańcuch,  na  który wskazuje src, do łańcucha w buforze, na który
              wskazuje dst. To programista jest odpowiedzialny  za  alokację  odpowiednio  dużego
              bufora  docelowego tj. strlen(src) + 1. Różnicę pomiędzy obiema funkcjami opisano w
              rozdziale WARTOŚĆ ZWRACANA.

       strcat()
              Funkcja dołącza łańcuch, na który wskazuje src, po łańcuchu, na który wskazuje  dst
              (nadpisując jego końcowy bajt null). To programista jest odpowiedzialny za alokację
              odpowiednio dużego bufora docelowego, tj. strlen(dst) + strlen(src) + 1.

       Implementacja tych funkcji mogłaby wyglądać tak:

           char *
           stpcpy(char *restrict dst, const char *restrict src)
           {
               char  *p;

               p = mempcpy(dst, src, strlen(src));
               *p = '\0';

               return p;
           }

           char *
           strcpy(char *restrict dst, const char *restrict src)
           {
               stpcpy(dst, src);
               return dst;
           }

           char *
           strcat(char *restrict dst, const char *restrict src)
           {
               stpcpy(dst + strlen(dst), src);
               return dst;
           }

WARTOŚĆ ZWRACANA

       stpcpy()
              Funkcja zwraca wskaźnik do końcowego bajtu null kopiowanego łańcucha.

       strcpy()
       strcat()
              Funkcje te zwracają dst.

ATRYBUTY

       Informacje  o  pojęciach  używanych  w  tym  rozdziale   można   znaleźć   w   podręczniku
       attributes(7).

       ┌────────────────────────────────────────────────┬────────────────────────┬───────────────┐
       │Interfejs                                       │ Atrybut                │ Wartość       │
       ├────────────────────────────────────────────────┼────────────────────────┼───────────────┤
       │stpcpy(), strcpy(), strcat()                    │ Bezpieczeństwo wątkowe │ MT-bezpieczne │
       └────────────────────────────────────────────────┴────────────────────────┴───────────────┘

STANDARDY

       stpcpy()
              POSIX.1-2008.

       strcpy()
       strcat()
              C11, POSIX.1-2008.

STANDARDY

       stpcpy()
              POSIX.1-2008.

       strcpy()
       strcat()
              POSIX.1-2001, C89, SVr4, 4.3BSD.

ZASTRZEŻENIA

       Łańcuchy src i dst nie mogą na siebie nachodzić.

       Jeśli  bufor  docelowy  nie jest wystarczającą duży, zachowanie jest niezdefiniowane. Zob.
       opis _FORTIFY_SOURCE w podręczniku feature_test_macros(7).

       strcat() może być bardzo mało wydajny. Proszę zapoznać się z historią o malarzu  Shlemielu
       ⟨https://www.joelonsoftware.com/2001/12/11/back-to-basics/⟩.

PRZYKŁADY

       #include <err.h>
       #include <stdio.h>
       #include <stdlib.h>
       #include <string.h>

       int
       main(void)
       {
           char    *p;
           char    *buf1;
           char    *buf2;
           size_t  len, maxsize;

           maxsize = strlen("Witaj ") + strlen("świecie") + strlen("!") + 1;
           buf1 = malloc(sizeof(*buf1) * maxsize);
           if (buf1 == NULL)
               err(EXIT_FAILURE, "malloc()");
           buf2 = malloc(sizeof(*buf2) * maxsize);
           if (buf2 == NULL)
               err(EXIT_FAILURE, "malloc()");

           p = buf1;
           p = stpcpy(p, "Witaj ");
           p = stpcpy(p, "świecie");
           p = stpcpy(p, "!");
           len = p - buf1;

           printf("[len = %zu]: ", len);
           puts(buf1);  // "Witaj świecie!"
           free(buf1);

           strcpy(buf2, "Witaj ");
           strcat(buf2, "świecie");
           strcat(buf2, "!");
           len = strlen(buf2);

           printf("[len = %zu]: ", len);
           puts(buf2);  // "Witaj świecie!"
           free(buf2);

           exit(EXIT_SUCCESS);
       }

ZOBACZ TAKŻE

       strdup(3), string(3), wcscpy(3), string_copying(7)

TŁUMACZENIE

       Autorami   polskiego   tłumaczenia  niniejszej  strony  podręcznika  są:  Jarosław  Beczek
       <bexx@poczta.onet.pl>,   Robert    Luberda    <robert@debian.org>    i    Michał    Kułach
       <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją. Bliższe informacje o warunkach licencji
       można   uzyskać   zapoznając   się   z   GNU   General   Public   License   w   wersji   3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩   lub   nowszej.   Nie  przyjmuje  się  ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy w tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej
       ⟨manpages-pl-list@lists.sourceforge.net⟩.