SDL_OpenIO - Man Page

Create a custom SDL_IOStream.

Synopsis

#include <SDL3/SDL_iostream.h>

SDL_IOStream * SDL_OpenIO(const SDL_IOStreamInterface *iface, void *userdata);

Description

Applications do not need to use this function unless they are providing their own SDL_IOStream implementation. If you just need an SDL_IOStream to read/write a common data source, you should use the built-in implementations in SDL, like SDL_IOFromFile() or SDL_IOFromMem(), etc.

This function makes a copy of iface and the caller does not need to keep it around after this call.

Function Parameters

iface

the interface that implements this SDL_IOStream, initialized using SDL_INIT_INTERFACE().

userdata

the pointer that will be passed to the interface functions.

Return Value

Returns a pointer to the allocated memory on success 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_CloseIO(3), SDL_INIT_INTERFACE(3), SDL_IOFromConstMem(3), SDL_IOFromFile(3), SDL_IOFromMem(3)

Referenced By

SDL_CloseIO(3), SDL_FlushIO(3).

SDL 3.2.16 Simple Directmedia Layer SDL3 FUNCTIONS