. /include/boost/capy /test /buffer_to_string.hpp
91.67% Lines (11/12) 100.00% Functions (2/2)
[ ] prev/next file n p prev/next uncovered line
TLA Baseline Branch
Line Hits Code Line Hits Code
1   // 1   //
2   // Copyright (c) 2025 Vinnie Falco (vinnie.falco@gmail.com) 2   // Copyright (c) 2025 Vinnie Falco (vinnie.falco@gmail.com)
3   // 3   //
4   // Distributed under the Boost Software License, Version 1.0. (See accompanying 4   // Distributed under the Boost Software License, Version 1.0. (See accompanying
5   // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) 5   // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6   // 6   //
7   // Official repository: https://github.com/cppalliance/capy 7   // Official repository: https://github.com/cppalliance/capy
8   // 8   //
9   9  
10   #ifndef BOOST_CAPY_TEST_BUFFER_TO_STRING_HPP 10   #ifndef BOOST_CAPY_TEST_BUFFER_TO_STRING_HPP
11   #define BOOST_CAPY_TEST_BUFFER_TO_STRING_HPP 11   #define BOOST_CAPY_TEST_BUFFER_TO_STRING_HPP
12   12  
13   #include <boost/capy/detail/config.hpp> 13   #include <boost/capy/detail/config.hpp>
14   #include <boost/capy/buffers.hpp> 14   #include <boost/capy/buffers.hpp>
15   15  
16   #include <string> 16   #include <string>
17   17  
18   namespace boost { 18   namespace boost {
19   namespace capy { 19   namespace capy {
20   namespace test { 20   namespace test {
21   21  
22   /** Convert one or more buffer sequences to a string. 22   /** Convert one or more buffer sequences to a string.
23   23  
24   This function concatenates the bytes from all provided buffer 24   This function concatenates the bytes from all provided buffer
25   sequences into a single string. With a single argument, it 25   sequences into a single string. With a single argument, it
26   converts that buffer sequence to a string. With multiple 26   converts that buffer sequence to a string. With multiple
27   arguments, it concatenates them in order. 27   arguments, it concatenates them in order.
28   28  
29   @par Example 29   @par Example
30   @code 30   @code
31   // Single buffer sequence 31   // Single buffer sequence
32   const_buffer cb( "hello", 5 ); 32   const_buffer cb( "hello", 5 );
33   std::string s = buffer_to_string( cb ); // "hello" 33   std::string s = buffer_to_string( cb ); // "hello"
34   34  
35   // Multiple buffer sequences (concatenation) 35   // Multiple buffer sequences (concatenation)
36   const_buffer b1( "hello", 5 ); 36   const_buffer b1( "hello", 5 );
37   const_buffer b2( " world", 6 ); 37   const_buffer b2( " world", 6 );
38   std::string s = buffer_to_string( b1, b2 ); // "hello world" 38   std::string s = buffer_to_string( b1, b2 ); // "hello world"
39   39  
40   // With bufgrind splits: each half is itself a buffer sequence, 40   // With bufgrind splits: each half is itself a buffer sequence,
41   // so pass it directly -- there is no .data() to unwrap. 41   // so pass it directly -- there is no .data() to unwrap.
42   bufgrind bg( cb ); 42   bufgrind bg( cb );
43   while( bg ) { 43   while( bg ) {
44   auto [b1, b2] = co_await bg.next(); 44   auto [b1, b2] = co_await bg.next();
45   BOOST_TEST_EQ( buffer_to_string( b1, b2 ), "hello" ); 45   BOOST_TEST_EQ( buffer_to_string( b1, b2 ), "hello" );
46   } 46   }
47   @endcode 47   @endcode
48   48  
49   @param bufs One or more buffer sequences to concatenate. 49   @param bufs One or more buffer sequences to concatenate.
50   50  
51   @return A string containing all bytes from the buffer sequences. 51   @return A string containing all bytes from the buffer sequences.
52   */ 52   */
53   template<ConstBufferSequence... Buffers> 53   template<ConstBufferSequence... Buffers>
54   std::string 54   std::string
HITCBC 55   176 buffer_to_string(Buffers const&... bufs) 55   176 buffer_to_string(Buffers const&... bufs)
56   { 56   {
HITCBC 57   176 std::string result; 57   176 std::string result;
HITCBC 58   176 result.reserve((buffer_size(bufs) + ...)); 58   176 result.reserve((buffer_size(bufs) + ...));
HITCBC 59   488 auto append = [&](auto const& bs) { 59   488 auto append = [&](auto const& bs) {
HITCBC 60   312 auto const e = end(bs); 60   312 auto const e = end(bs);
HITCBC 61   634 for(auto it = begin(bs); it != e; ++it) 61   634 for(auto it = begin(bs); it != e; ++it)
62   { 62   {
HITCBC 63   319 const_buffer b(*it); 63   319 const_buffer b(*it);
HITCBC 64   644 result.append( 64   644 result.append(
HITCBC 65   322 static_cast<char const*>(b.data()), 65   322 static_cast<char const*>(b.data()),
66   b.size()); 66   b.size());
67   } 67   }
68   }; 68   };
HITCBC 69   176 (append(bufs), ...); 69   176 (append(bufs), ...);
HITCBC 70   352 return result; 70   352 return result;
MISUBC 71   ✗ } 71   ✗ }
72   72  
73   } // test 73   } // test
74   } // capy 74   } // capy
75   } // boost 75   } // boost
76   76  
77   #endif 77   #endif