id3lib  3.8.3
Public Types | Public Member Functions | Static Public Attributes | List of all members
ID3_Reader Class Referenceabstract

#include <reader.h>

Inheritance diagram for ID3_Reader:
ID3_IStreamReader ID3_MemoryReader ID3_IFStreamReader

Public Types

typedef uint32 size_type
 
typedef uint8 char_type
 
typedef uint32 pos_type
 
typedef int32 off_type
 
typedef int16 int_type
 

Public Member Functions

virtual void close ()=0
 Close the reader. More...
 
virtual pos_type getBeg ()
 Return the beginning position in the reader. More...
 
virtual pos_type getEnd ()
 Return the ending position in the reader. More...
 
virtual pos_type getCur ()=0
 Return the current position in the reader. More...
 
virtual pos_type setCur (pos_type pos)=0
 Set the value of the current position for reading. More...
 
virtual int_type readChar ()
 Read a single character and advance the internal position. More...
 
virtual int_type peekChar ()=0
 Return the next character to be read without advancing the internal position. More...
 
virtual size_type readChars (char_type buf[], size_type len)=0
 Read up to len characters into buf and advance the internal position accordingly. More...
 
virtual size_type readChars (char buf[], size_type len)
 
virtual size_type skipChars (size_type len)
 Skip up to len chars in the stream and advance the internal position accordingly. More...
 
virtual size_type remainingBytes ()
 
virtual bool atEnd ()
 

Static Public Attributes

static const int_type END_OF_READER = -1
 

Detailed Description

Definition at line 33 of file reader.h.

Member Typedef Documentation

◆ char_type

typedef uint8 ID3_Reader::char_type

Definition at line 37 of file reader.h.

◆ int_type

typedef int16 ID3_Reader::int_type

Definition at line 40 of file reader.h.

◆ off_type

typedef int32 ID3_Reader::off_type

Definition at line 39 of file reader.h.

◆ pos_type

typedef uint32 ID3_Reader::pos_type

Definition at line 38 of file reader.h.

◆ size_type

typedef uint32 ID3_Reader::size_type

Definition at line 36 of file reader.h.

Member Function Documentation

◆ atEnd()

virtual bool ID3_Reader::atEnd ( )
inlinevirtual

Definition at line 125 of file reader.h.

◆ close()

virtual void ID3_Reader::close ( )
pure virtual

Close the reader.

Any further actions on the reader should fail.

Implemented in ID3_MemoryReader, ID3_IFStreamReader, and ID3_IStreamReader.

◆ getBeg()

virtual pos_type ID3_Reader::getBeg ( )
inlinevirtual

Return the beginning position in the reader.

Reimplemented in ID3_MemoryReader, and ID3_IStreamReader.

Definition at line 48 of file reader.h.

◆ getCur()

virtual pos_type ID3_Reader::getCur ( )
pure virtual

Return the current position in the reader.

Implemented in ID3_MemoryReader, and ID3_IStreamReader.

◆ getEnd()

virtual pos_type ID3_Reader::getEnd ( )
inlinevirtual

Return the ending position in the reader.

Reimplemented in ID3_MemoryReader, and ID3_IStreamReader.

Definition at line 51 of file reader.h.

◆ peekChar()

virtual int_type ID3_Reader::peekChar ( )
pure virtual

Return the next character to be read without advancing the internal position.

Returns END_OF_READER if there isn't a character to read.

Implemented in ID3_MemoryReader, and ID3_IStreamReader.

◆ readChar()

virtual int_type ID3_Reader::readChar ( )
inlinevirtual

Read a single character and advance the internal position.

Note that the interal position may advance more than one byte for a single character read. Returns END_OF_READER if there isn't a character to read.

Definition at line 65 of file reader.h.

◆ readChars() [1/2]

virtual size_type ID3_Reader::readChars ( char  buf[],
size_type  len 
)
inlinevirtual

Reimplemented in ID3_MemoryReader, and ID3_IStreamReader.

Definition at line 88 of file reader.h.

◆ readChars() [2/2]

virtual size_type ID3_Reader::readChars ( char_type  buf[],
size_type  len 
)
pure virtual

Read up to len characters into buf and advance the internal position accordingly.

Returns the number of characters read into buf. Note that the value returned may be less than the number of bytes that the internal position advances, due to multi-byte characters.

Implemented in ID3_MemoryReader, and ID3_IStreamReader.

◆ remainingBytes()

virtual size_type ID3_Reader::remainingBytes ( )
inlinevirtual

Definition at line 109 of file reader.h.

◆ setCur()

virtual pos_type ID3_Reader::setCur ( pos_type  pos)
pure virtual

Set the value of the current position for reading.

Implemented in ID3_MemoryReader, and ID3_IStreamReader.

◆ skipChars()

virtual size_type ID3_Reader::skipChars ( size_type  len)
inlinevirtual

Skip up to len chars in the stream and advance the internal position accordingly.

Returns the number of characters actually skipped (may be less than requested).

Definition at line 97 of file reader.h.

Member Data Documentation

◆ END_OF_READER

const ID3_Reader::int_type ID3_Reader::END_OF_READER = -1
static

Definition at line 41 of file reader.h.


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