table of contents
other sections
STRCAT(3) | Podręcznik programisty Linuksa | STRCAT(3) |
NAZWA¶
strcat, strncat - połączenie dwóch łańcuchówSKŁADNIA¶
#include <string.h> char *strcat(char *dest, const char *src); char *strncat(char *dest, const char *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.
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¶
Wielowątkowość (patrz pthreads(7))¶
Funkcje strcat() i strncat() są bezpieczne dla wątków.ZGODNE Z¶
SVr4, 4.3BSD, C89, C99.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.
ZOBACZ TAKŻE¶
bcopy(3), memccpy(3), memcpy(3), strcpy(3), string(3), strncpy(3), wcscat(3), wcsncat(3)O STRONIE¶
Angielska wersja tej strony pochodzi z wydania 3.71 projektu Linux man-pages. Opis projektu, informacje dotyczące zgłaszania błędów, oraz najnowszą wersję oryginału można znaleźć pod adresem http://www.kernel.org/doc/man-pages/.TŁUMACZENIE¶
Autorami polskiego tłumaczenia niniejszej strony podręcznika man są: Andrzej Krzysztofowicz (PTM) <ankry@mif.pg.gda.pl> i Robert Luberda <robert@debian.org>. Polskie tłumaczenie jest częścią projektu manpages-pl; uwagi, pomoc, zgłaszanie błędów na stronie http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją 3.71 oryginału.2014-01-20 | GNU |