Soldered SD Card Arduino Library 1.0.0
Easily read and write files to and form the SD card breakout! A fork of the original SDFat library by Bill Greiman.
Loading...
Searching...
No Matches
fstream Class Reference

file input/output stream. More...

#include <fstream.h>

Inherits iostream, and StreamBaseClass.

Public Member Functions

 fstream ()
 
 fstream (const char *path, openmode mode=in|out)
 
 ~fstream ()
 
void clear (iostate state=goodbit)
 
void close ()
 
void open (const char *path, openmode mode=in|out)
 
bool is_open ()
 
- Public Member Functions inherited from istream
 istream ()
 
istreamoperator>> (istream &(*pf)(istream &str))
 
istreamoperator>> (ios_base &(*pf)(ios_base &str))
 
istreamoperator>> (ios &(*pf)(ios &str))
 
istreamoperator>> (char *str)
 
istreamoperator>> (char &ch)
 
istreamoperator>> (signed char *str)
 
istreamoperator>> (signed char &ch)
 
istreamoperator>> (unsigned char *str)
 
istreamoperator>> (unsigned char &ch)
 
istreamoperator>> (bool &arg)
 
istreamoperator>> (short &arg)
 
istreamoperator>> (unsigned short &arg)
 
istreamoperator>> (int &arg)
 
istreamoperator>> (unsigned int &arg)
 
istreamoperator>> (long &arg)
 
istreamoperator>> (unsigned long &arg)
 
istreamoperator>> (double &arg)
 
istreamoperator>> (float &arg)
 
istreamoperator>> (void *&arg)
 
streamsize gcount () const
 
int get ()
 
istreamget (char &ch)
 
istreamget (char *str, streamsize n, char delim='\n')
 
istreamgetline (char *str, streamsize n, char delim='\n')
 
istreamignore (streamsize n=1, int delim=-1)
 
int peek ()
 
pos_type tellg ()
 
istreamseekg (pos_type pos)
 
istreamseekg (off_type off, seekdir way)
 
void skipWhite ()
 
- Public Member Functions inherited from ios
 ios ()
 
 operator const void * () const
 
bool operator! () const
 
 operator bool () const
 
iostate rdstate () const
 
bool good () const
 
bool eof () const
 
bool fail () const
 
bool bad () const
 
void clear (iostate state=goodbit)
 
void setstate (iostate state)
 
- Public Member Functions inherited from ios_base
 ios_base ()
 
char fill ()
 
char fill (char c)
 
fmtflags flags () const
 
fmtflags flags (fmtflags fl)
 
int precision () const
 
int precision (unsigned int n)
 
fmtflags setf (fmtflags fl)
 
fmtflags setf (fmtflags fl, fmtflags mask)
 
void unsetf (fmtflags fl)
 
unsigned width ()
 
unsigned width (unsigned n)
 
- Public Member Functions inherited from ostream
 ostream ()
 
ostreamoperator<< (ostream &(*pf)(ostream &str))
 
ostreamoperator<< (ios_base &(*pf)(ios_base &str))
 
ostreamoperator<< (bool arg)
 
ostreamoperator<< (const char *arg)
 
ostreamoperator<< (const signed char *arg)
 
ostreamoperator<< (const unsigned char *arg)
 
ostreamoperator<< (const String &arg)
 
ostreamoperator<< (char arg)
 
ostreamoperator<< (signed char arg)
 
ostreamoperator<< (unsigned char arg)
 
ostreamoperator<< (double arg)
 
ostreamoperator<< (float arg)
 
ostreamoperator<< (short arg)
 
ostreamoperator<< (unsigned short arg)
 
ostreamoperator<< (int arg)
 
ostreamoperator<< (unsigned int arg)
 
ostreamoperator<< (long arg)
 
ostreamoperator<< (unsigned long arg)
 
ostreamoperator<< (long long arg)
 
ostreamoperator<< (unsigned long long arg)
 
ostreamoperator<< (const void *arg)
 
ostreamoperator<< (const __FlashStringHelper *arg)
 
ostreamput (char ch)
 
ostreamflush ()
 
pos_type tellp ()
 
ostreamseekp (pos_type pos)
 
ostreamseekp (off_type off, seekdir way)
 

Additional Inherited Members

- Public Types inherited from ios_base
enum  seekdir { beg , cur , end }
 
typedef unsigned char iostate
 
typedef uint32_t streamsize
 
typedef uint32_t pos_type
 
typedef int32_t off_type
 
typedef uint64_t streamsize
 
typedef uint64_t pos_type
 
typedef int64_t off_type
 
typedef unsigned int fmtflags
 
typedef uint8_t openmode
 
- Static Public Attributes inherited from ios_base
static const iostate goodbit = 0x00
 
static const iostate badbit = 0X01
 
static const iostate eofbit = 0x02
 
static const iostate failbit = 0X04
 
static const fmtflags left = 0x0001
 
static const fmtflags right = 0x0002
 
static const fmtflags internal = 0x0004
 
static const fmtflags dec = 0x0008
 
static const fmtflags hex = 0x0010
 
