basic_istringstream 類別

描述物件，控制從類別 資料流程緩衝區擷取專案和編碼物件， < basic_stringbuf Elem 、 Tr 、 。 Alloc>

語法

template <class Elem, class Tr = char_traits<Elem>, class Alloc = allocator<Elem>>
class basic_istringstream : public basic_istream<Elem, Tr>

參數

Alloc
配置器類別。

Elem
字串之基本項目的類型。

Tr
字元特性是在字串的基本項目上特製化。

備註

類別範本描述物件，該物件會控制從類別 資料流程緩衝區擷取元素和編碼的物件， < 該資料流程緩衝區basic_stringbuf Elem、 Tr 、 Alloc> 具有 Elem 類型的 元素，其字元特性是由 Tr 類別 決定，以及其元素是由 Alloc 類別 的配置器所配置。 物件會儲存類別的物件basic_stringbuf < Elem 、 Tr 、 Alloc> 。

建構函式

建構函式	描述
basic_istringstream	建構類型 basic_istringstream 的物件。

Typedefs

類型名稱	描述
allocator_type	此類型是範本參數 Alloc的同義字。

成員函式

成員函數	描述
rdbuf	傳回 類型 pointer 之預存資料流程緩衝區的位址，以 basic_stringbuf Elem< 、 。 TrAlloc>
str	設定或取得字串緩衝區中的文字，而不需要變更寫入位置。
swap	結算所提供物件的這個 basic_istringstream 物件中的值。

操作員

運算子	描述
operator=	從物件參數將值指派給這個 basic_istringstream 物件。

需求

Header： < sstream>

命名空間：std

basic_istringstream：：allocator_type

此類型是範本參數 Alloc的同義字。

typedef Alloc allocator_type;

basic_istringstream：：basic_istringstream

建構類型 basic_istringstream 的物件。

explicit basic_istringstream(
    ios_base::openmode _Mode = ios_base::in);

explicit basic_istringstream(
    const basic_string<Elem, Tr, Alloc>& str,
    ios_base::openmode _Mode = ios_base::in);

basic_istringstream(
    basic_istringstream&& right);

參數

_模式
ios_base::openmode 中的其中一個列舉。

str
basic_string 類型的物件。

right
basic_istringstream 物件的右值參考。

備註

第一個建構函式會呼叫 basic_istream]( sb ) 來初始化基類，其中 sb 是 類別 basic_stringbuf< Elem, Tr, Alloc> 的預存物件。 它也會藉由呼叫 basic_stringbuf< Elem, Tr, Alloc >( _Mode | ios_base::in ) 來初始化 sb 。 如需詳細資訊，請參閱 basic_istream 和 basic_stringbuf。

第二個建構函式會藉由呼叫 basic_istream( sb ) 初始化基底類別。 它也會藉由呼叫 basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::in ) 來初始化 sb 。

第三個建構函式會使用右 的內容 初始化 物件，並視為右值參考。

basic_istringstream：：operator=

從物件參數將值指派給這個 basic_istringstream 物件。

basic_istringstream& operator=(basic_istringstream&& right);

參數

right
basic_istringstream 物件的右值參考。

備註

成員運算子會將 物件的內容取代為右 的內容 ，被視為右值參考移動指派。

basic_istringstream：：rdbuf

傳回 類型 pointer 之預存資料流程緩衝區的位址，以 basic_stringbuf < Elem 、Tr 、。 Alloc>

basic_stringbuf<Elem, Tr, Alloc> *rdbuf() const;

傳回值

類型為 basic_stringbuf < Elem 、 Tr 、 Alloc> 的預存資料流程緩衝區 pointer 位址。

範例

如需使用 rdbuf 的範例，請參閱 basic_filebuf:: close。

basic_istringstream：：str

設定或取得字串緩衝區中的文字，而不需要變更寫入位置。

basic_string<Elem, Tr, Alloc> str() const;

void str(
    const basic_string<Elem, Tr, Alloc>& _Newstr);

參數

_Newstr
新字串。

傳回值

傳回類別 basic_string < Elem ， Tr ， 的物件， Alloc> 其受控制序列是 所 *this 控制之序列的複本。

備註

第一個成員函式會傳 回 rdbuf - > str 。 第二個成員函式會呼叫 rdbuf - > str （ _Newstr 。

範例

如需使用 str 的範例，請參閱 basic_stringbuf：：str 。

basic_istringstream：：swap

交換兩個 basic_istringstream 物件的值。

void swap(basic_istringstream& right);

參數

right
basic_istringstream 物件的 lvalue 參考。

備註

成員函式會交換這個物件的值和右邊 的值 。

另請參閱

C++ 標準程式庫中的執行緒安全
iostream 程式設計
iostreams 慣例