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

Rotates the elements in a range so that `n&lowbar;first` becomes the new first&period;

== Synopsis

Declared in `&lt;absl&sol;algorithm&sol;algorithm&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;class ForwardIt&gt;
&lsqb;&lsqb;deprecated&rsqb;&rsqb;
constexpr
ForwardIt
rotate(
    ForwardIt first,
    ForwardIt n&lowbar;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 `&lsqb;first, last)&rsqb;` such that the element pointed to by `n&lowbar;first` becomes the first element of the range&period;

== Return Value

An iterator to the new location of the element previously at `first`&period;

== Parameters

[cols="1,4"]
|===
| Name| Description
| *first*
| Iterator to the first element of the range&period;
| *n&lowbar;first*
| Iterator to the element that should become the new first&period;
| *last*
| Iterator one past the last element of the range&period;
|===


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