xref: /freebsd/contrib/llvm-project/libcxx/include/experimental/iterator (revision 734e82fe33aa764367791a7d603b383996c6b40b)
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 <__assert> // all public C++ headers provide the assertion handler
56#include <__memory/addressof.h>
57#include <__type_traits/decay.h>
58#include <__utility/forward.h>
59#include <__utility/move.h>
60#include <experimental/__config>
61#include <iosfwd> // char_traits
62#include <iterator>
63
64#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
65#  pragma GCC system_header
66#endif
67
68#if _LIBCPP_STD_VER > 11
69
70_LIBCPP_BEGIN_NAMESPACE_LFTS
71
72template <class _Delim, class _CharT = char, class _Traits = char_traits<_CharT>>
73class ostream_joiner {
74public:
75
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    ostream_joiner(ostream_type& __os, _Delim&& __d)
86        : __output_iter_(_VSTD::addressof(__os)), __delim_(_VSTD::move(__d)), __first_(true) {}
87
88    ostream_joiner(ostream_type& __os, const _Delim& __d)
89        : __output_iter_(_VSTD::addressof(__os)), __delim_(__d), __first_(true) {}
90
91
92    template<typename _Tp>
93    ostream_joiner& operator=(const _Tp& __v)
94    {
95        if (!__first_)
96            *__output_iter_ << __delim_;
97        __first_ = false;
98        *__output_iter_ << __v;
99        return *this;
100    }
101
102    ostream_joiner& operator*()     _NOEXCEPT { return *this; }
103    ostream_joiner& operator++()    _NOEXCEPT { return *this; }
104    ostream_joiner& operator++(int) _NOEXCEPT { return *this; }
105
106private:
107    ostream_type*   __output_iter_;
108    _Delim          __delim_;
109    bool            __first_;
110};
111
112
113template <class _CharT, class _Traits, class _Delim>
114_LIBCPP_HIDE_FROM_ABI ostream_joiner<typename decay<_Delim>::type, _CharT, _Traits>
115make_ostream_joiner(basic_ostream<_CharT, _Traits>& __os, _Delim && __d)
116{ return ostream_joiner<typename decay<_Delim>::type, _CharT, _Traits>(__os, _VSTD::forward<_Delim>(__d)); }
117
118_LIBCPP_END_NAMESPACE_LFTS
119
120#endif // _LIBCPP_STD_VER > 11
121
122#if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
123#  include <type_traits>
124#endif
125
126#endif // _LIBCPP_EXPERIMENTAL_ITERATOR
127