basic_stringbuf::str

Legt fest oder ruft den Text in einen Zeichenfolgenpuffer ab, ohne die Schreibposition zu ändern.

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

Parameter

• _Newstr
  Die neue Zeichenfolge.

Rückgabewert

Gibt ein Objekt der Klasse basic_string<Elem, Tr, Alloc >, zurück, dessen gesteuerte Sequenz eine Kopie der Sequenz ist, die von *this gesteuert wird.

Hinweise

Die erste Memberfunktion gibt ein Objekt von Klasse basic_string<Elem, Tr, Alloc> zurück, dessen gesteuerte Sequenz eine Kopie der Sequenz ist, die von *this gesteuert wird.Die kopierte Sequenz hängt vom gespeicherten stringbuf Modus ab:

• Wenn mode & ios_base::out ungleich 0 ist und ein Ausgabepuffer vorhanden ist, ist die Sequenz der gesamte Ausgabepuffer (epptr - pbase-Elemente, die mit pbase starten).

• Wenn mode & ios_base::in ungleich 0 ist und einen Eingabepuffer vorhanden ist, ist die Sequenz der gesamte Eingabepuffer (egptr - eback-Elemente, die mit eback starten).

• Andernfalls ist die kopierte Sequenz leer.

Die zweite Memberfunktion gibt jede Sequenz frei, die derzeit von *this gesteuert wird.Sie wird dann eine Kopie der Sequenz zu, die von _Newstr gesteuert wird.Wenn mode & ios_base::in ungleich 0 (null) ist, legt es den Eingabepuffer fest, um Lesen zu Anfang der Sequenz zu starten.Wenn mode & ios_base::out ungleich 0 (null) ist, legt es den Ausgabepuffer fest, um Schreiben zu Anfang der Sequenz zu starten.

Beispiel

// basic_stringbuf_str.cpp
// compile with: /EHsc
#include <iostream>
#include <sstream>

using namespace std;

int main( ) 
{
   basic_string<char> i( "test" );
   stringstream ss;
   
   ss.rdbuf( )->str( i );
   cout << ss.str( ) << endl;

   ss << "z";
   cout << ss.str( ) << endl;
      
   ss.rdbuf( )->str( "be" );
   cout << ss.str( ) << endl;
}

Anforderungen

Header: <sstream>

Namespace: std

Siehe auch

Referenz

basic_stringbuf Class

Programmierung der iostream-Headerdatei

iostreams Konventionen