feat: specialize enable_borrowed_range for view types

include/boost/url/decode_view.hpp

@@ -1074,4 +1074,20 @@ make_decode_view(
 
 #include <boost/url/impl/decode_view.hpp>
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::decode_view> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/params_encoded_ref.hpp

@@ -1005,4 +1005,20 @@ class BOOST_URL_DECL params_encoded_ref
 //
 // #include <boost/url/impl/params_encoded_ref.hpp>
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::params_encoded_ref> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/params_encoded_view.hpp

@@ -239,4 +239,20 @@ class BOOST_URL_DECL params_encoded_view
 } // urls
 } // boost
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::params_encoded_view> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/params_ref.hpp

@@ -961,4 +961,20 @@ class BOOST_URL_DECL params_ref
 //
 // #include <boost/url/impl/params_ref.hpp>
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::params_ref> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/params_view.hpp

@@ -287,4 +287,20 @@ class params_view
 } // urls
 } // boost
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::params_view> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/pct_string_view.hpp

@@ -467,4 +467,14 @@ to_sv(pct_string_view const& s) noexcept
 // Ensure decode_view is complete for operator*()
 #include <boost/url/decode_view.hpp>
 
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::pct_string_view> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/segments_encoded_ref.hpp

@@ -794,4 +794,20 @@ class segments_encoded_ref
 //
 // #include <boost/url/impl/segments_encoded_ref.hpp>
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::segments_encoded_ref> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/segments_encoded_view.hpp

@@ -307,4 +307,20 @@ class segments_encoded_view
 } // urls
 } // boost
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::segments_encoded_view> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/segments_ref.hpp

@@ -740,4 +740,20 @@ class segments_ref
 //
 // #include <boost/url/impl/segments_ref.hpp>
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::segments_ref> = true;
+} // std::ranges
+#endif
+
 #endif

include/boost/url/segments_view.hpp

@@ -259,4 +259,20 @@ class segments_view
 } // urls
 } // boost
 
+//------------------------------------------------
+//
+// std::ranges::enable_borrowed_range
+//
+//------------------------------------------------
+
+#ifdef BOOST_URL_HAS_CONCEPTS
+#include <ranges>
+namespace std::ranges {
+    template<>
+    inline constexpr bool
+        enable_borrowed_range<
+            boost::urls::segments_view> = true;
+} // std::ranges
+#endif
+
 #endif

test/unit/decode_view.cpp

@@ -353,6 +353,25 @@ struct decode_view_test
         }
     }
 
+    void
+    testBorrowedRange()
+    {
+#ifdef BOOST_URL_HAS_CONCEPTS
+        // decode_view is a borrowed range
+        BOOST_CORE_STATIC_ASSERT(
+            std::ranges::borrowed_range<decode_view>);
+
+        // iterators remain valid after the view is destroyed
+        decode_view::iterator it;
+        {
+            decode_view dv("hello%20world");
+            it = dv.begin();
+        }
+        // iterator is still valid (points to external buffer)
+        BOOST_TEST_EQ(*it, 'h');
+#endif
+    }
+
     void
     run()
     {
@@ -365,6 +384,7 @@ struct decode_view_test
         testCompare();
         testStream();
         testPR127Cases();
+        testBorrowedRange();
     }
 };
 

test/unit/params_encoded_ref.cpp

@@ -770,13 +770,35 @@ struct params_encoded_ref_test
         }
     }
 
+    void
+    testBorrowedRange()
+    {
+#ifdef BOOST_URL_HAS_CONCEPTS
+        // params_encoded_ref is a borrowed range
+        BOOST_CORE_STATIC_ASSERT(
+            std::ranges::borrowed_range<params_encoded_ref>);
+
+        // iterators remain valid after the ref is destroyed
+        // (as long as the underlying url stays alive)
+        url u("?first=John&last=Doe");
+        params_encoded_ref::iterator it;
+        {
+            params_encoded_ref p = u.encoded_params();
+            it = p.begin();
+        }
+        // ref is destroyed, but iterator is still valid
+        BOOST_TEST_EQ((*it).key, "first");
+#endif
+    }
+
     void
     run()
     {
         testSpecial();
         testObservers();
         testModifiers();
         testJavadocs();
+        testBorrowedRange();
     }
 };
 

test/unit/params_encoded_view.cpp

@@ -214,12 +214,32 @@ struct params_encoded_view_test
         }
     }
 
+    void
+    testBorrowedRange()
+    {
+#ifdef BOOST_URL_HAS_CONCEPTS
+        // params_encoded_view is a borrowed range
+        BOOST_CORE_STATIC_ASSERT(
+            std::ranges::borrowed_range<params_encoded_view>);
+
+        // iterators remain valid after the view is destroyed
+        params_encoded_view::iterator it;
+        {
+            params_encoded_view qp("first=John&last=Doe");
+            it = qp.begin();
+        }
+        // iterator is still valid (points to external buffer)
+        BOOST_TEST_EQ((*it).key, "first");
+#endif
+    }
+
     void
     run()
     {
         testMembers();
         testRange();
         testJavadocs();
+        testBorrowedRange();
     }
 };
 

test/unit/params_ref.cpp

@@ -1032,6 +1032,28 @@ struct params_ref_test
         }
     }
 
+    static
+    void
+    testBorrowedRange()
+    {
+#ifdef BOOST_URL_HAS_CONCEPTS
+        // params_ref is a borrowed range
+        BOOST_CORE_STATIC_ASSERT(
+            std::ranges::borrowed_range<params_ref>);
+
+        // iterators remain valid after the ref is destroyed
+        // (as long as the underlying url stays alive)
+        url u("?first=John&last=Doe");
+        params_ref::iterator it;
+        {
+            params_ref p = u.params();
+            it = p.begin();
+        }
+        // ref is destroyed, but iterator is still valid
+        BOOST_TEST_EQ((*it).key, "first");
+#endif
+    }
+
     static
     void
     testAll()
@@ -1041,6 +1063,7 @@ struct params_ref_test
         testModifiers();
         testJavadocs();
         testSpaceAsPlus();
+        testBorrowedRange();
     }
 
     void

test/unit/params_view.cpp

@@ -142,11 +142,31 @@ struct params_view_test
         }
     }
 
+    void
+    testBorrowedRange()
+    {
+#ifdef BOOST_URL_HAS_CONCEPTS
+        // params_view is a borrowed range
+        BOOST_CORE_STATIC_ASSERT(
+            std::ranges::borrowed_range<params_view>);
+
+        // iterators remain valid after the view is destroyed
+        params_view::iterator it;
+        {
+            params_view qp("first=John&last=Doe");
+            it = qp.begin();
+        }
+        // iterator is still valid (points to external buffer)
+        BOOST_TEST_EQ((*it).key, "first");
+#endif
+    }
+
     void
     run()
     {
         testMembers();
         testJavadocs();
+        testBorrowedRange();
     }
 };