SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


Create a custom SDL_IOStream.

Header File

Defined in <SDL3/SDL_iostream.h>


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

Function Parameters

const SDL_IOStreamInterface * iface the function pointers that implement this SDL_IOStream.
void * userdata the app-controlled pointer that is passed to iface's functions when called.

Return Value

(SDL_IOStream *) Returns a pointer to the allocated memory on success or NULL on failure; call SDL_GetError() for more information.


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.

You must free the returned pointer with SDL_CloseIO().

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


This function is available since SDL 3.0.0.

See Also

CategoryAPI, CategoryAPIFunction, CategoryIOStream

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.