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.