[#BloombergLP-bslalg-RangeCompare-equal-09]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/RangeCompare.adoc[RangeCompare]::equal
:relfileprefix: ../../../
:mrdocs:

Return whether two ranges of equal length compare element‐wise equal.

== Synopsis

Declared in `<bslalg_rangecompare.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class INPUT_ITER>
static
bool
equal(
    INPUT_ITER start1,
    INPUT_ITER end1,
    INPUT_ITER start2);
----

== Description

Compare each element in the range beginning at the specified `start1` position and ending immediately before the specified `end1` position to the corresponding element in the range of the same length beginning at the specified `start2` position, as if using `operator==` element‐by‐element. Return `true` if every pair of corresponding elements compares equal, and `false` otherwise. Note that this implementation uses `operator==` to perform the comparisons, or bit‐wise comparison if the value type has the bit‐wise equality‐comparable trait.

== Return Value

`true` if every corresponding pair of elements compares equal, and `false` otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *start1*
| beginning of the first range
| *end1*
| end of the first range (one past the last element)
| *start2*
| beginning of the second range
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#