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


Write to an SDL_IOStream data stream.

Header File

Defined in <SDL3/SDL_iostream.h>


size_t SDL_WriteIO(SDL_IOStream *context, const void *ptr, size_t size);

Function Parameters

SDL_IOStream * context a pointer to an SDL_IOStream structure.
const void * ptr a pointer to a buffer containing data to write.
size_t size the number of bytes to write.

Return Value

(size_t) Returns the number of bytes written, which will be less than size on error; call SDL_GetError() for more information.


This function writes exactly size bytes from the area pointed at by ptr to the stream. If this fails for any reason, it'll return less than size to demonstrate how far the write progressed. On success, it returns size.

On error, this function still attempts to write as much as possible, so it might return a positive value less than the requested write size.

The caller can use SDL_GetIOStatus() to determine if the problem is recoverable, such as a non-blocking write that can simply be retried later, or a fatal error.


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.