Operadores <stack>

operator!=

Testa se o objeto stack do lado esquerdo do operador não é igual ao objeto stack do lado direito.

bool operator!=(const stack <Type, Container>& left, const stack <Type, Container>& right,);

Parâmetros

esquerda
Um objeto do tipo stack.

direita
Um objeto do tipo stack.

Valor de retorno

true se as stacks ou stacks não forem iguais; false se stacks ou stacks forem iguais.

Comentários

A comparação entre os objetos stack baseia-se em uma comparação par de seus elementos. Duas stacks serão iguais se tiverem o mesmo número de elementos e seus respectivos elementos tiverem os mesmos valores. Caso contrário, são diferentes.

Exemplo

// stack_op_me.cpp
// compile with: /EHsc
#include <stack>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // Declares stacks with vector base containers
   stack <int, vector<int> > s1, s2, s3;

   // The following would have cause an error because stacks with
   // different base containers are not equality comparable
   // stack <int, list<int> >  s3;

   s1.push( 1 );
   s2.push( 2 );
   s3.push( 1 );

   if ( s1 != s2 )
      cout << "The stacks s1 and s2 are not equal." << endl;
   else
      cout << "The stacks s1 and s2 are equal." << endl;

   if ( s1 != s3 )
      cout << "The stacks s1 and s3 are not equal." << endl;
   else
      cout << "The stacks s1 and s3 are equal." << endl;
}

The stacks s1 and s2 are not equal.
The stacks s1 and s3 are equal.

operator<

Testa se o objeto stack do lado esquerdo do operador é menor que o objeto stack do lado direito.

bool operator<(const stack <Type, Container>& left, const stack <Type, Container>& right);

Parâmetros

esquerda
Um objeto do tipo stack.

direita
Um objeto do tipo stack.

Valor de retorno

true se a stack do lado esquerdo do operador for menor ou não for igual ao stack do lado direito do operador; caso contrário, false.

Comentários

A comparação entre os objetos stack baseia-se em uma comparação par de seus elementos. A relação menor que entre dois objetos stack é baseada em uma comparação do primeiro par de elementos desiguais.

Exemplo

// stack_op_lt.cpp
// compile with: /EHsc
#include <stack>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;

   // Declares stacks with list base container
   stack <int, list<int> > s1, s2, s3;

   s1.push( 2 );
   s1.push( 4 );
   s1.push( 6 );
   s1.push( 8 );
   s2.push( 5 );
   s2.push( 10 );
   s3.push( 2 );
   s3.push( 4 );
   s3.push( 6 );
   s3.push( 8 );

   if ( s1 >= s2 )
      cout << "The stack s1 is greater than or equal to "
           << "the stack s2." << endl;
   else
      cout << "The stack s1 is less than "
           << "the stack s2." << endl;

   if ( s1>= s3 )
      cout << "The stack s1 is greater than or equal to "
           << "the stack s3." << endl;
   else
      cout << "The stack s1 is less than "
           << "the stack s3." << endl;

   // to print out the stack s1 ( by unstacking the elements):
   stack <int>::size_type i_size_s1 = s1.size( );
   cout << "The stack s1 from the top down is: ( ";
   unsigned int i;
   for ( i = 1 ; i <= i_size_s1 ; i++ )
   {
      cout << s1.top( ) << " ";
      s1.pop( );
   }
   cout << ")." << endl;
}

The stack s1 is less than the stack s2.
The stack s1 is greater than or equal to the stack s3.
The stack s1 from the top down is: ( 8 6 4 2 ).

operator<=

Testa se o objeto stack do lado esquerdo do operador é menor ou igual ao objeto stack do lado direito.

bool operator<=(const stack <Type, Container>& left, const stack <Type, Container>& right);

Parâmetros

esquerda
Um objeto do tipo stack.

direita
Um objeto do tipo stack.

Valor de retorno

true se a stack do lado esquerdo do operador for menor ou igual ao stack do lado direito do operador; caso contrário, false.

Comentários

A comparação entre os objetos stack baseia-se em uma comparação par de seus elementos. A relação menor que ou igual a entre dois objetos stack é baseada em uma comparação entre o primeiro par de elementos desiguais.

Exemplo

// stack_op_le.cpp
// compile with: /EHsc
#include <stack>
#include <iostream>

int main( )
{
   using namespace std;

   // Declares stacks with default deque base container
   stack <int> s1, s2, s3;

   s1.push( 5 );
   s1.push( 10 );
   s2.push( 1 );
   s2.push( 2 );
   s3.push( 5 );
   s3.push( 10 );

   if ( s1 <= s2 )
      cout << "The stack s1 is less than or equal to "
           << "the stack s2." << endl;
   else
      cout << "The stack s1 is greater than "
           << "the stack s2." << endl;

   if ( s1 <= s3 )
      cout << "The stack s1 is less than or equal to "
           << "the stack s3." << endl;
   else
      cout << "The stack s1 is greater than "
           << "the stack s3." << endl;
}

