[Support] Add raw_ostream_iterator: ostream_iterator for raw_ostream
authorNicolas Guillemot <nguillemot@apple.com>
Thu, 4 Mar 2021 17:58:16 +0000 (09:58 -0800)
committerNicolas Guillemot <nguillemot@apple.com>
Thu, 4 Mar 2021 19:12:48 +0000 (11:12 -0800)
commit7479a2e00bc41f399942e5106fbdf9b4b0c11506
tree662139a7f6851cb433c851f88ad32bff86ebda68
parentd268febc5610021af41b9dde5762404d09509f30
[Support] Add raw_ostream_iterator: ostream_iterator for raw_ostream

Adds a class `raw_ostream_iterator` that behaves like
std::ostream_iterator, but can be used with raw_ostream.
This is useful for using raw_ostream with std algorithms.

For example, it can be used to output std containers as follows:

```
std::vector<int> V = { 1, 2, 3 };
std::copy(V.begin(), V.end(), raw_ostream_iterator<int>(outs(), ", "));
// Output: "1, 2, 3, "
```

The API tries to follow std::ostream_iterator as closely as is
practically possible.

Reviewed By: dblaikie, mkitzan

Differential Revision: https://reviews.llvm.org/D78795
llvm/include/llvm/Support/raw_ostream.h
llvm/unittests/Support/raw_ostream_test.cpp