Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

strncat — concatenare con un limite di byte sorgente

strncat aggiunge al massimo n byte sorgente a una stringa e aggiunge '\0'. Il parametro n non indica la capacità del buffer di destinazione.

Versione: C23; repository compiler flag, production runtime not attested

Sintassi

#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);

strncat, da <string.h>, aggiunge al massimo n byte di s2 a s1, fermandosi prima se incontra '\0'. Sovrascrive il terminatore esistente e ne aggiunge uno nuovo. Restituisce s1, non una lunghezza né un’indicazione di troncamento.

s1 deve puntare a una stringa modificabile e terminata da un carattere nullo. La sorgente deve fornire n byte leggibili oppure un terminatore precedente. Spazio insufficiente o regioni sovrapposte durante la copia causano un comportamento indefinito.

n limita i dati sorgente, non la dimensione del risultato. Non verificare la capacità calcolando strlen(s1) + n + 1 senza controllare l’overflow: nell’aritmetica senza segno un overflow può produrre un valore troppo piccolo. Se capacity è la capacità del buffer di destinazione in byte e strlen(s1) < capacity, allora n <= capacity - strlen(s1) - 1 garantisce spazio per aggiungere fino a n byte e il nuovo terminatore. Per un array dst terminato correttamente, calcola lo spazio disponibile come sizeof dst - strlen(dst) - 1; non usare questa formula con sizeof applicato a un puntatore. Con n == 0, la stringa resta invariata, ma i puntatori devono comunque essere validi.

Esempi

#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;
}

Risultato

Hi there!

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti