CKTIS / C
strndup — dynamisch zugewiesene Kopie mit Längenbegrenzung
strndup erstellt aus höchstens den ersten size Zeichen eines Arrays einen unabhängigen String und fügt einen Nullterminator hinzu. Prüfe das Ergebnis und gib es mit free frei.
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strndup(const char *s, size_t size);strndup, deklariert in <string.h>, erstellt eine Kopie in Speicher, der wie durch malloc zugewiesen wurde. Die Funktion kopiert höchstens size Zeichen aus s und stoppt früher bei \0. Das Ergebnis endet immer mit \0; der Grenzwert schließt diesen Terminator nicht ein.
Die Quelle muss nicht nullterminiert sein, wenn sie mindestens size lesbare Zeichen enthält. Andernfalls muss innerhalb des zugänglichen Speicherbereichs ein Terminator stehen, bevor der Grenzwert erreicht ist. Die Begrenzung macht einen ungültigen Zeiger nicht gültig. Gehe nicht davon aus, dass das Ergebnis die Kapazität size + 1 hat, wenn das Kopieren früher beendet wurde.
Bei einem Fehler beim Zuweisen des Speichers gibt die Funktion NULL zurück. Prüfe das Ergebnis vor der Verwendung und gib eine erfolgreiche Kopie mit free frei. Anders als strdup begrenzt strndup die Anzahl der kopierten Zeichen.
Die Funktion gehört zu C23. Das Compiler-Flag im Repository belegt nicht, dass sie in der Produktionslaufzeitumgebung verfügbar ist; auch geeignete Header und Unterstützung durch die Bibliothek sind erforderlich. Das Beispiel verwendet absichtlich ein Array ohne Terminator.
Beispiele
#define _POSIX_C_SOURCE 200809L
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
int main(void)
{
const char data[] = {'h', 'e', 'l', 'l', 'o'};
char *copy = strndup(data, 3);
if (copy == NULL) return EXIT_FAILURE;
puts(copy);
free(copy);
return EXIT_SUCCESS;
}
Ergebnis
hel
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.