База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници