This page is a snapshot from the LWG issues list, see the Library Active Issues List for more information and the meaning of WP status.

### 2997. LWG 491 and the specification of `{forward_,}list::unique`

Section: 22.3.10.5 [list.ops], 99 [forwardlist.ops] Status: WP Submitter: Tim Song Opened: 2017-07-07 Last modified: 2021-06-07

Priority: 3

View all other issues in [list.ops].

View all issues with WP status.

Discussion:

There are various problems with the specification of `list::unique` and its `forward_list` counterpart, some of which are obvious even on cursory inspection:

- It refers to the identifiers `first` and `last`, which aren't even defined.
- It uses `i - 1` on non-random-access iterators - in the case of `forward_list`, on forward-only iterators.
- The resolution of LWG 202, changing the specification of `std::unique` to require an equivalence relation and adjusting the order of comparison, weren't applied to these member functions.

LWG 491, which pointed out many of those problems with the specification of `list::unique`, was closed as NAD with the rationale that

> "All implementations known to the author of this Defect Report comply with these assumption", and "no impact on current code is expected", i.e. there is no evidence of real-world confusion or harm.

That implementations somehow managed to do the right thing in spite of obviously defective standardese doesn't seem like a good reason to not fix the defects.

[2017-07 Toronto Tuesday PM issue prioritization]

Priority 3; by the way, there's general wording in 25.2 [algorithms.requirements] p10 that lets us specify iterator arithmetic as if we were using random access iterators.

[2017-07-11 Tim comments]

I drafted the P/R fully aware of the general wording in 25.2 [algorithms.requirements] p10. However, that general wording is limited to Clause 28, so to make use of the shorthand permitted by that wording, we would need additional wording importing it to these subclauses.

Moreover, that general wording only defines `a+n` and `b-a`; it notably doesn't define `a-n`, which is needed here. And one cannot merely define `a-n` as `a+(-n)` since that has undefined behavior for forward iterators.

Previous resolution [SUPERSEDED]:

> This wording is relative to N4659.

> 1. Edit 22.3.10.5 [list.ops] as indicated:

>    >     void unique();
>    >     template <class BinaryPredicate> void unique(BinaryPredicate binary_pred);

>    > > -?- Requires: The comparison function shall be an equivalence relation.

>    > > -19- Effects: If `empty()`, has no effects. Otherwise, e Erases all but the first element from every consecutive group of equal equivalent elements referred to by the iterator `i` in the range `[first + 1, last)[next(begin()), end())` for which `*i == *(i-1)*j == *i` (for the version of `unique` with no arguments) or `pred(*i, *(i - 1))pred(*j, *i)` (for the version of `unique` with a predicate argument) holds, where `j` is an iterator in `[begin(), end())` such that `next(j) == i`. Invalidates only the iterators and references to the erased elements.

>    > > -20- Throws: Nothing unless an exception is thrown by `*i == *(i-1)` or `pred(*i, *(i - 1))` the equality comparison or the predicate.

>    > > -21- Complexity: If the range `[first, last)` is not empty`!empty()`, exactly `(last - first) - 1size() - 1` applications of the corresponding predicate, otherwise no applications of the predicate.

> 2. Edit 99 [forwardlist.ops] as indicated:

>    >     void unique();
>    >     template <class BinaryPredicate> void unique(BinaryPredicate binary_pred);

>    > > -?- Requires: The comparison function shall be an equivalence relation.

>    > > -16- Effects: If `empty()`, has no effects. Otherwise, e Erases all but the first element from every consecutive group of equal equivalent elements referred to by the iterator `i` in the range `[first + 1, last)[next(begin()), end())` for which `*i == *(i-1)*j == *i` (for the version with no arguments) or `pred(*i, *(i - 1))pred(*j, *i)` (for the version with a predicate argument) holds, where `j` is an iterator in `[begin(), end())` such that `next(j) == i`. Invalidates only the iterators and references to the erased elements.

