std::ranges::borrowed_iterator_t, std::ranges::borrowed_subrange_t

From cppreference.com
< cpp‎ | ranges
 
 
Ranges library
Range access
Range conversions
(C++23)
Range primitives



Dangling iterator handling
borrowed_iterator_t
  
borrowed_subrange_t
  
Range concepts
Views

Factories






Adaptors
Range adaptor objects
Range adaptor closure objects
Helper items
 
Defined in header <ranges>
template< ranges::range R >
using borrowed_iterator_t = /* see below */;
(1) (since C++20)
template< ranges::range R >
using borrowed_subrange_t = /* see below */;
(2) (since C++20)
1) std::ranges::iterator_t<R> if R models borrowed_range, std::ranges::dangling otherwise.

These two alias templates are used by some constrained algorithms to avoid returning potentially dangling iterators or views.

Possible implementation

First version
template< std::ranges::range R >
using borrowed_iterator_t = std::conditional_t<std::ranges::borrowed_range<R>,
    std::ranges::iterator_t<R>, std::ranges::dangling>;
Second version
template< std::ranges::range R >
using borrowed_subrange_t = std::conditional_t<std::ranges::borrowed_range<R>,
    std::ranges::subrange<std::ranges::iterator_t<R>>, std::ranges::dangling>;

See also

a placeholder type indicating that an iterator or a subrange should not be returned since it would be dangling
(class)