База знанияИзпитен център
BGБългарски
Избери език13

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!

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници