Scroll to navigation

SDL_RWFromConstMem(3) SDL3 FUNCTIONS SDL_RWFromConstMem(3)

NAME

SDL_RWFromConstMem - Use this function to prepare a read-only memory buffer for use with RWops.

SYNOPSIS

#include "SDL3/SDL.h"
SDL_RWops* SDL_RWFromConstMem(const void *mem, size_t size);

DESCRIPTION

This function sets up an SDL_RWops
struct based on a memory area of a certain size. It assumes the memory area is not writable.

Attempting to write to this RWops stream will report an error without writing to the memory buffer.

This memory buffer is not copied by the RWops; the pointer you provide must remain valid until you close the stream. Closing the stream will not free the original buffer.

If you need to write to a memory buffer, you should use

SDL_RWFromMem () with a writable buffer of memory instead.

FUNCTION PARAMETERS

a pointer to a read-only buffer to feed an SDL_RWops
stream
the buffer size, in bytes

RETURN VALUE

Returns a pointer to a new SDL_RWops
structure, or NULL if it fails; call SDL_GetError () for more information.

AVAILABILITY

This function is available since SDL 3.0.0.

SEE ALSO

SDL_RWclose(3), SDL_RWFromConstMem(3), SDL_RWFromFile(3), SDL_RWFromMem(3), SDL_RWread(3), SDL_RWseek(3), SDL_RWtell(3)

SDL 3.0.0 SDL