cplusplus.com cplusplus.com
cplusplus.com   C++ : Reference : IOstream Library : ofstream : rdbuf
- -
C++
Information
Documentation
Reference
Articles
Sourcecode
Forum
Reference
C Library
IOstream Library
Strings library
STL Containers
STL Algorithms
IOstream Library
manipulators
classes:
· filebuf
· fstream
· ifstream
· ios
· iostream
· ios_base
· istream
· istringstream
· ofstream
· ostream
· ostringstream
· streambuf
· stringbuf
· stringstream
objects:
· cerr
· cin
· clog
· cout
types:
· fpos
· streamoff
· streampos
· streamsize
ofstream
· ofstream::ofstream
member functions:
· ofstream::close
· ofstream::is_open
· ofstream::open
· ofstream::rdbuf

-

ofstream::rdbuf public member function
filebuf* rdbuf ( ) const;

Get the associated filebuf object

Returns a pointer to the filebuf object associated with the stream.

Parameters

none

Return Value

A pointer to the filebuf object associated with the stream.
Notice that for any successfully constructed ofstream object this pointer is never a null pointer, even if no files have been opened or if the stream is unbuffered.

Example

// copy a file using associated buffer's members
#include <fstream>
using namespace std;

int main () {
  char ch;
  ifstream infile;
  ofstream outfile;
  filebuf *inbuf, *outbuf;

  infile.open ("test.txt");
  outfile.open ("copy.txt");

  inbuf=infile.rdbuf();
  outbuf=outfile.rdbuf();

  ch = inbuf->sgetc();
  while ( ch != EOF)
  {
    outbuf->sputc (ch);
    ch= inbuf->snextc();
  }

  outfile.close();
  infile.close();

  return 0;
}

Basic template member declaration

( basic_fstream<charT,traits,Allocator> )
basic_filebuf<charT,traits,Allocator> * rdbuf () const;

See also

ios::rdbuf Get/set the associated stream buffer (public member function)
filebuf File stream buffer (class)

© The C++ Resources Network, 2000-2007 - All rights reserved
Spotted an error? - contact us