#include "SDL_stdinc.h"
#include "SDL_error.h"
#include "begin_code.h"
#include "close_code.h"

Include dependency graph for SDL_rwops.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	SDL_RWops

Macros
#define	SDL_RWOPS_UNKNOWN 0U

#define	SDL_RWOPS_WINFILE 1U

#define	SDL_RWOPS_STDFILE 2U

#define	SDL_RWOPS_JNIFILE 3U

#define	SDL_RWOPS_MEMORY 4U

#define	SDL_RWOPS_MEMORY_RO 5U

Functions
Read endian functions
Read an item of the specified endianness and return in native format.
Uint8	SDL_ReadU8 (SDL_RWops *src)

Uint16	SDL_ReadLE16 (SDL_RWops *src)

Uint16	SDL_ReadBE16 (SDL_RWops *src)

Uint32	SDL_ReadLE32 (SDL_RWops *src)

Uint32	SDL_ReadBE32 (SDL_RWops *src)

Uint64	SDL_ReadLE64 (SDL_RWops *src)

Uint64	SDL_ReadBE64 (SDL_RWops *src)

Write endian functions
Write an item of native format to the specified endianness.
size_t	SDL_WriteU8 (SDL_RWops *dst, Uint8 value)

size_t	SDL_WriteLE16 (SDL_RWops *dst, Uint16 value)

size_t	SDL_WriteBE16 (SDL_RWops *dst, Uint16 value)

size_t	SDL_WriteLE32 (SDL_RWops *dst, Uint32 value)

size_t	SDL_WriteBE32 (SDL_RWops *dst, Uint32 value)

size_t	SDL_WriteLE64 (SDL_RWops *dst, Uint64 value)

size_t	SDL_WriteBE64 (SDL_RWops *dst, Uint64 value)

RWFrom functions
Functions to create SDL_RWops structures from various data streams.
#define	RW_SEEK_SET 0

#define	RW_SEEK_CUR 1

#define	RW_SEEK_END 2

SDL_RWops *	SDL_RWFromFile (const char file, const char mode)

SDL_RWops *	SDL_RWFromFP (FILE *fp, SDL_bool autoclose)

SDL_RWops *	SDL_RWFromMem (void *mem, int size)

SDL_RWops *	SDL_RWFromConstMem (const void *mem, int size)

SDL_RWops *	SDL_AllocRW (void)

void	SDL_FreeRW (SDL_RWops *area)

Sint64	SDL_RWsize (SDL_RWops *context)

Sint64	SDL_RWseek (SDL_RWops *context, Sint64 offset, int whence)

Sint64	SDL_RWtell (SDL_RWops *context)

size_t	SDL_RWread (SDL_RWops context, void ptr, size_t size, size_t maxnum)

size_t	SDL_RWwrite (SDL_RWops context, const void ptr, size_t size, size_t num)

int	SDL_RWclose (SDL_RWops *context)

void *	SDL_LoadFile_RW (SDL_RWops src, size_t datasize, int freesrc)

void *	SDL_LoadFile (const char file, size_t datasize)

Detailed Description

This file provides a general interface for SDL to read and write data streams. It can easily be extended to files, memory, etc.

Definition in file SDL_rwops.h.

Macro Definition Documentation

◆ RW_SEEK_CUR

#define RW_SEEK_CUR 1

Seek relative to current read point

Definition at line 167 of file SDL_rwops.h.

◆ RW_SEEK_END

#define RW_SEEK_END 2

Seek relative to the end of data

Definition at line 168 of file SDL_rwops.h.

◆ RW_SEEK_SET

#define RW_SEEK_SET 0

Seek from the beginning of data

Definition at line 166 of file SDL_rwops.h.

◆ SDL_RWOPS_JNIFILE

#define SDL_RWOPS_JNIFILE 3U

Android asset

Definition at line 45 of file SDL_rwops.h.

◆ SDL_RWOPS_MEMORY

#define SDL_RWOPS_MEMORY 4U

Memory stream

Definition at line 46 of file SDL_rwops.h.

◆ SDL_RWOPS_MEMORY_RO

#define SDL_RWOPS_MEMORY_RO 5U

Read-Only memory stream

Definition at line 47 of file SDL_rwops.h.

◆ SDL_RWOPS_STDFILE

#define SDL_RWOPS_STDFILE 2U

Stdio file

Definition at line 44 of file SDL_rwops.h.

◆ SDL_RWOPS_UNKNOWN

#define SDL_RWOPS_UNKNOWN 0U

Unknown stream type

Definition at line 42 of file SDL_rwops.h.

◆ SDL_RWOPS_WINFILE

#define SDL_RWOPS_WINFILE 1U

Win32 file

Definition at line 43 of file SDL_rwops.h.

Function Documentation

◆ SDL_AllocRW()