>    > > -17- Throws: Nothing unless an exception is thrown by the equality comparison or the predicate.

>    > > -18- Complexity: If the range `[first, last)` is not empty`!empty()`, exactly `(last - first) - 1distance(begin(), end()) - 1` applications of the corresponding predicate, otherwise no applications of the predicate.

[2021-02-21 Tim redrafts]

The wording below incorporates editorial pull request 4465.

[2021-05-21; Reflector poll]

Set status to Tentatively Ready after five votes in favour during reflector poll.

[2021-06-07 Approved at June 2021 virtual plenary. Status changed: Voting → WP.]

Proposed resolution:

This wording is relative to N4878.

1. Edit 22.3.10.5 [list.ops] as indicated:

   > -1- Since lists allow fast insertion and erasing from the middle of a list, certain operations are provided specifically for them.222 In this subclause, arguments for a template parameter named `Predicate` or `BinaryPredicate` shall meet the corresponding requirements in 25.2 [algorithms.requirements]. The semantics of `i + n` and `i - n`, where `i` is an iterator into the list and `n` is an integer, are the same as those of `next(i, n)` and `prev(i, n)`, respectively. For `merge` and `sort`, the definitions and requirements in 25.8 [alg.sorting] apply.

   > […]

   >     void unique();
   >     template<class BinaryPredicate> void unique(BinaryPredicate binary_pred);

   > > -?- Let `binary_pred` be `equal_to<>{}` for the first overload.

   > > -?- Preconditions: `binary_pred` is an equivalence relation.

   > > -20- Effects: Erases all but the first element from every consecutive group of equal equivalent elements. That is, for a nonempty list, erases all elements referred to by the iterator `i` in the range `[first + 1, last)[begin() + 1, end())` for which `*i == *(i-1)` (for the version of `unique` with no arguments) or `binary_pred(*i, *(i - 1))` is `true`(for the version of `unique` with a predicate argument) holds. Invalidates only the iterators and references to the erased elements.

   > > -21- Returns: The number of elements erased.

   > > -22- Throws: Nothing unless an exception is thrown by `*i == *(i-1)` or `pred(*i, *(i - 1))`the predicate.

   > > -23- Complexity: If the range `[first, last)` is not empty `empty()` is `false`, exactly `(last - first) - 1size() - 1` applications of the corresponding predicate, otherwise no applications of the predicate.

2. Edit 99 [forwardlist.ops] as indicated:

   > -1- In this subclause, arguments for a template parameter named `Predicate` or `BinaryPredicate` shall meet the corresponding requirements in 25.2 [algorithms.requirements]. The semantics of `i + n`, where `i` is an iterator into the list and `n` is an integer, are the same as those of `next(i, n)`. The expression `i - n`, where `i` is an iterator into the list and `n` is an integer, means an iterator `j` such that `j + n == i` is `true`. For `merge` and `sort`, the definitions and requirements in 25.8 [alg.sorting] apply.

   > […]

   >     void unique();
   >     template<class BinaryPredicate> void unique(BinaryPredicate binary_pred);

   > > -?- Let `binary_pred` be `equal_to<>{}` for the first overload.

   > > -?- Preconditions: `binary_pred` is an equivalence relation.

   > > -18- Effects: Erases all but the first element from every consecutive group of equal equivalent elements. That is, for a nonempty list, erases all elements referred to by the iterator `i` in the range `[first + 1, last)[begin() + 1, end())` for which `*i == *(i-1)` (for the version with no arguments) or `binary_pred(*i, *(i - 1))` is `true` (for the version with a predicate argument) holds. Invalidates only the iterators and references to the erased elements.

   > > -19- Returns: The number of elements erased.

   > > -20- Throws: Nothing unless an exception is thrown by the equality comparison or the predicate.

   > > -21- Complexity: If the range `[first, last)` is not empty `empty()` is `false`, exactly `(last - first) - 1distance(begin(), end()) - 1` applications of the corresponding predicate, otherwise no applications of the predicate.