{"id":4455,"date":"2022-03-16T10:55:58","date_gmt":"2022-03-16T08:55:58","guid":{"rendered":"https:\/\/mariusbancila.ro\/blog\/?p=4455"},"modified":"2022-03-16T10:58:47","modified_gmt":"2022-03-16T08:58:47","slug":"new-cpp23-range-adaptors","status":"publish","type":"post","link":"https:\/\/mariusbancila.ro\/blog\/2022\/03\/16\/new-cpp23-range-adaptors\/","title":{"rendered":"New C++23 range adaptors"},"content":{"rendered":"\n

The C++23 standard provides several new range adaptors in the ranges library. These include join_with<\/code>, zip<\/code>, and zip_transform<\/code>. In this post, I will briefly show how these should work.<\/p>\n\n\n\n\n\n\n\n

Note<\/h4>

Keep in mind though that no compiler supports these adaptors at this moment, so the code presented here in untested.<\/p><\/div><\/div>\n\n\n\n

Joining<\/h2>\n\n\n\n

In C++20, there is an adaptor called join_view<\/a><\/code>. This flattens a range of ranges of T<\/code> into a range of T<\/code>. Here is an example:<\/p>\n\n\n\n

using namespace std::ranges;\n\nauto l_as_string = []<typename R>(R range){\n   return std::string(std::begin(range), std::end(range));\n};\n\nstd::vector<std::string> words{\"this\", \"is\", \"a\", \"demo\"};\nauto text = l_as_string(words | views::join);\nstd::cout << text << '\\n';<\/pre>\n\n\n\n
The text variable contains the \"thisisademo\"<\/code> string. Which is what you would need in various scenarios. But what if you actually need to include some separated between each range. For instance, what if you want the result to be \"this is a demo\"<\/code>?<\/p>\n\n\n\n
You ca solve this with join_with_view<\/a><\/code> in C++23. The change is minimal, as show in the following snippet:<\/p>\n\n\n\n
auto text = l_as_string(words | views::join_with(' '));<\/pre>\n\n\n\n
Zipping<\/h2>\n\n\n\n
Zipping is the process of talking one element at a time from two or more ranges and creating a new range of tuples from those elements.<\/p>\n\n\n\n
Some people assume that zipping create a new range that intercalates elements, such as in the following example:<\/p>\n\n\n\n
R1: {1, 2, 3, 4}\nR2: {10, 20}\nR3: {100, 200, 300}\nzip(R1, R2, R3): {1,10,100,2,20,200}<\/pre>\n\n\n\n
This is incorrect. Zipping creates tuples as conceptually shown here:<\/p>\n\n\n\n
R1: {1, 2, 3, 4}\nR2: {10, 20}\nR3: {100, 200, 300}\nzip(R1, R2, R3): {(1,10,100),(2,20,200)}<\/pre>\n\n\n\n
This is possible in C++23 with the zip_view<\/a><\/code> adaptor. Let’s take an example:<\/p>\n\n\n\n
std::array<int, 4> n{ 1, 2, 3, 4 };\nstd::vector<std::string> w{ \"one\",\"two\",\"three\" };\n\nauto z1 = views::zip(n, w) \/\/ { (1, \"one\"), (2, \"two\"), (3, \"three\") }\n\nfor(auto t : z1)\n   std::cout << std::get<0>(t) << '-' \n             << std::get<1>(t) << '\\n';<\/pre>\n\n\n\n
The result of zipping an array of integers and a vector of strings is a view of tuple<int&, string&><\/code>. We can use std::get<\/code> to fetch the value of each element of the tuple.<\/p>\n\n\n\n
Sometimes you might want to perform a transformation on the zipped values. For instance adding or concatenating them. In this case, the result is not a view of tuples, but a view of T<\/code>s. Here is a conceptual example where elements are added together producing a range of integers:<\/p>\n\n\n\n
R1: {1, 2, 3, 4}\nR2: {10, 20}\nR3: {100, 200, 300}\nzip_transform(+, R1, R2, R3): {111,222}<\/pre>\n\n\n\n
This operation is supported by the zip_transform_view<\/a><\/code> adaptor in C++23. This is similar to zip_view<\/code> except that its first parameter is a callable object (such as a function, a functor, or a lambda expression). Here is an example:<\/p>\n\n\n\n
auto l_concat = [](int n, std::string const& s) {\n   return std::to_string(n) + \"-\" + s;\n};\n\nauto z2 = views::zip_transform(l_concat, n, w); \/\/ {\"1-one\", \"2-two\", \"3-three\"}\nfor (auto e : z2) \n   std::cout << e << '\\n';<\/pre>\n\n\n\n
References<\/h2>\n\n\n\n
P2321: zip<\/a><\/p>\n\n\n\n
P2441: views::join_with<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
The C++23 standard provides several new range adaptors in the ranges library. These include join_with, zip, and zip_transform. In this post, I will briefly show how these should work.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","advgb_blocks_editor_width":"","advgb_blocks_columns_visual_guide":"","_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"jetpack_post_was_ever_published":false},"categories":[1],"tags":[],"class_list":["post-4455","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t