SDL_RWops* SDL_AllocRW ( void )

◆ SDL_FreeRW()

void SDL_FreeRW ( SDL_RWops * area )

◆ SDL_LoadFile()

void* SDL_LoadFile	(	const char *	file,
		size_t *	datasize
	)

Load an entire file.

The data is allocated with a zero byte at the end (null terminated)

If datasize is not NULL, it is filled with the size of the data read.

If freesrc is non-zero, the stream will be closed after being read.

The data should be freed with SDL_free().

Returns: the data, or NULL if there was an error.

◆ SDL_LoadFile_RW()

void* SDL_LoadFile_RW	(	SDL_RWops *	src,
		size_t *	datasize,
		int	freesrc
	)

Load all the data from an SDL data stream.

The data is allocated with a zero byte at the end (null terminated)

If datasize is not NULL, it is filled with the size of the data read.

If freesrc is non-zero, the stream will be closed after being read.

The data should be freed with SDL_free().

Returns: the data, or NULL if there was an error.

◆ SDL_ReadBE16()

Uint16 SDL_ReadBE16 ( SDL_RWops * src )

◆ SDL_ReadBE32()

Uint32 SDL_ReadBE32 ( SDL_RWops * src )

◆ SDL_ReadBE64()

Uint64 SDL_ReadBE64 ( SDL_RWops * src )

◆ SDL_ReadLE16()

Uint16 SDL_ReadLE16 ( SDL_RWops * src )

◆ SDL_ReadLE32()

Uint32 SDL_ReadLE32 ( SDL_RWops * src )

◆ SDL_ReadLE64()

Uint64 SDL_ReadLE64 ( SDL_RWops * src )

◆ SDL_ReadU8()

Uint8 SDL_ReadU8 ( SDL_RWops * src )

◆ SDL_RWclose()

int SDL_RWclose ( SDL_RWops * context )

Close and free an allocated SDL_RWops structure.

Returns: 0 if successful or -1 on write error when flushing data.

◆ SDL_RWFromConstMem()

SDL_RWops* SDL_RWFromConstMem	(	const void *	mem,
		int	size
	)

◆ SDL_RWFromFile()

SDL_RWops* SDL_RWFromFile	(	const char *	file,
		const char *	mode
	)

◆ SDL_RWFromFP()

SDL_RWops* SDL_RWFromFP	(	FILE *	fp,
		SDL_bool	autoclose
	)

◆ SDL_RWFromMem()

SDL_RWops* SDL_RWFromMem	(	void *	mem,
		int	size
	)

◆ SDL_RWread()

size_t SDL_RWread	(	SDL_RWops *	context,
		void *	ptr,
		size_t	size,
		size_t	maxnum
	)

Read up to maxnum objects each of size size from the data stream to the area pointed at by ptr.

Returns: the number of objects read, or 0 at error or end of file.

◆ SDL_RWseek()

Sint64 SDL_RWseek	(	SDL_RWops *	context,
		Sint64	offset,
		int	whence
	)

Seek to offset relative to whence, one of stdio's whence values: RW_SEEK_SET, RW_SEEK_CUR, RW_SEEK_END

Returns: the final offset in the data stream, or -1 on error.

◆ SDL_RWsize()

Sint64 SDL_RWsize ( SDL_RWops * context )

Return the size of the file in this rwops, or -1 if unknown

◆ SDL_RWtell()

Sint64 SDL_RWtell ( SDL_RWops * context )

Return the current offset in the data stream, or -1 on error.

◆ SDL_RWwrite()

size_t SDL_RWwrite	(	SDL_RWops *	context,
		const void *	ptr,
		size_t	size,
		size_t	num
	)

Write exactly num objects each of size size from the area pointed at by ptr to data stream.

Returns: the number of objects written, or 0 at error or end of file.

◆ SDL_WriteBE16()

size_t SDL_WriteBE16	(	SDL_RWops *	dst,
		Uint16	value
	)

◆ SDL_WriteBE32()

size_t SDL_WriteBE32	(	SDL_RWops *	dst,
		Uint32	value
	)

◆ SDL_WriteBE64()

size_t SDL_WriteBE64	(	SDL_RWops *	dst,
		Uint64	value
	)

◆ SDL_WriteLE16()

size_t SDL_WriteLE16	(	SDL_RWops *	dst,
		Uint16	value
	)

◆ SDL_WriteLE32()

size_t SDL_WriteLE32	(	SDL_RWops *	dst,
		Uint32	value
	)

◆ SDL_WriteLE64()

size_t SDL_WriteLE64	(	SDL_RWops *	dst,
		Uint64	value
	)

◆ SDL_WriteU8()

size_t SDL_WriteU8	(	SDL_RWops *	dst,
		Uint8	value
	)

Data Structures

Macros

Functions

RWFrom functions