std::basic_istringstream - cppreference.com https://en.cppreference.
com/w/cpp/io/basic_istringstream
std::basic_istringstream
Defined in header <sstream>
template<
class CharT,
class Traits = std::char_traits<CharT>,
class Allocator = std::allocator<CharT>
> class basic_istringstream;
The class template std::basic_istringstream implements input operations on string based streams. It
effectively stores an instance of std::basic_string and performs input operations on it.
At the low level, the class essentially wraps a raw string device implementation of std::basic_stringbuf into
a higher-level interface of std::basic_istream. The complete interface to unique std::basic_stringbuf
members is provided.
basic_ios basic_istream basic_istringstream
ios_base <CharT, Traits> <CharT, Traits> <CharT, Traits>
Inheritance diagram
Two specializations for common character types are also defined:
Defined in header <sstream>
Type Definition
istringstream basic_istringstream<char>
wistringstream basic_istringstream<wchar_t>
Member types
Member type Definition
char_type CharT
traits_type Traits ; the program is ill-formed if Traits::char_type is not CharT.
int_type Traits::int_type
pos_type Traits::pos_type
off_type Traits::off_type
allocator_type Allocator
Member functions
constructs the string stream
(constructor) (public member function)
moves the string stream
operator= (C++11) (public member function)
swaps two string streams
swap (C++11) (public member function)
returns the underlying raw string device object
rdbuf (public member function)
String operations
gets or sets the contents of underlying string device object
str (public member function)
obtains a view over the contents of underlying string device object
view (C++20) (public member function)
Non-member functions
specializes the std::swap algorithm
std::swap(std::basic_istringstream) (C++11) (function template)
1 sur 5 10/08/2021 à 15:05
std::basic_istringstream - cppreference.com https://en.cppreference.com/w/cpp/io/basic_istringstream
Inherited from std::basic_istream
Member functions
Formatted input
extracts formatted data
operator>> (public member function of std::basic_istream<CharT,Traits>)
Unformatted input
extracts characters
get (public member function of std::basic_istream<CharT,Traits>)
reads the next character without extracting it
peek (public member function of std::basic_istream<CharT,Traits>)
unextracts a character
unget (public member function of std::basic_istream<CharT,Traits>)
puts character into input stream
putback (public member function of std::basic_istream<CharT,Traits>)
extracts characters until the given character is found
getline (public member function of std::basic_istream<CharT,Traits>)
extracts and discards characters until the given character is found
ignore (public member function of std::basic_istream<CharT,Traits>)
extracts blocks of characters
read (public member function of std::basic_istream<CharT,Traits>)
extracts already available blocks of characters
readsome (public member function of std::basic_istream<CharT,Traits>)
returns number of characters extracted by last unformatted input operation
gcount (public member function of std::basic_istream<CharT,Traits>)
Positioning
returns the input position indicator
tellg (public member function of std::basic_istream<CharT,Traits>)
sets the input position indicator
seekg (public member function of std::basic_istream<CharT,Traits>)
Miscellaneous
synchronizes with the underlying storage device
sync (public member function of std::basic_istream<CharT,Traits>)
Member classes
implements basic logic for preparation of the stream for input operations
sentry (public member class of std::basic_istream<CharT,Traits>)
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
Member functions
2 sur 5 10/08/2021 à 15:05
std::basic_istringstream - cppreference.com https://en.cppreference.com/w/cpp/io/basic_istringstream
State functions
checks if no error has occurred i.e. I/O operations are available
good (public member function of std::basic_ios<CharT,Traits>)
checks if end-of-file has been reached
eof (public member function of std::basic_ios<CharT,Traits>)
checks if an error has occurred
fail (public member function of std::basic_ios<CharT,Traits>)
checks if a non-recoverable error has occurred
bad (public member function of std::basic_ios<CharT,Traits>)
checks if an error has occurred (synonym of fail())
operator! (public member function of std::basic_ios<CharT,Traits>)
operator void* (until C++11) checks if no error has occurred (synonym of !fail() )
operator bool (since C++11) (public member function of std::basic_ios<CharT,Traits>)
returns state flags
rdstate (public member function of std::basic_ios<CharT,Traits>)
sets state flags
setstate (public member function of std::basic_ios<CharT,Traits>)
modifies state flags
clear (public member function of std::basic_ios<CharT,Traits>)
Formatting
copies formatting information
copyfmt (public member function of std::basic_ios<CharT,Traits>)
manages the fill character
fill (public member function of std::basic_ios<CharT,Traits>)
Miscellaneous
manages exception mask
exceptions (public member function of std::basic_ios<CharT,Traits>)
sets the locale
imbue (public member function of std::basic_ios<CharT,Traits>)
manages associated stream buffer
rdbuf (public member function of std::basic_ios<CharT,Traits>)
manages tied stream
tie (public member function of std::basic_ios<CharT,Traits>)
narrows characters
narrow (public member function of std::basic_ios<CharT,Traits>)
widens characters
widen (public member function of std::basic_ios<CharT,Traits>)
Inherited from std::ios_base
Member functions
Formatting
manages format flags
flags (public member function of std::ios_base)
sets specific format flag
setf (public member function of std::ios_base)
clears specific format flag
unsetf (public member function of std::ios_base)
manages decimal precision of floating point operations
precision (public member function of std::ios_base)
manages field width
width (public member function of std::ios_base)
Locales
sets locale
imbue (public member function of std::ios_base)
3 sur 5 10/08/2021 à 15:05
std::basic_istringstream - cppreference.com https://en.cppreference.com/w/cpp/io/basic_istringstream
returns current locale
getloc (public member function of std::ios_base)
Internal extensible array
returns a program-wide unique integer that is safe to use as index to pword()
xalloc [static] and iword()
(public static member function of std::ios_base)
resizes the private storage if necessary and access to the long element at the
iword given index
(public member function of std::ios_base)
resizes the private storage if necessary and access to the void* element at
pword the given index
(public member function of std::ios_base)
Miscellaneous
registers event callback function
register_callback (public member function of std::ios_base)
sets whether C++ and C I/O libraries are interoperable
sync_with_stdio [static] (public static member function of std::ios_base)
Member classes
stream exception
failure (public member class of std::ios_base)
initializes standard stream objects
Init (public member class of std::ios_base)
Member types and constants
Type Explanation
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
openmode
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)
formatting flags type
The following constants are also defined:
Constant Explanation
dec use decimal base for integer I/O: see std::dec
oct use octal base for integer I/O: see std::oct
hex use hexadecimal base for integer I/O: see std::hex
basefield dec|oct|hex . Useful for masking operations
left left adjustment (adds fill characters to the right): see std::left
fmtflags
right right adjustment (adds fill characters to the left): see std::right
internal adjustment (adds fill characters to the internal designated
internal
point): see std::internal
adjustfield left|right|internal . Useful for masking operations
generate floating point types using scientific notation, or hex notation
scientific
if combined with fixed: see std::scientific
generate floating point types using fixed notation, or hex notation if
fixed
combined with scientific: see std::fixed
floatfield scientific|fixed . Useful for masking operations
insert and extract bool type in alphanumeric format: see
boolalpha
std::boolalpha
4 sur 5 10/08/2021 à 15:05
std::basic_istringstream - cppreference.com https://en.cppreference.com/w/cpp/io/basic_istringstream
generate a prefix indicating the numeric base for integer output,
showbase
require the currency indicator in monetary I/O: see std::showbase
generate a decimal-point character unconditionally for floating-point
showpoint
number output: see std::showpoint
generate a + character for non-negative numeric output: see
showpos
std::showpos
skip leading whitespace before certain input operations: see
skipws
std::skipws
unitbuf flush the output after each output operation: see std::unitbuf
replace certain lowercase letters with their uppercase
uppercase
equivalents in certain output operations: see std::uppercase
(typedef)
state of the stream type
The following constants are also defined:
Constant Explanation
goodbit no error
iostate
badbit irrecoverable stream error
failbit input/output operation failed (formatting or extraction error)
eofbit associated input sequence has reached end-of-file
(typedef)
seeking direction type
The following constants are also defined:
Constant Explanation
seekdir beg the beginning of a stream
end the ending of a stream
cur the current position of stream position indicator
(typedef)
specifies event type
event (enum)
callback function type
event_callback (typedef)
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/io/basic_istringstream&oldid=130858"
5 sur 5 10/08/2021 à 15:05
