NAME

SDL_LoadFile - Load all the data from a file path.

SYNOPSIS

#include <SDL3/SDL_iostream.h>

void * SDL_LoadFile(const char *file, size_t *datasize);

DESCRIPTION

The data is allocated with a zero byte at the end (null terminated) for convenience. This extra byte is not included in the value reported via datasize.

The data should be freed with SDL_free().

FUNCTION PARAMETERS

file

the path to read all available data from.

datasize

if not NULL, will store the number of bytes read.

RETURN VALUE

Returns the data or NULL on failure; call SDL_GetError() for more information.

THREAD SAFETY

It is safe to call this function from any thread.

AVAILABILITY

This function is available since SDL 3.2.0.

SEE ALSO

SDL_LoadFile_IO(3), SDL_SaveFile(3)