static const fmtflags oct = 0x0020
 
static const fmtflags boolalpha = 0x0100
 
static const fmtflags showbase = 0x0200
 
static const fmtflags showpoint = 0x0400
 
static const fmtflags showpos = 0x0800
 
static const fmtflags skipws = 0x1000
 
static const fmtflags uppercase = 0x4000
 
static const fmtflags adjustfield = left | right | internal
 
static const fmtflags basefield = dec | hex | oct
 
static const openmode app = 0X4
 
static const openmode ate = 0X8
 
static const openmode binary = 0X10
 
static const openmode in = 0X20
 
static const openmode out = 0X40
 
static const openmode trunc = 0X80
 
- Protected Member Functions inherited from ios_base
uint8_t flagsToBase ()
 
- Private Types inherited from ios_base
enum  seekdir { beg , cur , end }
 
typedef unsigned char iostate
 
typedef uint32_t streamsize
 
typedef uint32_t pos_type
 
typedef int32_t off_type
 
typedef uint64_t streamsize
 
typedef uint64_t pos_type
 
typedef int64_t off_type
 
typedef unsigned int fmtflags
 
typedef uint8_t openmode
 
- Private Member Functions inherited from StreamBaseClass
void clearWriteError ()
 
int16_t getch ()
 
bool getWriteError ()
 
void open (const char *path, ios::openmode mode)
 
ios::openmode getmode ()
 
void putch (char c)
 
void putstr (const char *str)
 
bool seekoff (off_type off, seekdir way)
 
bool seekpos (pos_type pos)
 
void setmode (ios::openmode mode)
 
int write (const void *buf, size_t n)
 
void write (char c)
 
- Private Member Functions inherited from ios
 ios ()
 
 operator const void * () const
 
bool operator! () const
 
 operator bool () const
 
iostate rdstate () const
 
bool good () const
 
bool eof () const
 
bool fail () const
 
bool bad () const
 
void clear (iostate state=goodbit)
 
void setstate (iostate state)
 
- Private Member Functions inherited from ios_base
 ios_base ()
 
char fill ()
 
char fill (char c)
 
fmtflags flags () const
 
fmtflags flags (fmtflags fl)
 
int precision () const
 
int precision (unsigned int n)
 
fmtflags setf (fmtflags fl)
 
fmtflags setf (fmtflags fl, fmtflags mask)
 
void unsetf (fmtflags fl)
 
unsigned width ()
 
unsigned width (unsigned n)
 
uint8_t flagsToBase ()
 
- Static Private Attributes inherited from ios_base
static const iostate goodbit = 0x00
 
static const iostate badbit = 0X01
 
static const iostate eofbit = 0x02
 
static const iostate failbit = 0X04
 
static const fmtflags left = 0x0001
 
static const fmtflags right = 0x0002
 
static const fmtflags internal = 0x0004
 
static const fmtflags dec = 0x0008
 
static const fmtflags hex = 0x0010
 
static const fmtflags oct = 0x0020
 
static const fmtflags boolalpha = 0x0100
 
static const fmtflags showbase = 0x0200
 
static const fmtflags showpoint = 0x0400
 
static const fmtflags showpos = 0x0800
 
static const fmtflags skipws = 0x1000
 
static const fmtflags uppercase = 0x4000
 
static const fmtflags adjustfield = left | right | internal
 
static const fmtflags basefield = dec | hex | oct
 
static const openmode app = 0X4
 
static const openmode ate = 0X8
 
static const openmode binary = 0X10
 
static const openmode in = 0X20
 
static const openmode out = 0X40
 
static const openmode trunc = 0X80
 

Detailed Description

file input/output stream.

Constructor & Destructor Documentation

◆ fstream() [1/2]

fstream::fstream ( )
inline

◆ fstream() [2/2]

fstream::fstream ( const char *  path,
openmode  mode = in | out 
)
inlineexplicit

Constructor with open

Parameters
[in]pathfile to open
[in]modeopen mode

◆ ~fstream()

fstream::~fstream ( )
inline

Member Function Documentation

◆ clear()

void fstream::clear ( iostate  state = goodbit)
inline

Clear state and writeError

Parameters
[in]statenew state for stream

◆ close()

void fstream::close ( )
inline

Close a file and force cached data and directory information to be written to the storage device.

◆ is_open()

bool fstream::is_open ( )
inline
Returns
True if stream is open else false.

◆ open()

void fstream::open ( const char *  path,
openmode  mode = in | out 
)
inline

Open a fstream

Parameters
[in]pathpath to open
[in]modeopen mode

Valid open modes are (at end, ios::ate, and/or ios::binary may be added):

ios::in - Open file for reading.

ios::out or ios::out | ios::trunc - Truncate to 0 length, if existent, or create a file for writing only.

ios::app or ios::out | ios::app - Append; open or create file for writing at end-of-file.

ios::in | ios::out - Open file for update (reading and writing).

ios::in | ios::out | ios::trunc - Truncate to zero length, if existent, or create file for update.

ios::in | ios::app or ios::in | ios::out | ios::app - Append; open or create text file for update, writing at end of file.


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