std::operator<< (basic_ostream)

(1) single character

Inserts the character c into os.

(2) character sequence

Inserts the C-string s into os.
The terminating null character is not inserted into os.
The length of the c-string is determined beforehand by using the length member of the proper traits class.

(3) rvalue insertion

Allows inserting into rvalue basic_ostream objects, with the same effect as to lvalues: It effectively calls: os<<val.

Parameters

os

Output stream object where characters are inserted.

c

Character to insert.
If this is of type char, and this type is different from charT (the character type handled by os), the character inserted is os.widen(c).

s

Pointer to a null-terminated sequence of characters.
If these are of type char, and this type is different from charT (the character type handled by os), each character inserted is widened using os.widen.

val

ValueObject inserted.
T shall be a type supported as right-hand side argument either by this function or by os's member function operator<<.

Return Value

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

// example on insertion
#include <iostream>     // std::cout
int main () {
  const char str[] = "Example string";
  char ch = 'X';
  std::cout << str << '\n';     // Insert string
  std::cout.width(5);
  std::cout.fill('*');
  std::cout << ch << '\n';      // Insert single character
  return 0;
}

Example string
****X

Data races

Exception safety

See also

basic_ostream::operator<<

Insert formatted output (public member function)

basic_ostream::put

Put character (public member function)

operator>> (basic_istream)

Extract characters (public member function)