# std::ostream_iterator<T,CharT,Traits>::operator=

> C++ Atlas: `cppatlas.com/w/cpp/iterator/ostream_iterator/operator=` | Source: https://en.cppreference.com/w/cpp/iterator/ostream_iterator/operator= | Domain: Iterator

If out_stream is a pointer to the associated std::basic_ostream and delim is the delimiter specified at the construction of this object, then the effect is equivalent to

## Official Specification Summary (cppreference)

```cpp
ostream_iterator& operator=( const ostream_iterator& ); // (1)
ostream_iterator& operator=( const T& value ); // (2)
```

1) Copy assignment operator. Assigns the contents of `other`

2) Inserts `value` into the associated stream, then inserts the delimiter, if one was specified at construction time.

If `out_stream` is a pointer to the associated `std::basic_ostream` and `delim` is the delimiter specified at the construction of this object, then the effect is equivalent to

`*out_stream << value; if (delim != 0) *out_stream << delim; return *this;`

### Parameters

- `value` - the object to insert

### Return value

`*this`

### Notes

`T` can be any class with a user-defined `operator<<`.

Prior to C++20, the existence of the copy assignment operator relied on the deprecated implicit generation.

### Example

```cpp
#include <iostream>
#include <iterator>

int main()
{
    std::ostream_iterator<int> i1(std::cout, ", ");
    *i1++ = 1; // usual form, used by standard algorithms
    *++i1 = 2;
    i1 = 3; // neither * nor ++ are necessary
    std::ostream_iterator<double> i2(std::cout);
    i2 = 3.14;
    std::cout << '\n';
}
```

Output:

```text
1, 2, 3, 3.14
```

---
Attribution: content from https://en.cppreference.com/w/cpp/iterator/ostream_iterator/operator= (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.