xref: /freebsd/contrib/llvm-project/libcxx/include/experimental/iterator (revision 0fca6ea1d4eea4c934cfff25ac9ee8ad6fe95583)
1// -*- C++ -*-
2//===----------------------------------------------------------------------===//
3//
4// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_EXPERIMENTAL_ITERATOR
11#define _LIBCPP_EXPERIMENTAL_ITERATOR
12
13/*
14namespace std {
15  namespace experimental {
16    inline namespace fundamentals_v2 {
17
18    template <class DelimT, class charT = char, class traits = char_traits<charT>>
19        class ostream_joiner {
20        public:
21         typedef charT                        char_type;
22         typedef traits                       traits_type;
23         typedef basic_ostream<charT, traits> ostream_type;
24         typedef output_iterator_tag          iterator_category;
25         typedef void                         value_type;
26         typedef void                         difference_type;
27         typedef void                         pointer;
28         typedef void                         reference;
29
30         ostream_joiner(ostream_type& s, const DelimT& delimiter);
31         ostream_joiner(ostream_type& s, DelimT&& delimiter);
32
33         template<typename T>
34         ostream_joiner& operator=(const T& value);
35
36         ostream_joiner& operator*() noexcept;
37         ostream_joiner& operator++() noexcept;
38         ostream_joiner& operator++(int) noexcept;
39   private:
40      ostream_type* out_stream;   // exposition only
41      DelimT delim;               // exposition only
42      bool first_element;         // exposition only
43   };
44
45  template <class charT, class traits, class DelimT>
46    ostream_joiner<decay_t<DelimT>, charT, traits>
47    make_ostream_joiner(basic_ostream<charT, traits>& os, DelimT&& delimiter);
48
49    } // inline namespace fundamentals_v2
50  } // namespace experimental
51} // namespace std
52
53*/
54
55#include <__memory/addressof.h>
56#include <__type_traits/decay.h>
57#include <__utility/forward.h>
58#include <__utility/move.h>
59#include <experimental/__config>
60#include <iterator>
61
62#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
63#  pragma GCC system_header
64#endif
65
66_LIBCPP_PUSH_MACROS
67#include <__undef_macros>
68
69#if _LIBCPP_STD_VER >= 14
70
71_LIBCPP_BEGIN_NAMESPACE_LFTS
72
73template <class _Delim, class _CharT = char, class _Traits = char_traits<_CharT>>
74class ostream_joiner {
75public:
76  typedef _CharT char_type;
77  typedef _Traits traits_type;
78  typedef basic_ostream<char_type, traits_type> ostream_type;
79  typedef output_iterator_tag iterator_category;
80  typedef void value_type;
81  typedef void difference_type;
82  typedef void pointer;
83  typedef void reference;
84
85  _LIBCPP_HIDE_FROM_ABI ostream_joiner(ostream_type& __os, _Delim&& __d)
86      : __output_iter_(std::addressof(__os)), __delim_(std::move(__d)), __first_(true) {}
87
88  _LIBCPP_HIDE_FROM_ABI ostream_joiner(ostream_type& __os, const _Delim& __d)
89      : __output_iter_(std::addressof(__os)), __delim_(__d), __first_(true) {}
90
91  template <typename _Tp>
92  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator=(const _Tp& __v) {
93    if (!__first_)
94      *__output_iter_ << __delim_;
95    __first_ = false;
96    *__output_iter_ << __v;
97    return *this;
98  }
99
100  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator*() _NOEXCEPT { return *this; }
101  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator++() _NOEXCEPT { return *this; }
102  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator++(int) _NOEXCEPT { return *this; }
103
104private:
105  ostream_type* __output_iter_;
106  _Delim __delim_;
107  bool __first_;
108};
109
110template <class _CharT, class _Traits, class _Delim>
111_LIBCPP_HIDE_FROM_ABI ostream_joiner<__decay_t<_Delim>, _CharT, _Traits>
112make_ostream_joiner(basic_ostream<_CharT, _Traits>& __os, _Delim&& __d) {
113  return ostream_joiner<__decay_t<_Delim>, _CharT, _Traits>(__os, std::forward<_Delim>(__d));
114}
115
116_LIBCPP_END_NAMESPACE_LFTS
117
118#endif // _LIBCPP_STD_VER >= 14
119
120_LIBCPP_POP_MACROS
121
122#if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
123#  include <iosfwd>
124#  include <type_traits>
125#endif
126
127#endif // _LIBCPP_EXPERIMENTAL_ITERATOR
128