C++ Ostream::put() function

---

---

The C++ std::ostream::put() function is used to write a single character to the output stream. It is useful for low level character output operations. It takes a single argument of type char, representing the character to be written, and returns a reference to the output stream.

Syntax

Following is the syntax for std::ostream::put() function.

ostream& put (char c);

Parameters

• c − It indicates the character to write.

Return Value

It returns the ostream object (*this).

Exceptions

If an exception is thrown, the object is in a valid state.

Data races

Modifies the stream object. Concurrent access to the same stream object may cause data races, except for the standard stream objects (cout, cerr, clog) when these are synchronized with stdio.

Example

In the following example, we are going to consider the basic usage of the put() function.

#include <iostream>
int main()
{
    std::cout.put('A');
    return 0;
}

Output

Output of the above code is as follows −

A

Example

Consider the following example, where we aare going to to write the alphabet letters to the output with a space between each character using the put() function.

#include <iostream>
int main()
{
    for (char x = 'a'; x <= 'z'; ++x) {
        std::cout.put(x);
        std::cout.put(' ');
    }
    std::cout.put('\n');
    return 0;
}

Output

Following is the output of the above code −

a b c d e f g h i j k l m n o p q r s t u v w x y z 

Example

Let' look at the following example, where we are going to use the put() function in a chain to output multiple characters.

#include <iostream>
int main()
{
    std::cout.put('T').put('U').put('T').put('O').put('R').put('I').put('A').put('L').put('S').put('P').put('O').put('I').put('N').put('T').put('\n');
    return 0;
}

Output

If we run the above code it will generate the following output −

TUTORIALSPOINT