cppdraft_translate/cppdraft/specialized/destroy.md

[specialized.destroy]

26 Algorithms library [algorithms]

26.11 Specialized algorithms [specialized.algorithms]

26.11.9 destroy [specialized.destroy]

🔗

template<class T> constexpr void destroy_at(T* location); namespace ranges { template<[destructible](concept.destructible#concept:destructible "18.4.10 Concept destructible [concept.destructible]") T> constexpr void destroy_at(T* location) noexcept; }

1

#

Effects:

• (1.1)

  If T is an array type, equivalent to destroy(begin(*location), end(*location)).

• (1.2)

  Otherwise, equivalent to location->~T().

🔗

template<class NoThrowForwardIterator> constexpr void destroy(NoThrowForwardIterator first, NoThrowForwardIterator last);

2

#

Effects: Equivalent to:for (; first != last; ++first) destroy_at(addressof(*first));

🔗

namespace ranges { template<[nothrow-input-iterator](special.mem.concepts#concept:nothrow-input-iterator "26.11.2 Special memory concepts [special.mem.concepts]") I, [nothrow-sentinel-for](special.mem.concepts#concept:nothrow-sentinel-for "26.11.2 Special memory concepts [special.mem.concepts]")<I> S> requires [destructible](concept.destructible#concept:destructible "18.4.10 Concept destructible [concept.destructible]")<iter_value_t<I>> constexpr I destroy(I first, S last) noexcept; template<[nothrow-input-range](special.mem.concepts#concept:nothrow-input-range "26.11.2 Special memory concepts [special.mem.concepts]") R> requires [destructible](concept.destructible#concept:destructible "18.4.10 Concept destructible [concept.destructible]")<range_value_t<R>> constexpr borrowed_iterator_t<R> destroy(R&& r) noexcept; }

3

#

Effects: Equivalent to:for (; first != last; ++first) destroy_at(addressof(*first));return first;

🔗

template<class NoThrowForwardIterator, class Size> constexpr NoThrowForwardIterator destroy_n(NoThrowForwardIterator first, Size n);

4

#

Effects: Equivalent to:for (; n > 0; (void)++first, --n) destroy_at(addressof(*first));return first;

🔗

namespace ranges { template<[nothrow-input-iterator](special.mem.concepts#concept:nothrow-input-iterator "26.11.2 Special memory concepts [special.mem.concepts]") I> requires [destructible](concept.destructible#concept:destructible "18.4.10 Concept destructible [concept.destructible]")<iter_value_t<I>> constexpr I destroy_n(I first, iter_difference_t<I> n) noexcept; }

5

#

Effects: Equivalent to:return destroy(counted_iterator(std::move(first), n), default_sentinel).base();