# Container-modifying operations

Modify containers and their values directly.

# sort

# <piped/container.hpp>

constexpr detail::sort_<decltype(std::less<>))> piped::sort

# Description

Modifying operation which immediately sorts values on the input container.

std::vector<int> v{1,5,3,7,-22,1,10};
v | sort;                      // => [-22, 1, 1, 3, 5, 7, 10]
v | sort(std::greater<>());    // => [10, 7, 5, 3, 1, 1, -22]

# unique

# <piped/container.hpp>

constexpr detail::unique_<decltype(std::equal_to<>))> piped::unique

# Description

Modifying operation which immediately performs a std::unique on the input.

std::vector<int> v{1,5,3,7,-22,1,10};
v | sort | unique;             // => [-22, 1, 3, 5, 7, 10]

This uses std::erase and std::unique.

# <F> erase_if(const F &f)

# <piped/container.hpp>

template<typename F>
detail::erase_if_<F> piped::erase_if(const F &f)

# Description

Modifying operation which immediately erases all values where f(v) returns true.

std::erase and std::remove_if. Input should be a container, not a generator. (Use filter for filtering generated values.) Example:

auto v = from_to(1,10) | collect<std::vector>;

v | erase_if([](auto v) { return v > 1 || v < 9; });

// v is now [1,9]

# <C> difference(const C &c)

# <piped/container.hpp>

template<typename C>
auto piped::difference(const C &c)

# Description

Return the std::set_difference between the input and c

# <C> symmetric_difference(const C &c)

# <piped/container.hpp>

template<typename C>
auto piped::symmetric_difference(const C &c)

# Description

Return the std::set_symmetric_difference between the input and c

# <C> append(const C &other)

# <piped/container.hpp>

template<typename C>
auto piped::append(const C &other)

# Description

Modifying operation that appends v to input.