<stack>, opérateurs

!=, opérateur

Vérifie si l’objet stack situé à gauche de l’opérateur n’est pas égal à l’objet stack situé à droite.

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

Paramètres

left
Objet de type stack.

right
Objet de type stack.

Valeur de retour

true si les piles ou les piles ne sont pas égales ; false si les piles ou les piles sont égales.

Notes

La comparaison entre les objets stack est basée sur une comparaison par paire de leurs éléments. Deux objets stack sont égaux s’ils ont le même nombre d’éléments et si leurs éléments respectifs ont les mêmes valeurs. Sinon, elles sont inégales.

Exemple

// 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<

Teste si l'objet de pile situé à gauche de l'opérateur est inférieur à l'objet de pile situé à droite.

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

Paramètres

left
Objet de type stack.

right
Objet de type stack.

Valeur de retour

true si la pile sur le côté gauche de l’opérateur est inférieure et non égale à la pile sur le côté droit de l’opérateur ; sinon false.

Notes

La comparaison entre les objets stack est basée sur une comparaison par paire de leurs éléments. La relation d’infériorité entre deux objets stack est basée sur une comparaison de la première paire d’éléments inégaux.

Exemple

// 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<=

Teste si l'objet de pile situé à gauche de l'opérateur est inférieur ou égal à l'objet de pile situé à droite.

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

Paramètres

left
Objet de type stack.

right
Objet de type stack.

Valeur de retour

true si la pile sur le côté gauche de l’opérateur est inférieure ou égale à la pile sur le côté droit de l’opérateur ; sinon false.

Notes

La comparaison entre les objets stack est basée sur une comparaison par paire de leurs éléments. La relation d’infériorité ou d’égalité entre deux objets stack est basée sur une comparaison de la première paire d’éléments inégaux.

Exemple

// 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==

Vérifie si l’objet stack situé à gauche de l’opérateur est égal à l’objet stack situé à droite.

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

Paramètres

left
Objet de type stack.

right
Objet de type stack.

Valeur de retour

true si les piles ou les piles sont égales ; false si les piles ou les piles ne sont pas égales.

Notes

La comparaison entre les objets stack est basée sur une comparaison par paire de leurs éléments. Deux objets stack sont égaux s’ils ont le même nombre d’éléments et si leurs éléments respectifs ont les mêmes valeurs. Sinon, elles sont inégales.

Exemple

// 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>

Teste si l'objet de pile situé à gauche de l'opérateur est supérieur à l'objet de pile situé à droite.

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

Paramètres

left
Objet de type stack.

right
Objet de type stack.

Valeur de retour

true si la pile sur le côté gauche de l’opérateur est supérieure et non égale à la pile sur le côté droit de l’opérateur ; sinon false.

Notes

La comparaison entre les objets stack est basée sur une comparaison par paire de leurs éléments. La relation de supériorité entre deux objets stack est basée sur une comparaison de la première paire d’éléments inégaux.

Exemple

// 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>=

Teste si l'objet de pile situé à gauche de l'opérateur est supérieur ou égal à l'objet de pile situé à droite.

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

Paramètres

left
Objet de type stack.

right
Objet de type stack.

Valeur de retour

true si la pile sur le côté gauche de l’opérateur est strictement inférieure à la pile du côté droit de l’opérateur ; sinon false.

Notes

La comparaison entre les objets stack est basée sur une comparaison par paire de leurs éléments. La relation de supériorité ou d’égalité entre deux objets stack est basée sur une comparaison de la première paire d’éléments inégaux.

Exemple

// 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.