xref: /freebsd/contrib/llvm-project/libcxx/include/experimental/iterator (revision 1db9f3b21e39176dd5b67cf8ac378633b172463e)
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 <iterator>
62
63#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
64#  pragma GCC system_header
65#endif
66
67#if _LIBCPP_STD_VER >= 14
68
69_LIBCPP_BEGIN_NAMESPACE_LFTS
70
71template <class _Delim, class _CharT = char, class _Traits = char_traits<_CharT>>
72class ostream_joiner {
73public:
74  typedef _CharT char_type;
75  typedef _Traits traits_type;
76  typedef basic_ostream<char_type, traits_type> ostream_type;
77  typedef output_iterator_tag iterator_category;
78  typedef void value_type;
79  typedef void difference_type;
80  typedef void pointer;
81  typedef void reference;
82
83  _LIBCPP_HIDE_FROM_ABI ostream_joiner(ostream_type& __os, _Delim&& __d)
84      : __output_iter_(std::addressof(__os)), __delim_(std::move(__d)), __first_(true) {}
85
86  _LIBCPP_HIDE_FROM_ABI ostream_joiner(ostream_type& __os, const _Delim& __d)
87      : __output_iter_(std::addressof(__os)), __delim_(__d), __first_(true) {}
88
89  template <typename _Tp>
90  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator=(const _Tp& __v) {
91    if (!__first_)
92      *__output_iter_ << __delim_;
93    __first_ = false;
94    *__output_iter_ << __v;
95    return *this;
96  }
97
98  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator*() _NOEXCEPT { return *this; }
99  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator++() _NOEXCEPT { return *this; }
100  _LIBCPP_HIDE_FROM_ABI ostream_joiner& operator++(int) _NOEXCEPT { return *this; }
101
102private:
103  ostream_type* __output_iter_;
104  _Delim __delim_;
105  bool __first_;
106};
107
108template <class _CharT, class _Traits, class _Delim>
109_LIBCPP_HIDE_FROM_ABI ostream_joiner<__decay_t<_Delim>, _CharT, _Traits>
110make_ostream_joiner(basic_ostream<_CharT, _Traits>& __os, _Delim&& __d) {
111  return ostream_joiner<__decay_t<_Delim>, _CharT, _Traits>(__os, std::forward<_Delim>(__d));
112}
113
114_LIBCPP_END_NAMESPACE_LFTS
115
116#endif // _LIBCPP_STD_VER >= 14
117
118#if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
119#  include <iosfwd>
120#  include <type_traits>
121#endif
122
123#endif // _LIBCPP_EXPERIMENTAL_ITERATOR
124