CKTIS / C
strndup — динамично заделено копие с ограничена дължина
strndup създава самостоятелен низ от най-много първите size знака на масив и добавя нулев терминатор. Проверете резултата и го освободете с free.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <string.h>
char *strndup(const char *s, size_t size);strndup, декларирана в <string.h>, създава копие в памет, заделена сякаш чрез malloc. Копира най-много size знака от s и спира по-рано при \0. Резултатът винаги завършва с \0; ограничението не включва този терминатор.
Източникът не е задължително да завършва с нулев знак, ако съдържа поне size четими знака. В противен случай в достъпната област на паметта трябва да има терминатор, преди да бъде достигнато ограничението. Ограничението не поправя невалиден указател. Ако копирането е спряло по-рано, не приемайте, че резултатът има капацитет size + 1.
При неуспешно заделяне на памет функцията връща NULL. Проверете резултата, преди да го използвате, и освободете успешно създаденото копие с free. За разлика от strdup, strndup ограничава броя на копираните знаци.
Функцията е част от C23. Флагът на компилатора в хранилището не удостоверява наличността ѝ в продукционната среда за изпълнение; необходими са и подходящи заглавни файлове и поддръжка от библиотеката. Примерът умишлено използва масив без терминатор.
Примери
#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;
}
Резултат
hel
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.