# C++ named requirements: LessThanComparable

> C++ Atlas: `cppatlas.com/w/cpp/named_req/LessThanComparable` | Source: https://en.cppreference.com/w/cpp/named_req/LessThanComparable | Domain: Named Requirements | Standards: C++11, C++20

The type must work with < operator and the result should have standard semantics.

## Official Specification Summary (cppreference)

The type must work with `<` operator and the result should have standard semantics.

### Requirements

The type `T` satisfies *LessThanComparable* if given expressions `a`, `b` and `c` of type `T` or `const T` (since C++11), the following expression is valid and has its specified effects:

| Expression | Type | Effects |
| --- | --- | --- |
| `a < b` | meets *BooleanTestable* (until C++20) | Establishes strict weak ordering relation with the following properties: - For all `a`, `!(a < a)` yields `true`. - If `a < b`, then `!(b < a)`. - If `a < b` and `b < c`, then `a < c`. - Defining `equiv(a, b)` as `!(a < b) && !(b < a)`, if `equiv(a, b)` and `equiv(b, c)`, then `equiv(a, c)`. |
| `a < b` | models `boolean-testable` (since C++20) | Establishes strict weak ordering relation with the following properties: - For all `a`, `!(a < a)` yields `true`. - If `a < b`, then `!(b < a)`. - If `a < b` and `b < c`, then `a < c`. - Defining `equiv(a, b)` as `!(a < b) && !(b < a)`, if `equiv(a, b)` and `equiv(b, c)`, then `equiv(a, c)`. |

### Notes

To satisfy this requirement, types that do not have built-in comparison operators have to provide a user-defined `operator<`.

For the types that are both *EqualityComparable* and *LessThanComparable*, the C++ standard library makes a distinction between

- *Equality*, which is the value of the expression `a == b` and
- *Equivalence*, which is the value of the expression `!(a < b) && !(b < a)`.

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

| DR | Applied to | Behavior as published | Correct behavior |
| --- | --- | --- | --- |
| LWG 2114 (P2167R3) | C++98 | convertibility to `bool` was too weak to reflect the expectation of implementations | requirements strengthened |

### See also

- [Compare](https://en.cppreference.com/w/cpp/named_req/Compare): a *BinaryPredicate* that establishes an ordering relation (named requirement)
- [`strict_weak_order`](https://en.cppreference.com/w/cpp/concepts/strict_weak_order) (C++20): specifies that a `relation` imposes a strict weak ordering (concept)

---
Attribution: content from https://en.cppreference.com/w/cpp/named_req/LessThanComparable (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.