std::strstream

From Cppreference

Jump to: navigation, search

Defined in header `<strstream>`

class strstream : public std::iostream		(deprecated)

The class strstream implements input and output operations on array-backed streams. It essentially wraps a raw array I/O device implementation (std::strstreambuf) into the higher-level interface of std::basic_iostream.

The typical implementation of strstream holds only one non-derived data member: an object of type std::strstreambuf.

[edit] Member functions


(constructor)	constructs an strstream, optionally allocating the buffer (public member function)

(destructor) [virtual]	destructs an strstream, optionally deallocating the buffer (virtual public member function)

rdbuf	obtains a pointer to the associated strstreambuf (public member function)

str	accesses the output buffer (public member function)

freeze	disables/enables automatic reallocation (public member function)

pcount	obtains the number of characters written (public member function)

Inherited from std::basic_istream

Member functions

Formatted input

operator>>	extracts formatted data (public member function of `std::basic_istream`)
Unformatted input

get	extracts characters (public member function of `std::basic_istream`)

peek	reads the next character without extracting it (public member function of `std::basic_istream`)

unget	unextracts a character (public member function of `std::basic_istream`)

putback	puts character into input stream (public member function of `std::basic_istream`)

getline	extracts characters until the given character is found (public member function of `std::basic_istream`)

ignore	extracts and discards characters until the given character is found (public member function of `std::basic_istream`)

read	extracts blocks of characters (public member function of `std::basic_istream`)

readsome	extracts already available blocks of characters (public member function of `std::basic_istream`)

gcount	returns number of characters extracted by last unformatted input operation (public member function of `std::basic_istream`)
Positioning

tellg	returns the input position indicator (public member function of `std::basic_istream`)

seekg	sets the input position indicator (public member function of `std::basic_istream`)
Miscellaneous

sync	synchronizes with the underlying storage device (public member function of `std::basic_istream`)

Member classes


sentry	implements basic logic for preparation of the stream for input operations (public member class of `std::basic_istream`)

Inherited from std::basic_ostream

Member functions

Formatted input

operator<<	inserts formatted data (public member function of `std::basic_ostream`)
Unformatted input

put	inserts a character (public member function of `std::basic_ostream`)

write	inserts blocks of characters (public member function of `std::basic_ostream`)
Positioning

tellp	returns the output position indicator (public member function of `std::basic_ostream`)

seekp	sets the output position indicator (public member function of `std::basic_ostream`)
Miscellaneous

flush	synchronizes with the underlying storage device (public member function of `std::basic_ostream`)

Member classes


sentry	implements basic logic for preparation of the stream for output operations (public member class of `std::basic_ostream`)

Inherited from std::basic_ios

Member types


Member type	Definition

`char_type`	CharT

`traits_type`	Traits

`int_type`	Traits::int_type

`pos_type`	Traits::pos_type

`off_type`	Traits::off_type

State functions

good	checks if no error has occurred i.e. I/O operations are available (public member function of `std::basic_ios`)

eof	checks if end-of-file has been reached (public member function of `std::basic_ios`)

fail	checks if a recoverable error has occurred (public member function of `std::basic_ios`)

bad	checks if a non-recoverable error has occurred (public member function of `std::basic_ios`)

operator!	checks if an error has occurred (synonym of `fail()`) (public member function of `std::basic_ios`)

operator void* operator bool (until C++11) (since C++11)	checks if no error has occurred (synonym of !fail()) (public member function of `std::basic_ios`)

rdstate	returns state flags (public member function of `std::basic_ios`)

setstate	sets state flags (public member function of `std::basic_ios`)

clear	clears error and eof flags (public member function of `std::basic_ios`)
Formatting

copyfmt	copies formatting information (public member function of `std::basic_ios`)

fill	manages the fill character (public member function of `std::basic_ios`)
Miscellaneous

exceptions	manages exception mask (public member function of `std::basic_ios`)

imbue	sets the locale (public member function of `std::basic_ios`)

rdbuf	manages associated stream buffer (public member function of `std::basic_ios`)

