Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
std::match_results::str(3)    C++ Standard Libary   std::match_results::str(3)

NAME
       std::match_results::str - std::match_results::str

Synopsis
	  string_type str( size_type n = 0 ) const;  (since C++11)

	  Returns a string representing	the indicated sub-match.

	  If  n	 ==  0,	a string representing entire matched expression	is re-
       turned.

	  If n > 0 && n	< size(), a string representing	nth sub-match  is  re-
       turned.

	  if  n	 >=  size(),  a	string representing the	unmatched match	is re-
       turned.

	  The call is equivalent to string_type((*this)[n]);

Parameters
	  n - integral number specifying which match to	return

Return value
	  Returns a string representing	the specified match or sub match.

Example
       // Run this code

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

	int main()
	{
	    std::string	target("baaaby");
	    std::smatch	sm;

	    std::regex re1("a(a)*b");
	    std::regex_search(target, sm, re1);
	    std::cout << "entire match:	" << sm.str(0) << '\n'
		      << "submatch #1: " << sm.str(1) << '\n';

	    std::regex re2("a(a*)b");
	    std::regex_search(target, sm, re2);
	    std::cout << "entire match:	" << sm.str(0) << '\n'
		      << "submatch #1: " << sm.str(1) << '\n';

	}

Output:
	entire match: aaab
	submatch #1: a
	entire match: aaab
	submatch #1: aa

See also
	  operator[] returns specified sub-match
		     (public member function)

http://cppreference.com		  2022.07.31	    std::match_results::str(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::match_results::str&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help