The stack s1 is greater than the stack s2.
The stack s1 is less than or equal to the stack s3.

operator==

Testa se o objeto stack do lado esquerdo do operador é igual ao objeto stack do lado direito.

bool operator==(const stack <Type, Container>& left, const stack <Type, Container>& right);

Parâmetros

esquerda
Um objeto do tipo stack.

direita
Um objeto do tipo stack.

Valor de retorno

true se as stacks ou stacks forem iguais; false se stacks ou stacks não forem iguais.

Comentários

A comparação entre os objetos stack baseia-se em uma comparação par de seus elementos. Duas stacks serão iguais se tiverem o mesmo número de elementos e seus respectivos elementos tiverem os mesmos valores. Caso contrário, são diferentes.

Exemplo

// stack_op_eq.cpp
// compile with: /EHsc
#include <stack>
#include <vector>
#include <iostream>

int main( )
{
   using namespace std;

   // Declares stacks with vector base containers
   stack <int, vector<int> > s1, s2, s3;

   // The following would have cause an error because stacks with
   // different base containers are not equality comparable
   // stack <int, list<int> > s3;

   s1.push( 1 );
   s2.push( 2 );
   s3.push( 1 );

   if ( s1 == s2 )
      cout << "The stacks s1 and s2 are equal." << endl;
   else
      cout << "The stacks s1 and s2 are not equal." << endl;

   if ( s1 == s3 )
      cout << "The stacks s1 and s3 are equal." << endl;
   else
      cout << "The stacks s1 and s3 are not equal." << endl;
}

The stacks s1 and s2 are not equal.
The stacks s1 and s3 are equal.

operator>

Testa se o objeto stack do lado esquerdo do operador é maior que o objeto stack do lado direito.

bool operator>(const stack <Type, Container>& left, const stack <Type, Container>& right);

Parâmetros

esquerda
Um objeto do tipo stack.

direita
Um objeto do tipo stack.

Valor de retorno

true se a stack do lado esquerdo do operador for maior ou não for igual ao stack do lado direito do operador; caso contrário, false.

Comentários

A comparação entre os objetos stack baseia-se em uma comparação par de seus elementos. A relação maior que entre dois objetos stack é baseada em uma comparação entre o primeiro par de elementos desiguais.

Exemplo

// stack_op_gt.cpp
// compile with: /EHsc
#include <stack>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;

   // Declares stacks with list base container
   stack <int, list<int> > s1, s2, s3;

   s1.push( 1 );
   s1.push( 2 );
   s1.push( 3 );
   s2.push( 5 );
   s2.push( 10 );
   s3.push( 1 );
   s3.push( 2 );

   if ( s1 > s2 )
      cout << "The stack s1 is greater than "
           << "the stack s2." << endl;
   else
      cout << "The stack s1 is not greater than "
           << "the stack s2." << endl;

   if ( s1> s3 )
      cout << "The stack s1 is greater than "
           << "the stack s3." << endl;
   else
      cout << "The stack s1 is not greater than "
           << "the stack s3." << endl;
}

The stack s1 is not greater than the stack s2.
The stack s1 is greater than the stack s3.

operator>=

Testa se o objeto stack do lado esquerdo do operador é maior ou igual ao objeto stack do lado direito.

bool operator>=(const stack <Type, Container>& left, const stack <Type, Container>& right);

Parâmetros

esquerda
Um objeto do tipo stack.

direita
Um objeto do tipo stack.

Valor de retorno

true se a stack à esquerda do operador for estritamente menor que a stack à direita do operador; caso contrário, false.

Comentários

A comparação entre os objetos stack baseia-se em uma comparação par de seus elementos. A relação maior que ou igual entre dois objetos stack é baseada em uma comparação entre o primeiro par de elementos diferentes.

Exemplo

// stack_op_ge.cpp
// compile with: /EHsc
#include <stack>
#include <list>
#include <iostream>

int main( )
{
   using namespace std;

   // Declares stacks with list base container
   stack <int, list<int> > s1, s2, s3;

   s1.push( 1 );
   s1.push( 2 );
   s2.push( 5 );
   s2.push( 10 );
   s3.push( 1 );
   s3.push( 2 );

   if ( s1 >= s2 )
      cout << "The stack s1 is greater than or equal to "
           << "the stack s2." << endl;
   else
      cout << "The stack s1 is less than "
           << "the stack s2." << endl;

   if ( s1>= s3 )
      cout << "The stack s1 is greater than or equal to "
           << "the stack s3." << endl;
   else
      cout << "The stack s1 is less than "
           << "the stack s3." << endl;
}

The stack s1 is less than the stack s2.
The stack s1 is greater than or equal to the stack s3.