[#absl-rotate]
= xref:absl.adoc[absl]::rotate
:relfileprefix: ../
:mrdocs:

Rotates the elements in a range so that `n_first` becomes the new first.

== Synopsis

Declared in `<absl/algorithm/algorithm.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class ForwardIt>
[[deprecated]]
constexpr
ForwardIt
rotate(
    ForwardIt first,
    ForwardIt n_first,
    ForwardIt last);
----

[WARNING]
====
https://en.cppreference.com/cpp/language/attributes/deprecated[Deprecated^]. Use of this entity is allowed but discouraged.
====
== Description

Performs a left rotation on the range `[first, last)]` such that the element pointed to by `n_first` becomes the first element of the range.

== Return Value

An iterator to the new location of the element previously at `first`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *first*
| Iterator to the first element of the range.
| *n_first*
| Iterator to the element that should become the new first.
| *last*
| Iterator one past the last element of the range.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#