Home » C++ algorithm equal() function

C++ algorithm equal() function

by Online Tutorials Library

C++ Algorithm Function equal()

C++ Algorithm equal()function compares the elements in both the containers and returns a true value if all the elements in both the containers are found to be matching. The first range is from [first1,last1) and the second starts from first2.

Syntax

Parameter

first1: It is an input iterator to the first element of the [first1, last1).

last1: It is an input iterator to the last element of the [first1, last1).

first2: It is an input iterator to the first element of the [first2, last2).

pred: It is a binary function that accepts two elements as arguments and performs the task designed by the function.

Return value

The function returns the value true if all the elements in both the containers match, otherwise it returns false.

Example 1

Output:

Both the containers have matching elements.  Both the containers do not have equal elements.  

Example 2

Output:

The vector consists of: 10, 20,30,40,50  Both the containers have equal elements.  

Complexity

The function has linear complexity from the first1 element to the last1 element.

Data races

Objects in both ranges are accessed.

Exceptions

The function throws an exception if any of the argument throws one.

You may also like