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