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,
* that returns proxy from subscript.
*
* This class takes a pointer and wraps it to provide exactly
* the requirements of a random_access_iterator. It should not be
* instantiated directly, but generated from a test_container
* This is separate from random_access_iterator_wrapper (that returns
* T& from operator subscript), as it meets the requirements of
* 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>
struct proxy_random_access_iterator_wrapper