#include <boost/regex.hpp>

Алгоритм<regex_match>определяет, соответствует ли данное регулярное выражениевсейзаданной последовательности символов, обозначаемой парой двунаправленных итераторов, алгоритм определяется следующим образом, основное использование этой функции — валидация ввода данных.

	Important
	Обратите внимание, что результат верен только в том случае, если выражение соответствуетцеломувходной последовательности. Если вы хотите найти выражение где-то в последовательности, используйте<regex_search>. Если вы хотите сопоставить приставку строки символа, используйте<regex_search>с флагом match_continuous set.

template <class BidirectionalIterator, class Allocator, class charT, class traits>
bool regex_match(BidirectionalIterator first, BidirectionalIterator last,
                 match_results<BidirectionalIterator, Allocator>& m,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);
template <class BidirectionalIterator, class charT, class traits>
bool regex_match(BidirectionalIterator first, BidirectionalIterator last,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);
template <class charT, class Allocator, class traits>
bool regex_match(const charT* str, match_results<const charT*, Allocator>& m,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);
template <class ST, class SA, class Allocator, class charT, class traits>
bool regex_match(const basic_string<charT, ST, SA>& s,
                 match_results<typename basic_string<charT, ST, SA>::const_iterator, Allocator>& m,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);
template <class charT, class traits>
bool regex_match(const charT* str,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);
template <class ST, class SA, class charT, class traits>
bool regex_match(const basic_string<charT, ST, SA>& s,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);

Description

template <class BidirectionalIterator, class Allocator, class charT, class traits>
bool regex_match(BidirectionalIterator first, BidirectionalIterator last,
                 match_results<BidirectionalIterator, Allocator>& m,
                 const basic_regex <charT, traits>& e,
                 match_flag_type flags = match_default);

Требуется: Двунаправленный итератор соответствует требованиям двухнаправленного итератора (24.1.4).

Эффекты: Определяет, существует ли точное соответствие между регулярным выражениемeи всей последовательностью символов [первый, последний], параметрфлагов(см.<match_flag_type>) используется для контроля того, как выражение совпадает с последовательностью символов. Возвращается истинно, если такой матч существует, ложно иначе.

Бросает:<std::runtime_error>если сложность сопоставления выражения со строкой символа N начинает превышать O(N²), или если программа исчерпала пространство стека при сопоставлении выражения (если Boost). Regex настраивается в рекурсивном режиме, или если спичечный аппарат исчерпал свое разрешенное выделение памяти (если Boost). Regex настроен в нерекурсивном режиме.

Пост-условия: Если функция возвращается ложной, то влияние на параметрмне определено, иначе эффекты на параметрмприведены в таблице:

template <class BidirectionalIterator, class charT, class traits>
bool regex_match(BidirectionalIterator first, BidirectionalIterator last,
               const basic_regex <charT, traits>& e,
               match_flag_type flags = match_default);

Эффекты: Вести себя «как будто», сооружая экземпляр<match_results<BidirectionalIterator>what>, а затем возвращая результат<regex_match(first,last,what,e, flags)>.

template <class charT, class Allocator, class traits>
bool regex_match(const charT* str, match_results<const charT*, Allocator>& m,
               const basic_regex <charT, traits>& e,
               match_flag_type flags = match_default);

Эффекты: Возвращает результат<regex_match(str,str +char_traits<charT>::length(str), m,e,flags)>.

template <class ST, class SA, class Allocator,
         class charT, class traits>
bool regex_match(const basic_string<charT, ST, SA>& s,
               match_results<typename basic_string<charT, ST, SA>::const_iterator, Allocator>& m,
               const basic_regex <charT, traits>& e,
               match_flag_type flags = match_default);

Эффекты: Возвращает результат<regex_match(s.begin(),s.end(),m,e,flags)>.

template <class charT, class traits>
bool regex_match(const charT* str,
               const basic_regex <charT, traits>& e,
               match_flag_type flags = match_default);

Эффекты: Возвращает результат<regex_match(str,str +char_traits<charT>::length(str), e,flags)>.

template <class ST, class SA, class charT, class traits>
bool regex_match(const basic_string<charT, ST, SA>& s,
               const basic_regex <charT, traits>& e,
               match_flag_type flags = match_default);

Эффекты: Возвращает результат<regex_match(s.begin(),s.end(),e,flags)>.

Examples

Следующий пример обрабатывает ответ ftp:

#include <stdlib.h>
#include <boost/regex.hpp>
#include <string>
#include <iostream>
using namespace boost;
regex expression("([0-9]+)(\\-| |$)(.*)");
// process_ftp: 
// on success returns the ftp response code, and fills 
// msg with the ftp response message. 
int process_ftp(const char* response, std::string* msg)
{
   cmatch what;
   if(regex_match(response, what, expression))
   {
      // what[0] contains the whole string 
      // what[1] contains the response code 
      // what[2] contains the separator character 
      // what[3] contains the text message. 
      if(msg)
         msg->assign(what[3].first, what[3].second);
      return std::atoi(what[1].first);
   }
   // failure did not match 
   if(msg)
      msg->erase();
   return -1;
}