CKTIS / C
strncat — Anhängen mit Begrenzung der Quellbytes
strncat hängt höchstens n Quellbytes an eine Zeichenkette an und fügt '\0' hinzu. n gibt nicht die Kapazität des Zielpuffers an.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strncat(char * restrict s1, const char * restrict s2, size_t n);strncat aus <string.h> hängt höchstens n Bytes aus s2 an s1 an und stoppt früher, wenn es auf '\0' trifft. Dabei wird der bisherige Abschluss überschrieben und ein neuer angefügt. Zurückgegeben wird s1, keine Länge und keine Angabe über eine Kürzung.
s1 muss auf eine beschreibbare, nullterminierte Zeichenkette zeigen. Die Quelle muss n lesbare Bytes oder einen früheren Terminator bereitstellen. Unzureichender Speicherplatz oder überlappende Bereiche während des Kopierens führen zu undefiniertem Verhalten.
n begrenzt die Quelldaten, nicht die Größe des Ergebnisses. Verwende strlen(s1) + n + 1 nicht ohne Überlaufprüfung zur Kapazitätsprüfung: Bei vorzeichenloser Arithmetik kann ein Überlauf einen zu kleinen Wert ergeben. Wenn capacity die Kapazität des Zielpuffers in Bytes ist und strlen(s1) < capacity gilt, garantiert n <= capacity - strlen(s1) - 1 genug Platz für bis zu n anzuhängende Bytes und den neuen Terminator. Für ein korrekt terminiertes Array dst berechnet sich der freie Platz als sizeof dst - strlen(dst) - 1; verwende diese Formel nicht mit sizeof eines Zeigers. Bei n == 0 bleibt die Zeichenkette unverändert, die Zeiger müssen jedoch weiterhin gültig sein.
Beispiele
#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;
}
Ergebnis
Hi there!
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.