logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

SDL_LoadFileAsync - Load all the data from a file path, asynchronously.

Availability

       This function is available since SDL 3.2.0.

Description

       This  function returns as quickly as possible; it does not wait for the read to complete. On a successful
       return, this work will continue in the background. If the work begins, even failure  is  asynchronous:  a
       failing return value from this function only means the work couldn't start at all.

       The  data  is allocated with a zero byte at the end (null terminated) for convenience. This extra byte is
       not included in SDL_AsyncIOOutcome's bytes_transferred value.

       This function will allocate the buffer to contain the file. It must be deallocated by calling  SDL_free()
       on SDL_AsyncIOOutcome's buffer field after completion.

       An  SDL_AsyncIOQueue  must be specified. The newly-created task will be added to it when it completes its
       work.

Function Parameters

file   the path to read all available data from.

       queue  a queue to add the new SDL_AsyncIO to.

       userdata
              an app-defined pointer that will be provided with the task results.

Name

       SDL_LoadFileAsync - Load all the data from a file path, asynchronously.

Return Value

       for more information.

See Also

SDL_LoadFile_IO(3)

Simple Directmedia Layer                           SDL 3.2.20                               SDL_LoadFileAsync(3)

Synopsis

#include<SDL3/SDL_asyncio.h>boolSDL_LoadFileAsync(constchar*file,SDL_AsyncIOQueue*queue,void*userdata);

See Also