SDL_LoadFile(3)

SDL_LoadFile3

Load all the data from a file path.

Usage

#include "SDL3/SDL.h"

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

Header file

Defined in SDL3/SDL_iostream.h

Overview

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

This function is not thread safe.

Availability

This function is available since SDL 3.2.0.

From libsdl3-doc 3.2.10+ds-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.