std::ranges::shift_left, std::ranges::shift_right

来自cppreference.com

2025年2月13日 (四) 00:37YexuanXiao（讨论 | 贡献）的版本

(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

在标头 `<algorithm>` 定义
调用签名
template< std::permutable I, std::sentinel_for<I> S > constexpr ranges::subrange<I> shift_left( I first, S last, std::iter_difference_t<I> n );	(1)	(C++23 起)
template< ranges::forward_range R > requires std::permutable<ranges::iterator_t<R>> constexpr ranges::borrowed_subrange_t<R> shift_left( R&& r, ranges::range_difference_t<R> n );	(2)	(C++23 起)
template< std::permutable I, std::sentinel_for<I> S > constexpr ranges::subrange<I> shift_right( I first, S last, std::iter_difference_t<I> n );	(3)	(C++23 起)
template< ranges::forward_range R > requires std::permutable<ranges::iterator_t<R>> constexpr ranges::borrowed_subrange_t<R> shift_right( R&& r, ranges::range_difference_t<R> n );	(4)	(C++23 起)

将范围 [first, last) 或 r 中的各元素迁移 n 个位置。若 [first, last) 不是有效范围则其行为未定义。

1) 向范围开端迁移元素：

若 n == 0 || n >= last - first 则无效果。
若 n < 0 则行为未定义。
否则，对于每个 [0, last - first - n) 中的整数 i，移动原处于位置 first + n + i 的元素到位置 first + i。以 i 从 0 开始递增的顺序进行移动。

3) 向范围结尾迁移元素：

若 n == 0 || n >= last - first 则无效果。
若 n < 0 则行为未定义。
否则，对于每个 [0, last - first - n) 中的整数 i，移动原处于位置 first + i 的元素到位置 first + n + i。若 I 满足 bidirectional_iterator，则以 i 从 last - first - n - 1 开始递减的顺序进行移动。

2,4) 分别同 (1) 与 (3)，但以 r 为范围，如同以 ranges::begin(r) 为 first 并以 ranges::end(r) 为 last。

在原范围但不在新范围中的元素被置于合法但未指定的状态。

此页面上描述的函数式实体是算法函数对象（非正式地称为 niebloid），即：

目录