TLA  Line data    Source code

       1                 : //
       2                 : // Copyright (c) 2025 Vinnie Falco (vinnie.falco@gmail.com)
       3                 : //
       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)
       6                 : //
       7                 : // Official repository: https://github.com/cppalliance/capy
       8                 : //
       9                 : 
      10                 : #ifndef BOOST_CAPY_TEST_BUFFER_TO_STRING_HPP
      11                 : #define BOOST_CAPY_TEST_BUFFER_TO_STRING_HPP
      12                 : 
      13                 : #include <boost/capy/detail/config.hpp>
      14                 : #include <boost/capy/buffers.hpp>
      15                 : 
      16                 : #include <string>
      17                 : 
      18                 : namespace boost {
      19                 : namespace capy {
      20                 : namespace test {
      21                 : 
      22                 : /** Convert one or more buffer sequences to a string.
      23                 : 
      24                 :     This function concatenates the bytes from all provided buffer
      25                 :     sequences into a single string. With a single argument, it
      26                 :     converts that buffer sequence to a string. With multiple
      27                 :     arguments, it concatenates them in order.
      28                 : 
      29                 :     @par Example
      30                 :     @code
      31                 :     // Single buffer sequence
      32                 :     const_buffer cb( "hello", 5 );
      33                 :     std::string s = buffer_to_string( cb );  // "hello"
      34                 : 
      35                 :     // Multiple buffer sequences (concatenation)
      36                 :     const_buffer b1( "hello", 5 );
      37                 :     const_buffer b2( " world", 6 );
      38                 :     std::string s = buffer_to_string( b1, b2 );  // "hello world"
      39                 : 
      40                 :     // With bufgrind splits
      41                 :     bufgrind bg( cb );
      42                 :     while( bg ) {
      43                 :         auto [b1, b2] = co_await bg.next();
      44                 :         BOOST_TEST_EQ( buffer_to_string( b1, b2 ), "hello" );
      45                 :     }
      46                 :     @endcode
      47                 : 
      48                 :     @param bufs One or more buffer sequences to concatenate.
      49                 : 
      50                 :     @return A string containing all bytes from the buffer sequences.
      51                 : */
      52                 : template<ConstBufferSequence... Buffers>
      53                 : std::string
      54 HIT        1579 : buffer_to_string(Buffers const&... bufs)
      55                 : {
      56            1579 :     std::string result;
      57            1579 :     result.reserve((buffer_size(bufs) + ...));
      58            4053 :     auto append = [&](auto const& bs) {
      59            2488 :         auto const e = end(bs);
      60            4986 :         for(auto it = begin(bs); it != e; ++it)
      61                 :         {
      62            2498 :             const_buffer b(*it);
      63            4996 :             result.append(
      64            2498 :                 static_cast<char const*>(b.data()),
      65                 :                 b.size());
      66                 :         }
      67                 :     };
      68            1579 :     (append(bufs), ...);
      69            3158 :     return result;
      70 MIS           0 : }
      71                 : 
      72                 : } // test
      73                 : } // capy
      74                 : } // boost
      75                 : 
      76                 : #endif