CKTIS / C
strncat — добавяне с ограничение на байтовете от източника
strncat добавя най-много n байта от източника към низ и добавя '\0'. Параметърът n не е капацитетът на целевия буфер.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat от <string.h> добавя най-много n байта от s2 към s1 и спира по-рано, ако срещне '\0'. Функцията презаписва съществуващия нулев терминатор и добавя нов. Връща s1, а не дължина или информация за съкращаване.
s1 трябва да сочи към записваем низ, завършен с нулев знак. Източникът трябва да предоставя n четими байта или по-ранен терминатор. Недостатъчното място или припокриването на области по време на копирането води до неопределено поведение.
n ограничава данните от източника, а не размера на резултата. Не проверявайте капацитета чрез изчисляване на strlen(s1) + n + 1 без проверка за препълване: при аритметика с числа без знак препълването може да даде твърде малка стойност. Ако capacity е капацитетът на целевия буфер в байтове и strlen(s1) < capacity, тогава n <= capacity - strlen(s1) - 1 гарантира място за добавяне на до n байта и новия терминатор. За правилно завършен масив dst изчислете оставащото място като sizeof dst - strlen(dst) - 1; не използвайте тази формула с sizeof на указател. При n == 0 низът остава непроменен, но указателите все пак трябва да са валидни.
Примери
#include <stdio.h>
#include <string.h>
int main(void)
{
char dst[10] = "Hi ";
const char src[] = "there!";
size_t room = sizeof dst - strlen(dst) - 1;
strncat(dst, src, room);
puts(dst);
return 0;
}
Резултат
Hi there!
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.