stable_sort

Organiza elementos em um intervalo especificado em uma ordem nondescending ou de acordo com um critério classificação especificado por um predicado binário e ordenação preserva relativo dos elementos equivalentes.

template<class BidirectionalIterator>
   void stable_sort(
      BidirectionalIterator _First, 
      BidirectionalIterator _Last
   );
template<class BidirectionalIterator, class BinaryPredicate>
   void stable_sort(
      BidirectionalIterator _First, 
      BidirectionalIterator _Last,
      BinaryPredicate _Comp
   );

Parâmetros

• _First
  Um iterador bidirecional que trata a posição do primeiro elemento no intervalo ser classificado.

• _Last
  Um iterador bidirecional que trata a posição uma após o elemento final no intervalo ser classificado.

• _Comp
  Objeto definido pelo usuário da função de predicado que define o critério de comparação a ser satisfeito os elementos em sucessivos pedido.Um predicado binário leva dois argumentos e retorna true quando satisfeito e false quando não satisfeito.

Comentários

o intervalo referenciado deve ser válido; todos os ponteiros devem ser dereferenceable e na seqüência a posição da última é alcançável de primeira por incrementação.

Os elementos são equivalentes, mas não necessariamente são iguais, se nenhum for menor do que o outro.O algoritmo de sort é estável e garante que pede relativo dos elementos equivalentes será preservada.

A complexidade de tempo de execução de stable_sort depende da quantidade de memória disponível, mas os melhores casos (dado memória suficiente) é O(N log N) e o pior caso é O( N ( log N )2 ), onde N = _Last – First. Geralmente, o algoritmo de sort é significativamente mais rápido do que stable_sort.

Exemplo

// alg_stable_sort.cpp
// compile with: /EHsc
#include <vector>
#include <algorithm>
#include <functional>      // For greater<int>( )
#include <iostream>

// Return whether first element is greater than the second
bool UDgreater (int elem1, int elem2 )
{
   return elem1 > elem2;
}

int main( )
{
   using namespace std;
   vector <int> v1;
   vector <int>::iterator Iter1;

   int i;
   for ( i = 0 ; i <= 5 ; i++ )
   {
      v1.push_back( 2 * i );
   }

   for ( i = 0 ; i <= 5 ; i++ )
   {
      v1.push_back( 2 * i  );
   }

   cout << "Original vector v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;

   stable_sort(v1.begin( ), v1.end( ) );
   cout << "Sorted vector v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;

   // To sort in descending order, specify binary predicate
   stable_sort(v1.begin( ), v1.end( ), greater<int>( ) );
   cout << "Resorted (greater) vector v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;

   // A user-defined (UD) binary predicate can also be used
   stable_sort(v1.begin( ), v1.end( ), UDgreater );
   cout << "Resorted (UDgreater) vector v1 = ( " ;
   for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ )
      cout << *Iter1 << " ";
   cout << ")" << endl;
}

Requisitos

Cabeçalho: <algorithm>

namespace: STD

Consulte também

Referência

Standard Template Library