CKTIS / C
strndup — dynamisch toegewezen kopie met lengtebeperking
strndup maakt een zelfstandige string van hoogstens de eerste size tekens van een array en voegt een nulterminator toe. Controleer het resultaat en geef het vrij met free.
Versie: C23; repository compiler flag, production runtime not attested
Syntax
#include <string.h>
char *strndup(const char *s, size_t size);strndup, gedeclareerd in <string.h>, maakt een kopie in geheugen dat is toegewezen alsof malloc is gebruikt. De functie kopieert hoogstens size tekens uit s en stopt eerder bij \0. Het resultaat eindigt altijd op \0; de limiet omvat die terminator niet.
De bron hoeft niet op nul te eindigen als deze minstens size leesbare tekens bevat. Anders moet er binnen het toegankelijke geheugen een terminator staan voordat de limiet is bereikt. De limiet maakt een ongeldige aanwijzer niet geldig. Ga er niet van uit dat het resultaat capaciteit size + 1 heeft als het kopiëren eerder is gestopt.
Bij een mislukte geheugentoewijzing retourneert de functie NULL. Controleer het resultaat voordat je het gebruikt en geef een geslaagde kopie vrij met free. In tegenstelling tot strdup beperkt strndup het aantal gekopieerde tekens.
De functie hoort bij C23. De compileroptie in de repository bewijst niet dat de functie beschikbaar is in de productie-runtime; ook geschikte headers en ondersteuning door de bibliotheek zijn vereist. Het voorbeeld gebruikt bewust een array zonder terminator.
Voorbeelden
#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;
}
Resultaat
hel
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.