ios Class Reference

Error and state information for all streams. More...

#include <ios.h>

Inheritance diagram for ios:

Collaboration diagram for ios:

Public Types
typedef unsigned int	fmtflags
typedef unsigned char	iostate
typedef int32_t	off_type
typedef uint8_t	openmode
typedef uint32_t	pos_type
enum	seekdir { beg, cur, end }
typedef uint32_t	streamsize

Public Member Functions
bool	bad () const
void	clear (iostate state=goodbit)
bool	eof () const
bool	fail () const
char	fill ()
char	fill (char c)
fmtflags	flags () const
fmtflags	flags (fmtflags fl)
bool	good () const
	ios ()
	operator const void * () const
bool	operator! () const
int	precision () const
int	precision (unsigned int n)
iostate	rdstate () const
fmtflags	setf (fmtflags fl)
fmtflags	setf (fmtflags fl, fmtflags mask)
void	setstate (iostate state)
void	unsetf (fmtflags fl)
unsigned	width ()
unsigned	width (unsigned n)

Static Public Attributes
static const fmtflags	adjustfield = left | right | internal
static const openmode	app = 0X4
static const openmode	ate = 0X8
static const iostate	badbit = 0X01
static const fmtflags	basefield = dec | hex | oct
static const openmode	binary = 0X10
static const fmtflags	boolalpha = 0x0100
static const fmtflags	dec = 0x0008
static const iostate	eofbit = 0x02
static const iostate	failbit = 0X04
static const iostate	goodbit = 0x00
static const fmtflags	hex = 0x0010
static const openmode	in = 0X20
static const fmtflags	internal = 0x0004
static const fmtflags	left = 0x0001
static const fmtflags	oct = 0x0020
static const openmode	out = 0X40
static const fmtflags	right = 0x0002
static const fmtflags	showbase = 0x0200
static const fmtflags	showpoint = 0x0400
static const fmtflags	showpos = 0x0800
static const fmtflags	skipws = 0x1000
static const openmode	trunc = 0X80
static const fmtflags	uppercase = 0x4000

Detailed Description

Error and state information for all streams.

Member Typedef Documentation

typedef unsigned int ios_base::fmtflags

inherited

type for format flags

typedef unsigned char ios_base::iostate

inherited

typedef for iostate bitmask

typedef int32_t ios_base::off_type

inherited

type for relative seek offset

typedef uint8_t ios_base::openmode

inherited

typedef for iostream open mode

typedef uint32_t ios_base::pos_type

inherited

type for absolute seek position

typedef uint32_t ios_base::streamsize

inherited

unsigned size that can represent maximum file size. (violates spec - should be signed)

Member Enumeration Documentation

enum ios_base::seekdir

inherited

enumerated type for the direction of relative seeks

Enumerator
beg	seek relative to the beginning of the stream
cur	seek relative to the current stream position
end	seek relative to the end of the stream

Constructor & Destructor Documentation

ios::ios ( )

inline

Create ios with no error flags set

Member Function Documentation

bool ios::bad ( ) const

inline

Returns

true if bad bit is set else false.

void ios::clear ( iostate  state = goodbit )

inline

Clear iostate bits.

Parameters

[in]

state

The flags you want to set after clearing all flags.

bool ios::eof ( ) const

inline

Returns

true if end of file has been reached else false.

Warning: An empty file returns false before the first read.

Moral: eof() is only useful in combination with fail(), to find out whether EOF was the cause for failure

bool ios::fail ( ) const

inline

Returns

true if any iostate bit other than eof are set else false.

char ios_base::fill ( )

inlineinherited

Returns

fill character

char ios_base::fill ( char  c )

inlineinherited

Set fill character

Parameters

[in]

c

new fill character

Returns

old fill character

fmtflags ios_base::flags ( ) const

inlineinherited

Returns

format flags

fmtflags ios_base::flags ( fmtflags  fl )

inlineinherited

set format flags

Parameters

[in]

fl

new flag

Returns

old flags

bool ios::good ( ) const

inline

Returns

True if no iostate flags are set else false.

ios::operator const void * ( ) const

inline

Returns

null pointer if fail() is true.

bool ios::operator! ( ) const

inline

Returns

true if fail() else false.

int ios_base::precision ( ) const

inlineinherited

Returns

precision

int ios_base::precision ( unsigned int  n )

inlineinherited

set precision

Parameters

[in]

n

new precision

Returns

old precision

iostate ios::rdstate ( ) const

inline

Returns

The iostate flags for this file.

fmtflags ios_base::setf ( fmtflags  fl )

inlineinherited

set format flags

Parameters

[in]

fl

new flags to be or'ed in

Returns

old flags

fmtflags ios_base::setf ( fmtflags  fl, fmtflags  mask  )

inlineinherited

modify format flags

Parameters

[in]	mask	flags to be removed
[in]	fl	flags to be set after mask bits have been cleared

Returns

old flags

void ios::setstate ( iostate  state )

inline

Set iostate bits.

Parameters

[in]

state

Bitts to set.

void ios_base::unsetf ( fmtflags  fl )

inlineinherited

clear format flags

Parameters

[in]

fl

flags to be cleared

Returns

old flags

unsigned ios_base::width ( )

inlineinherited

Returns

width

unsigned ios_base::width ( unsigned  n )

inlineinherited

set width

Parameters

[in]

n

new width

Returns

old width

Member Data Documentation

const fmtflags ios_base::adjustfield = left | right | internal

staticinherited

mask for adjustfield

const openmode ios_base::app = 0X4

staticinherited

seek to end before each write

const openmode ios_base::ate = 0X8

staticinherited

open and seek to end immediately after opening

const iostate ios_base::badbit = 0X01

staticinherited

iostate bad bit for a nonrecoverable error.

const fmtflags ios_base::basefield = dec | hex | oct

staticinherited

mask for basefield

const openmode ios_base::binary = 0X10

staticinherited

perform input and output in binary mode (as opposed to text mode)

const fmtflags ios_base::boolalpha = 0x0100

staticinherited

use strings true/false for bool

const fmtflags ios_base::dec = 0x0008

staticinherited

base 10 flag

const iostate ios_base::eofbit = 0x02

staticinherited

iostate bit for end of file reached

const iostate ios_base::failbit = 0X04

staticinherited

iostate fail bit for nonfatal error

const iostate ios_base::goodbit = 0x00

staticinherited

iostate for no flags

const fmtflags ios_base::hex = 0x0010

staticinherited

base 16 flag

const openmode ios_base::in = 0X20

staticinherited

open for input

const fmtflags ios_base::internal = 0x0004

staticinherited

fill between sign/base prefix and number

const fmtflags ios_base::left = 0x0001

staticinherited

left adjust fields

const fmtflags ios_base::oct = 0x0020

staticinherited

base 8 flag

const openmode ios_base::out = 0X40

staticinherited

open for output

const fmtflags ios_base::right = 0x0002

staticinherited

right adjust fields

const fmtflags ios_base::showbase = 0x0200

staticinherited

use prefix 0X for hex and 0 for oct

const fmtflags ios_base::showpoint = 0x0400

staticinherited

always show '.' for floating numbers

const fmtflags ios_base::showpos = 0x0800

staticinherited

show + sign for nonnegative numbers

const fmtflags ios_base::skipws = 0x1000

staticinherited

skip initial white space

const openmode ios_base::trunc = 0X80

staticinherited

truncate an existing stream when opening

const fmtflags ios_base::uppercase = 0x4000

staticinherited

use uppercase letters in number representations

---

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

• Arduino/libraries/SdFat/utility/ios.h