std:: next_permutation
|
Definido en el encabezado
<algorithm>
|
||
|
template
<
class
BidirIt
>
bool next_permutation ( BidirIt first, BidirIt last ) ; |
(1) | (constexpr desde C++20) |
|
template
<
class
BidirIt,
class
Compare
>
bool next_permutation ( BidirIt first, BidirIt last, Compare comp ) ; |
(2) | (constexpr desde C++20) |
Permuta el rango
[
first
,
last
)
a la siguiente
permutación
. Devuelve
true
si existe tal "siguiente permutación"; de lo contrario transforma el rango en la primera permutación lexicográfica (como si fuera mediante
std::sort
) y devuelve
false
.
Si
el tipo de
*
first
no es
Swappable
(hasta C++11)
BidirIt
no es
ValueSwappable
(desde C++11)
, el comportamiento es indefinido.
Contenidos |
Parámetros
| first, last | - | el par de iteradores que define el rango de elementos a permutar |
| comp | - |
objeto función de comparación (es decir, un objeto que satisface los requisitos de
Compare
) que devuelve
true
si el primer argumento es
menor
que el segundo.
La firma de la función de comparación debe ser equivalente a la siguiente: bool cmp ( const Type1 & a, const Type2 & b ) ;
Aunque la firma no necesita tener
const
&
, la función no debe modificar los objetos pasados a ella y debe poder aceptar todos los valores de tipo (posiblemente const)
|
| Requisitos de tipo | ||
-
BidirIt
debe cumplir con los requisitos de
LegacyBidirectionalIterator
.
|
||
Valor de retorno
true si la nueva permutación es lexicográficamente mayor que la anterior. false si se alcanzó la última permutación y el rango se reinició a la primera permutación.
Complejidad
Dado N como std:: distance ( first, last ) :
| N |
| 2 |
Excepciones
Cualquier excepción lanzada desde operaciones de iteradores o el intercambio de elementos.
Implementación posible
template<class BidirIt> bool next_permutation(BidirIt first, BidirIt last) { auto r_first = std::make_reverse_iterator(last); auto r_last = std::make_reverse_iterator(first); auto left = std::is_sorted_until(r_first, r_last); if (left != r_last) { auto right = std::upper_bound(r_first, left, *left); std::iter_swap(left, right); } std::reverse(left.base(), last); return left != r_last; } |
Notas
Promediado sobre toda la secuencia de permutaciones, las implementaciones típicas utilizan aproximadamente 3 comparaciones y 1.5 intercambios por llamada.
Las implementaciones (por ejemplo,
MSVC STL
) pueden habilitar la vectorización cuando el tipo de iterador satisface
LegacyContiguousIterator
y el intercambio de su tipo de valor no llama ni a funciones miembro especiales no triviales ni a
ADL
-encontrado
swap
.
Ejemplo
El siguiente código imprime las tres permutaciones de la cadena "aba" .
#include <algorithm> #include <iostream> #include <string> int main() { std::string s = "aba"; do { std::cout << s << '\n'; } while (std::next_permutation(s.begin(), s.end())); std::cout << s << '\n'; }
Salida:
aba baa aab
Véase también
|
(C++11)
|
determina si una secuencia es una permutación de otra secuencia
(plantilla de función) |
|
genera la siguiente permutación lexicográfica menor de un rango de elementos
(plantilla de función) |
|
|
(C++20)
|
genera la siguiente permutación lexicográfica mayor de un rango de elementos
(objeto función de algoritmo) |