ostream& put ( char c );

Put character

Writes the character c to the output buffer at the current put position and increases the put pointer to point to the next character.

Parameters

c

Character to write.

Return Value

In case of error, the badbit flag is set (which can be checked with member bad). Also, depending on the values set through member exceptions, this may cause an exception of type ios_base::failure to be thrown.

Example

// typewriter
#include <iostream>
#include <fstream>
using namespace std;

int main () {

  char ch;
  ofstream outfile ("test.txt");

  do {
    ch=cin.get();
    outfile.put (ch);
  } while (ch!='.');

  return 0;
}

This example writes to a file everything the user types until a dot (.) is typed.

Basic template member declaration

typedef charT char_type;
basic_ostream& put (char_type ch);

See also