SDL_strndup - Man Page

Allocate a copy of a string, up to n characters.

Synopsis

#include <SDL3/SDL_stdinc.h>

char * SDL_strndup(const char *str, size_t maxlen);

Description

This allocates enough space for a null-terminated copy of str, up to maxlen bytes, using SDL_malloc, and then makes a copy of the string into this space.

If the string is longer than maxlen bytes, the returned string will be maxlen bytes long, plus a null-terminator character that isn't included in the count.

The returned string is owned by the caller, and should be passed to SDL_free when no longer needed.

Function Parameters

str

the string to copy.

maxlen

the maximum length of the copied string, not counting the null-terminator character.

Return Value

Returns a pointer to the newly-allocated string.

Thread Safety

It is safe to call this function from any thread.

Availability

This function is available since SDL 3.2.0.

Info

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS