[#bsl-basic_istringstream-get-0c]
= xref:bsl.adoc[bsl]::xref:bsl/basic_istringstream.adoc[basic&lowbar;istringstream]::get
:relfileprefix: ../../
:mrdocs:

`get` overloads

== Synopses

Declared in `&lt;bslstl&lowbar;istringstream&period;h&gt;`

Extract one character from the stream&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_istringstream/int_type.adoc[int&lowbar;type]
xref:bsl/basic_istringstream/get-0f.adoc[get]();
----

[.small]#xref:bsl/basic_istringstream/get-0f.adoc[_» more&period;&period;&period;_]#

Extraction into another streambuf&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lowbar;&lowbar;istream&lowbar;type&
xref:bsl/basic_istringstream/get-0e.adoc[get](&lowbar;&lowbar;streambuf&lowbar;type& &lowbar;&lowbar;sb);
----

[.small]#xref:bsl/basic_istringstream/get-0e.adoc[_» more&period;&period;&period;_]#

Simple extraction&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lowbar;&lowbar;istream&lowbar;type&
xref:bsl/basic_istringstream/get-03.adoc[get](char&lowbar;type& &lowbar;&lowbar;c);
----

[.small]#xref:bsl/basic_istringstream/get-03.adoc[_» more&period;&period;&period;_]#

Extract one character into `character`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_istringstream.adoc[BaseStream]&
xref:bsl/basic_istringstream/get-090d.adoc[get](xref:bsl/basic_istringstream/char_type.adoc[char&lowbar;type]& character);
----

[.small]#xref:bsl/basic_istringstream/get-090d.adoc[_» more&period;&period;&period;_]#

Extract characters into `streambuf` until a newline&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_istringstream.adoc[BaseStream]&
xref:bsl/basic_istringstream/get-093.adoc[get](std::basic&lowbar;streambuf&lt;char&lowbar;type, traits&lowbar;type&gt;& streambuf);
----

[.small]#xref:bsl/basic_istringstream/get-093.adoc[_» more&period;&period;&period;_]#

Extraction into another streambuf&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lowbar;&lowbar;istream&lowbar;type&
xref:bsl/basic_istringstream/get-05.adoc[get](
    &lowbar;&lowbar;streambuf&lowbar;type& &lowbar;&lowbar;sb,
    char&lowbar;type &lowbar;&lowbar;delim);
----

[.small]#xref:bsl/basic_istringstream/get-05.adoc[_» more&period;&period;&period;_]#

Extract characters into `streambuf` until `delimiter`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_istringstream.adoc[BaseStream]&
xref:bsl/basic_istringstream/get-090a.adoc[get](
    std::basic&lowbar;streambuf&lt;char&lowbar;type, traits&lowbar;type&gt;& streambuf,
    xref:bsl/basic_istringstream/char_type.adoc[char&lowbar;type] delimiter);
----

[.small]#xref:bsl/basic_istringstream/get-090a.adoc[_» more&period;&period;&period;_]#

Simple multiple&hyphen;character extraction&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lowbar;&lowbar;istream&lowbar;type&
xref:bsl/basic_istringstream/get-01.adoc[get](
    char&lowbar;type* &lowbar;&lowbar;s,
    streamsize &lowbar;&lowbar;n);
----

[.small]#xref:bsl/basic_istringstream/get-01.adoc[_» more&period;&period;&period;_]#

Extract up to `count` characters into `buffer`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_istringstream.adoc[BaseStream]&
xref:bsl/basic_istringstream/get-0b.adoc[get](
    xref:bsl/basic_istringstream/char_type.adoc[char&lowbar;type]* buffer,
    std::streamsize count);
----

[.small]#xref:bsl/basic_istringstream/get-0b.adoc[_» more&period;&period;&period;_]#

Simple multiple&hyphen;character extraction&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
&lowbar;&lowbar;istream&lowbar;type&
xref:bsl/basic_istringstream/get-00.adoc[get](
    char&lowbar;type* &lowbar;&lowbar;s,
    streamsize &lowbar;&lowbar;n,
    char&lowbar;type &lowbar;&lowbar;delim);
----

[.small]#xref:bsl/basic_istringstream/get-00.adoc[_» more&period;&period;&period;_]#

Extract characters into `buffer` until `delimiter`&period;


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:bsl/basic_istringstream.adoc[BaseStream]&
xref:bsl/basic_istringstream/get-06.adoc[get](
    xref:bsl/basic_istringstream/char_type.adoc[char&lowbar;type]* buffer,
    std::streamsize count,
    xref:bsl/basic_istringstream/char_type.adoc[char&lowbar;type] delimiter);
----

[.small]#xref:bsl/basic_istringstream/get-06.adoc[_» more&period;&period;&period;_]#

== Return Value

* the extracted character traits value, or eof on failure
* &ast;this
* a reference to this stream

== Parameters

[cols="1,4"]
|===
| Name| Description
| *&lowbar;&lowbar;sb*
| A streambuf in which to store data&period;
| *&lowbar;&lowbar;c*
| The character in which to store data&period;
| *character*
| destination for the extracted character
| *streambuf*
| destination stream buffer
| *&lowbar;&lowbar;delim*
| A &quot;stop&quot; character&period;
| *delimiter*
| character that stops extraction
| *&lowbar;&lowbar;s*
| Pointer to an array&period;
| *&lowbar;&lowbar;n*
| Maximum number of characters to store in _s&period;_
| *buffer*
| destination character array
| *count*
| maximum number of characters to extract
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
