regex_match 函式
測試規則運算式是否符合整個目標字串。
// (1) template<class BidIt, class Alloc, class Elem, class RXtraits, class Alloc2> bool regex_match(BidIt first, Bidit last, match_results<BidIt, Alloc>& match, const basic_regex<Elem, RXtraits, Alloc2>& re, match_flag_type flags = match_default); // (2) template<class BidIt, class Elem, class RXtraits, class Alloc2> bool regex_match(BidIt first, Bidit last, const basic_regex<Elem, RXtraits, Alloc2>& re, match_flag_type flags = match_default); // (3) template<class Elem, class Alloc, class RXtraits, class Alloc2> bool regex_match(const Elem *ptr, match_results<const Elem*, Alloc>& match, const basic_regex<Elem, RXtraits, Alloc2>& re, match_flag_type flags = match_default); // (4) template<class Elem, class RXtraits, class Alloc2> bool regex_match(const Elem *ptr, const basic_regex<Elem, RXtraits, Alloc2>& re, match_flag_type flags = match_default); // (5) template<class IOtraits, class IOalloc, class Alloc, class Elem, class RXtraits, class Alloc2> bool regex_match(const basic_string<Elem, IOtraits, IOalloc>& str, match_results<typename basic_string<Elem, IOtraits, IOalloc>::const_iterator, Alloc>& match, const basic_regex<Elem, RXtraits, Alloc2>& re, match_flag_type flags = match_default); // (6) template<class IOtraits, class IOalloc, class Elem, class RXtraits, class Alloc2> bool regex_match(const basic_string<Elem, IOtraits, IOalloc>& str, const basic_regex<Elem, RXtraits, Alloc2>& re, match_flag_type flags = match_default);
參數
BidIt
子符合項的迭代器類型。 在一般情況下，這為 string::const_iterator、wstring::const_iterator、const char* 或 const wchar_t*。Alloc
符合結果配置器類別。Elem
要符合之項目的類型。 在一般情況下，這為 string、wstring、char* 或 wchar_t*。RXtraits
項目的 Traits 類別。Alloc2
規則運算式配置器類別。IOtraits
字串特性類別。IOalloc
字串配置器類別。flags
比對的旗標。first
要比對的序列開頭。last
要比對的序列結尾。match
比對結果。 對應至 Elem 類型：smatch (針對 string)、wsmatch (針對 wstring)、cmatch (針對 char*)，或 wcmatch (針對 wchar_t*)。ptr
要比對之序列開頭的指標。 如果 ptr 為 char*，則請使用 cmatch 和 regex。 如果 ptr 為 wchar_t*，則請使用 wcmatch 和 wregex。re
要比對的規則運算式。 輸入 regex (針對 string 和 char*) 或 wregex (針對 wstring 和 wchar_t*)。str
要比對的字串。 對應至類型 Elem。
備註
只有在整個運算元序列 str 完全符合規則運算式引數 re 時，每個範本函式才會傳回 true。 使用 regex_search 比對目標序列內的子字串，以及使用 regex_iterator 來尋找多個相符項。
使用 match_results 物件的函式會設定其成員，以反映比對是否成功，而且，如果成功，規則運算式中的各種擷取群組會擷取到什麼。
(1):
範例
// RegexTestBed.cpp : Defines the entry point for the console application.
//
#include "stdafx.h"
#include <regex>
#include <iostream>
using namespace std;
int _tmain(int argc, _TCHAR* argv[])
{
// (1) with char*
// Note how const char* requires cmatch and regex
const char *first = "abc";
const char *last = first + strlen(first);
cmatch narrowMatch;
regex rx("a(b?)c");
bool found = regex_match(first, last, narrowMatch, rx);
// (1) with std::wstring
// Note how wstring requires wsmatch and wregex.
// Note use of const iterators cbegin() and cend().
wstring target(L"Hello");
wsmatch wideMatch;
wregex wrx(L"He(l+)o");
if (regex_match(target.cbegin(), target.cend(), wideMatch, wrx))
wcout << L"The matching text is:" << wideMatch.str() << endl;
// (2) with std::string
string target2("Drizzle");
regex rx2(R"(D\w+e)"); // no double backslashes with raw string literal
found = regex_match(target2.cbegin(), target2.cend(), rx2);
// (3) with wchar_t*
const wchar_t* target3 = L"2014-04-02";
wcmatch wideMatch2;
// LR"(...)" is a raw wide-string literal. Open and close parens
// are delimiters, not string elements.
wregex wrx2(LR"(\d{4}(-|/)\d{2}(-|/)\d{2})");
if (regex_match(target3, wideMatch2, wrx2))
{
wcout << L"Matching text: " << wideMatch2.str() << endl;
}
return 0;
}
需求
標頭：<regex>
命名空間: std