AutoFile Class Reference

Non-refcounted RAII wrapper for FILE*. More...

#include <streams.h>

Inheritance diagram for AutoFile:

Public Member Functions
	AutoFile (std::FILE *file)
	~AutoFile ()
	AutoFile (const AutoFile &)=delete
AutoFile &	operator= (const AutoFile &)=delete
bool	feof () const
int	fclose ()
std::FILE *	release ()
	Get wrapped FILE* with transfer of ownership. More...
std::FILE *	Get () const
	Get wrapped FILE* without transfer of ownership. More...
bool	IsNull () const
	Return true if the wrapped FILE* is nullptr, false otherwise. More...
std::size_t	detail_fread (Span< std::byte > dst)
	Implementation detail, only used internally. More...
void	read (Span< std::byte > dst)
void	ignore (size_t nSize)
void	write (Span< const std::byte > src)
template<typename T >
AutoFile &	operator<< (const T &obj)
template<typename T >
AutoFile &	operator>> (T &&obj)

Protected Attributes
std::FILE *	m_file

Detailed Description

Non-refcounted RAII wrapper for FILE*.

Will automatically close the file when it goes out of scope if not null. If you're returning the file pointer, return file.release(). If you need to close the file early, use file.fclose() instead of fclose(file).

Definition at line 526 of file streams.h.

Constructor & Destructor Documentation

AutoFile() [1/2]

AutoFile::AutoFile ( std::FILE *  file )

inlineexplicit

Definition at line 531 of file streams.h.

~AutoFile()

AutoFile::~AutoFile ( )

inline

Definition at line 533 of file streams.h.

Here is the call graph for this function:

AutoFile() [2/2]

AutoFile::AutoFile ( const AutoFile &  )

delete

Member Function Documentation

detail_fread()

std::size_t AutoFile::detail_fread

(

Span< std::byte >

dst

)

Implementation detail, only used internally.

Definition at line 8 of file streams.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

fclose()

int AutoFile::fclose ( )

inline

Definition at line 541 of file streams.h.

Here is the call graph for this function:

Here is the caller graph for this function:

feof()

bool AutoFile::feof ( ) const

inline

Definition at line 539 of file streams.h.

Here is the caller graph for this function:

Get()

std::FILE * AutoFile::Get ( ) const

inline

Get wrapped FILE* without transfer of ownership.

Note

Ownership of the FILE* will remain with this class. Use this only if the scope of the AutoFile outlives use of the passed pointer.

Definition at line 565 of file streams.h.

Here is the caller graph for this function:

ignore()

void AutoFile::ignore

(

size_t

nSize

)

Definition at line 22 of file streams.cpp.

Here is the call graph for this function:

IsNull()

bool AutoFile::IsNull ( ) const

inline

Return true if the wrapped FILE* is nullptr, false otherwise.

Definition at line 568 of file streams.h.

Here is the caller graph for this function:

operator<<()

template<typename T >

AutoFile & AutoFile::operator<< ( const T &  obj )

inline

Definition at line 580 of file streams.h.

Here is the call graph for this function:

operator=()

AutoFile & AutoFile::operator= ( const AutoFile &  )

delete

operator>>()

template<typename T >

AutoFile & AutoFile::operator>> ( T &&  obj )

inline

Definition at line 585 of file streams.h.

Here is the call graph for this function:

read()

void AutoFile::read

(

Span< std::byte >

dst

)

Definition at line 15 of file streams.cpp.

Here is the call graph for this function:

release()

std::FILE * AutoFile::release ( )

inline

Get wrapped FILE* with transfer of ownership.

Note

This will invalidate the AutoFile object, and makes it the responsibility of the caller of this function to clean up the returned FILE*.

Definition at line 554 of file streams.h.

Here is the caller graph for this function:

write()

void AutoFile::write

(

Span< const std::byte >

src

)

Definition at line 39 of file streams.cpp.

Here is the call graph for this function:

Member Data Documentation

m_file

std::FILE* AutoFile::m_file

protected

Definition at line 528 of file streams.h.

---

The documentation for this class was generated from the following files:

• /work/src/streams.h
• /work/src/streams.cpp