tie	manages tied stream (public member function of `std::basic_ios`)

narrow	narrows characters (public member function of `std::basic_ios`)

widen	widens characters (public member function of `std::basic_ios`)

Inherited from std::ios_base

Member functions

Formatting

flags	manages format flags (public member function of `std::ios_base`)

setf	sets specific format flag (public member function of `std::ios_base`)

unsetf	clears specific format flag (public member function of `std::ios_base`)

precision	manages decimal precision of floating point operations (public member function of `std::ios_base`)

width	manages field width (public member function of `std::ios_base`)
Locales

imbue	sets locale (public member function of `std::ios_base`)

getloc	returns current locale (public member function of `std::ios_base`)
Internal extensible array

xalloc [static]	returns an unique index to be used to access elements in the internal extensible array (public static member function of `std::ios_base`)

iword	accesses specified element in the internal extensible array of long elements (public member function of `std::ios_base`)

pword	accesses specified element in the internal extensible array of void* elements (public member function of `std::ios_base`)
Miscellaneous

register_callback	registers event callback function (public member function of `std::ios_base`)

sync_with_stdio [static]	sets whether C++ and C IO libraries are interoperable (public static member function of `std::ios_base`)
Member classes

failure	stream exception (public member class of `std::ios_base`)

Init	initializes standard stream objects (public member class of `std::ios_base`)

Member types and constants

Type Explanation

openmode

stream open mode type

The following constants are also defined:


Constant	Explanation

`app`	seek to the end of stream before each write

`binary`	open in binary mode

`in`	open for reading

`out`	open for writing

`trunc`	discard the contents of the stream when opening

`ate`	seek to the end of stream immediately after open

(typedef)

fmtflags

formatting flags type

The following constants are also defined:


Constant	Explanation

`dec`	use decimal base for integer I/O

`oct`	use octal base for integer I/O

`hex`	use hexadecimal base for integer I/O

`basefield`	dec\|oct\|hex\|0. Useful for masking operations

`left`	left adjustment (adds fill characters to the right)

`right`	right adjustment (adds fill characters to the left)

`internal`	internal adjustment (adds fill characters to the internal designated point)

`adjustfield`	left\|right\|internal. Useful for masking operations

`scientific`	generate floating point types using scientific notation, or hex notation if combined with fixed

`fixed`	generate floating point types using fixed notation, or hex notation if combined with scientific

`floatfield`	scientific\|fixed\|(scientific\|fixed)\|0. Useful for masking operations

`boolalpha`	insert and extract bool type in alphanumeric format

`showbase`	generate a prefix indicating the numeric base for integer output, require the currency indicator in monetary I/O

`showpoint`	generate a decimal-point character unconditionally for floating-point number output

`showpos`	generate a + character for non-negative numeric output

`skipws`	skip leading whitespace before certain input operations

`unitbuf`	flush the output after each output operation

`uppercase`	replace certain lowercase letters with their uppercase equivalents in certain output output operations

(typedef)

iostate

state of the stream type

The following constants are also defined:


Constant	Explanation

`goodbit`	no error

`badbit`	irrecoverable stream error

`failbit`	input/output operation failed (formatting or extraction error)

`eofbit`	associated input sequence has reached end-of-file

(typedef)

seekdir

seeking direction type

The following constants are also defined:


Constant	Explanation

`beg`	the beginning of a stream

`end`	the ending of a stream

`cur`	the current position of stream position indicator

(typedef)

event

specifies event type
(typedef)

event_callback

callback function type
(typedef)

std::strstream

From Cppreference

Contents

[edit] Member functions

Inherited from std::basic_istream

Member functions

Formatted input

Unformatted input

Positioning

Miscellaneous

Member classes

Inherited from std::basic_ostream

Member functions

Formatted input

Unformatted input

Positioning

Miscellaneous

Member classes

Inherited from std::basic_ios

Member types

State functions

Formatting

Miscellaneous

Inherited from std::ios_base

Member functions

Formatting

Locales

Internal extensible array

Miscellaneous

Member classes

Member types and constants