NAZWA¶

strcat, strncat - połączenie dwóch łańcuchów

LIBRARY¶

Standard C library (libc, -lc)

SKŁADNIA¶

#include <string.h>

char *strcat(char *restrict dest, const char *restrict src);
char *strncat(char *restrict dest, const char *restrict src, size_t n);

OPIS¶

Funkcja strcat() dołącza łańcuch src do łańcucha dest, nadpisując znak null ('\0') kończący dest i dodając znak null na końcu wyniku. Łańcuchy nie mogą na siebie nachodzić a łańcuch dest musi zawierać dostateczną ilość miejsca na wynik. Jeśli dest nie zawiera wystarczającej ilości miejsca, to zachowanie programu jest nieprzewidywalne, gdyż występuje przepełnienie bufora, które jest najbardziej popularnym sposobem atakowania bezpiecznych programów.

Funkcja strncat() jest podobna, z wyjątkiem tego, że

• użyje co najwyżej n bajtów z src oraz
• src nie musi być zakończony znakiem null, jeśli zawiera n lub więcej bajtów.

Tak jak w przypadku strcat() wynikowy łańcuch w dest jest zawsze zakończony znakiem null.

Jeśli src zawiera n lub więcej bajtów, to strncat() zapisze n+1 w dest (n z src plus kończący bajt null). Dlatego też rozmiar dest musi wynosić co najmniej strlen(dest)+n+1.

Prosta implementacja strncat() mogłaby wyglądać tak:

char *
strncat(char *dest, const char *src, size_t n)
{


    size_t dest_len = strlen(dest);


    size_t i;


    for (i = 0 ; i < n && src[i] != '\0' ; i++)


        dest[dest_len + i] = src[i];


    dest[dest_len + i] = '\0';


    return dest;
}

WARTOŚĆ ZWRACANA¶

Funkcje strcat() i strncat() zwracają wskaźnik do wynikowego łańcucha dest.

ATRYBUTY¶

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

STANDARDY¶

POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD.

UWAGI¶

Niektóre systemy (BSD, Solaris i inne) zawierają następującą funkcję:

size_t strlcat(char *dest, const char *src, size_t size);

Funkcja dołączą zakończony znakiem null łańcuch src do łańcucha dest, kopiując z src co najwyżej size-strlen(dest)-1 znaków i dodając kończący znak null, chyba że size jest mniejsze od strlen(dest). Funkcja rozwiązuje problem przepełnienia bufora występujący w strcat(), jednakże program wywołujący wciąż musi obsłużyć możliwość utraty danych, jeśli size jest za małe. Funkcja zwraca długość łańcucha, który strlcat() próbowało utworzyć; jeśli wartość zwrócona jest większa lub równa size, to część danych została utracona. Jeśli utrata danych ma znaczenie, to program wywołujący musi albo sprawdzać argumenty przed wywołaniem, albo sprawdzać wartość zwracaną. strlcat() nie jest obecna w glibc i nie jest opisana w standardzie POSIX, jednak jest dostępna w Linuksie w bibliotece libbsd.

PRZYKŁADY¶

Ponieważ strcat() i strncat() muszą odnaleźć bajt null kończący łańcuch dest za pomocą wyszukiwania rozpoczynającego się od początku łańcucha, czas wykonania tych funkcji skaluje się zgodnie z długością łańcucha dest. Można to pokazać wykonując poniższy program (jeśli celem jest połączenie wielu łańcuchów, to ręczne skopiowanie bajtów z każdego łańcucha źródłowego przy zachowaniu wskaźnika na koniec łańcucha docelowego da lepszą wydajność).

#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <time.h>
int
main(void)
{
#define LIM 4000000


    char p[LIM + 1];    /* +1 for terminating null byte */


    time_t base;


    base = time(NULL);


    p[0] = '\0';


    for (unsigned int j = 0; j < LIM; j++) {


        if ((j % 10000) == 0)


            printf("%u %jd\n", j, (intmax_t) (time(NULL) - base));


        strcat(p, "a");


    }
}

ZOBACZ TAKŻE¶

bcopy(3), memccpy(3), memcpy(3), strcpy(3), string(3), strncpy(3), wcscat(3), wcsncat(3)

TŁUMACZENIE¶

Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.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 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.