Bitcoin Core  0.19.99
P2P Digital Currency
Public Member Functions | Protected Member Functions | Private Attributes | List of all members
CBufferedFile Class Reference

Non-refcounted RAII wrapper around a FILE* that implements a ring buffer to deserialize from. More...

#include <streams.h>

Public Member Functions

 CBufferedFile (FILE *fileIn, uint64_t nBufSize, uint64_t nRewindIn, int nTypeIn, int nVersionIn)
 
 ~CBufferedFile ()
 
 CBufferedFile (const CBufferedFile &)=delete
 
CBufferedFileoperator= (const CBufferedFile &)=delete
 
int GetVersion () const
 
int GetType () const
 
void fclose ()
 
bool eof () const
 check whether we're at the end of the source file More...
 
void read (char *pch, size_t nSize)
 read a number of bytes More...
 
uint64_t GetPos () const
 return the current reading position More...
 
bool SetPos (uint64_t nPos)
 rewind to a given reading position More...
 
bool Seek (uint64_t nPos)
 
bool SetLimit (uint64_t nPos=std::numeric_limits< uint64_t >::max())
 prevent reading beyond a certain position no argument removes the limit More...
 
template<typename T >
CBufferedFileoperator>> (T &&obj)
 
void FindByte (char ch)
 search for a given byte in the stream, and remain positioned on it More...
 

Protected Member Functions

bool Fill ()
 read data from the source to fill the buffer More...
 

Private Attributes

const int nType
 
const int nVersion
 
FILE * src
 source file More...
 
uint64_t nSrcPos
 how many bytes have been read from source More...
 
uint64_t nReadPos
 how many bytes have been read from this More...
 
uint64_t nReadLimit
 up to which position we're allowed to read More...
 
uint64_t nRewind
 how many bytes we guarantee to rewind More...
 
std::vector< char > vchBuf
 the buffer More...
 

Detailed Description

Non-refcounted RAII wrapper around a FILE* that implements a ring buffer to deserialize from.

It guarantees the ability to rewind a given number of bytes.

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

Definition at line 710 of file streams.h.

Constructor & Destructor Documentation

◆ CBufferedFile() [1/2]

CBufferedFile::CBufferedFile ( FILE *  fileIn,
uint64_t  nBufSize,
uint64_t  nRewindIn,
int  nTypeIn,
int  nVersionIn 
)
inline

Definition at line 742 of file streams.h.

◆ ~CBufferedFile()

CBufferedFile::~CBufferedFile ( )
inline

Definition at line 750 of file streams.h.

◆ CBufferedFile() [2/2]

CBufferedFile::CBufferedFile ( const CBufferedFile )
delete

Member Function Documentation

◆ eof()

bool CBufferedFile::eof ( ) const
inline

check whether we're at the end of the source file

Definition at line 771 of file streams.h.

Here is the caller graph for this function:

◆ fclose()

void CBufferedFile::fclose ( )
inline

Definition at line 762 of file streams.h.

◆ Fill()

bool CBufferedFile::Fill ( )
inlineprotected

read data from the source to fill the buffer

Definition at line 725 of file streams.h.

◆ FindByte()

void CBufferedFile::FindByte ( char  ch)
inline

search for a given byte in the stream, and remain positioned on it

Definition at line 846 of file streams.h.

Here is the caller graph for this function:

◆ GetPos()

uint64_t CBufferedFile::GetPos ( ) const
inline

return the current reading position

Definition at line 796 of file streams.h.

Here is the caller graph for this function:

◆ GetType()

int CBufferedFile::GetType ( ) const
inline

Definition at line 760 of file streams.h.

◆ GetVersion()

int CBufferedFile::GetVersion ( ) const
inline

Definition at line 759 of file streams.h.

◆ operator=()

CBufferedFile& CBufferedFile::operator= ( const CBufferedFile )
delete

◆ operator>>()

template<typename T >
CBufferedFile& CBufferedFile::operator>> ( T &&  obj)
inline

Definition at line 839 of file streams.h.

Here is the call graph for this function:

◆ read()

void CBufferedFile::read ( char *  pch,
size_t  nSize 
)
inline

read a number of bytes

Definition at line 776 of file streams.h.

Here is the call graph for this function:

◆ Seek()

bool CBufferedFile::Seek ( uint64_t  nPos)
inline

Definition at line 817 of file streams.h.

◆ SetLimit()

bool CBufferedFile::SetLimit ( uint64_t  nPos = std::numeric_limits<uint64_t>::max())
inline

prevent reading beyond a certain position no argument removes the limit

Definition at line 831 of file streams.h.

Here is the caller graph for this function:

◆ SetPos()

bool CBufferedFile::SetPos ( uint64_t  nPos)
inline

rewind to a given reading position

Definition at line 801 of file streams.h.

Here is the caller graph for this function:

Member Data Documentation

◆ nReadLimit

uint64_t CBufferedFile::nReadLimit
private

up to which position we're allowed to read

Definition at line 719 of file streams.h.

◆ nReadPos

uint64_t CBufferedFile::nReadPos
private

how many bytes have been read from this

Definition at line 718 of file streams.h.

◆ nRewind

uint64_t CBufferedFile::nRewind
private

how many bytes we guarantee to rewind

Definition at line 720 of file streams.h.

◆ nSrcPos

uint64_t CBufferedFile::nSrcPos
private

how many bytes have been read from source

Definition at line 717 of file streams.h.

◆ nType

const int CBufferedFile::nType
private

Definition at line 713 of file streams.h.

◆ nVersion

const int CBufferedFile::nVersion
private

Definition at line 714 of file streams.h.

◆ src

FILE* CBufferedFile::src
private

source file

Definition at line 716 of file streams.h.

◆ vchBuf

std::vector<char> CBufferedFile::vchBuf
private

the buffer

Definition at line 721 of file streams.h.


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