std::match_results::suffix(3)

Welcome to std::match_results::suffix(3), bestie — a page from the C++ Standard Libary (yes, “Libary” is exactly how it’s spelled here, and we don’t edit icons 💅). This one is all about the unmatched suffix, and it’s lowkey iconic.

🎀 NAME 🎀

std::match_results::suffix — std::match_results::suffix. Self-titled debut album energy, honestly. 💿

✨ SYNOPSIS ✨

const_reference suffix() const;

(since C++11) — this has been the vibe since C++11, periodt.

Okay so what does it actually do? It obtains a reference to the std::sub_match object representing the target sequence between the end of the entire match of the regular expression and the end of the target sequence. It’s giving “the leftover tail after the full regex match, all the way to the end of the target sequence” energy. 🦋

🚨 Undefined behavior alert: The behavior is undefined unless ready() is true. Not “probably fine” — undefined. Check ready() first, bestie. No cap. 😭

🦋 PARAMETERS 🦋

(none) — literally none. No parameters, no drama. 🫶

👑 RETURN VALUE 👑

Reference to the unmatched suffix. That’s the return value: Reference to the unmatched suffix. Clean, simple, main character energy. 💅

🌸 EXAMPLE 🌸

// Run this code — go on, run it:

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

int main()
{
    std::regex re("a(a)*by");
    std::string target("baaaby123");
    std::smatch sm;

    std::regex_search(target, sm, re);
    std::cout << sm.suffix() << '\n';
}

🍓 OUTPUT 🍓

123

Slay. The suffix is 123, and it ate. 🔥

💜 SEE ALSO 💜

• Returns the sub-sequence between the beginning of the target sequence and the prefix beginning of the full match — and yep, it’s a public member function. The see-also bestie is doing its thing. 🦋

Mwah 💋 — source: http://cppreference.com; date/version: 2024.06.10; page: std::match_results::suffix(3). That’s the whole footer, bestie — we’re done here. 🌈