libstdc++: Add comment justifying separate proxy_random_access_iterator_wrapper.

It meets Cpp17RandomAccessIterator requirements, but does not satisfy
random_access_iterator concept.

libstdc++-v3/ChangeLog:

	* testsuite/util/testsuite_iterators.h: Modify comment.

Reviewed-by: Jonathan Wakely <jwakely@redhat.com>
Signed-off-by: Tomasz Kamiński <tkaminsk@redhat.com>
This commit is contained in:
Tomasz Kamiński
2026-01-14 10:35:59 +01:00
parent 7f114df909
commit e16de4a10f

View File

@@ -695,9 +695,12 @@ namespace __gnu_test
* @brief random_access_iterator wrapper for pointer, * @brief random_access_iterator wrapper for pointer,
* that returns proxy from subscript. * that returns proxy from subscript.
* *
* This class takes a pointer and wraps it to provide exactly * This is separate from random_access_iterator_wrapper (that returns
* the requirements of a random_access_iterator. It should not be * T& from operator subscript), as it meets the requirements of
* instantiated directly, but generated from a test_container * Cpp17RandomAccessIterator (C++20 [tab:randomaccessiterator])
* that allows to return type that is convertible to reference,
* but does not satisfy random_access_iterator concept
* (C++20 [random_access_iterator]).
*/ */
template<class T> template<class T>
struct proxy_random_access_iterator_wrapper struct proxy_random_access_iterator_wrapper