std::regex_...*,operator->(3)

💅 std::regex_...*,operator->(3) 💅

Okay bestie, this is the manual page std::regex_...*,operator->(3) from the C++ Standard Libary — and yes, that's the header's spelling, not me 💀. It's all about the std::regex_iterator duo operator* and operator->, and it's giving tiny-accessor, big-match-results energy ✨.

🎀 NAME 🎀

std::regex_iterator::operator*,operator-> — std::regex_iterator::operator*,operator->

Yes, the page literally lists it twice like that. Not me, the manpage. 💀

✨ Synopsis ✨

const value_type& operator*() const;  (1) (since C++11)
const value_type* operator->() const; (2) (since C++11)

Extracts the current std::match_results from a regex_iterator. Slay. 💖

💖 Return value 💖

1. Returns a reference to the current std::match_results.
2. Returns a pointer to the current std::match_results.

So operator* hands you the ref, and operator-> hands you the pointer. Both iconic, both since C++11. 🫶

🌸 Example 🌸

// Run this code

#include <iostream>
#include <regex>
#include <string>

int main()
{
    std::string hay{"1.1a2b3cjk34"};
    std::regex needle("[1234]");
    using Ri = std::regex_iterator<std::string::iterator>;
    for (Ri it{hay.begin(), hay.end(), needle}, last{}; it != last;
       ++it)
        std::cout << it->str();
    std::cout << '\n';
}

Bestie, this example is lowkey cute: it walks hay with the needle regex [1234], and prints each match using it->str(). The operator-> is doing main character work here. 👑🔥

🦋 Output 🦋

112334

That's the whole page, bestie. Source/version: http://cppreference.com · date: 2024.06.10 · footer page: std::regex_...*,operator->(3). Byeeee 💅🎀