Пространства имён
Варианты
Действия

std::regex_match

Материал из cppreference.com
< cpp‎ | regex

This page has been machine-translated from the English version of the wiki using Google Translate.

The translation may contain errors and awkward wording. Hover over text to see the original version. You can help to fix errors and improve the translation. For instructions click here.

Click here for the English version of this page

 
C++
 
Библиотеки регулярных выражений
Классы
Оригинал:
Classes
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_regex(C++11)
sub_match(C++11)
match_results(C++11)
Алгоритмы
Оригинал:
Algorithms
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
regex_match(C++11)
regex_search(C++11)
regex_replace(C++11)
Итераторы
Оригинал:
Iterators
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
regex_iterator(C++11)
regex_token_iterator(C++11)
Исключения
Оригинал:
Exceptions
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
regex_error(C++11)
Черты
Оригинал:
Traits
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
regex_traits(C++11)
Константы
Оригинал:
Constants
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
syntax_option_type(C++11)
match_flag_type(C++11)
error_type(C++11)
 
Определено в заголовочном файле <regex>
template< class BidirIt,

          class Alloc, class CharT, class Traits >
bool regex_match( BidirIt first, BidirIt last,
                  std::match_results<BidirIt,Alloc>& m,
                  const std::basic_regex<CharT,Traits>& e,
                  std::regex_constants::match_flag_type flags =

                      std::regex_constants::match_default );
 (1) (начиная с C++11)
template< class BidirIt,

          class CharT, class Traits >
bool regex_match( BidirIt first, BidirIt last,
                  const std::basic_regex<CharT,Traits>& e,
                  std::regex_constants::match_flag_type flags =

                      std::regex_constants::match_default );
 (2) (начиная с C++11)
template< class CharT, class Alloc, class Traits >

bool regex_match( const CharT* str,
                  std::match_results<const CharT*,Alloc>& m,
                  const std::basic_regex<CharT,Traits>& e,
                  std::regex_constants::match_flag_type flags =

                      std::regex_constants::match_default );
 (3) (начиная с C++11)
template< class STraits, class SAlloc,

          class Alloc, class CharT, class Traits >
bool regex_match( const std::basic_string<CharT,STraits,SAlloc>& s,
                  std::match_results<
                      typename std::basic_string<CharT,STraits,SAlloc>::const_iterator,
                      Alloc
                  >& m,
                  const std::basic_regex<CharT,Traits>& e,
                  std::regex_constants::match_flag_type flags =

                      std::regex_constants::match_default );
 (4) (начиная с C++11)
template< class CharT, class Traits >

bool regex_match( const CharT* str,
                  const std::basic_regex<CharT,Traits>& e,
                  std::regex_constants::match_flag_type flags =

                      std::regex_constants::match_default );
 (5) (начиная с C++11)
template< class STraits, class SAlloc,

          class CharT, class Traits >
bool regex_match( const std::basic_string<CharT, STraits, SAlloc>& s,
                  const std::basic_regex<CharT,Traits>& e,
                  std::regex_constants::match_flag_type flags =

                      std::regex_constants::match_default );
 (6) (начиная с C++11)
1)
Определяет, есть ли матч между регулярным выражением e и вся последовательность символов целевой [first,last), принимая во внимание эффект flags. Результаты матча будут возвращены в m.
Оригинал:
Determines if there is a match between the regular expression e and the entire target character sequence [first,last), taking into account the effect of flags. Match results are returned in m.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
2)
Ведет себя как (1) выше, опуская результаты матчей.
Оригинал:
Behaves as (1) above, omitting the match results.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
3)
Возврат std::regex_match(str, str + std::char_traits<charT>::length(str), m, e, flags).
Оригинал:
Returns std::regex_match(str, str + std::char_traits<charT>::length(str), m, e, flags).
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
4)
Возврат std::regex_match(s.begin(), s.end(), m, e, flags).
Оригинал:
Returns std::regex_match(s.begin(), s.end(), m, e, flags).
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
5)
Возврат std::regex_match(str, str + std::char_traits<charT>::length(str), e, flags).
Оригинал:
Returns std::regex_match(str, str + std::char_traits<charT>::length(str), e, flags).
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
6)
Возврат std::regex_match(s.begin(), s.end(), e, flags).
Оригинал:
Returns std::regex_match(s.begin(), s.end(), e, flags).
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

Содержание

[править] Параметры

first, last -
Диапазон целевой характер, чтобы применить регулярное выражение, чтобы, учитывая, что и итераторы
Оригинал:
the target character range to apply the regex to, given as iterators
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m -
результаты матчей
Оригинал:
the match results
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
str -
целевой строки, приведенные в качестве нулем C-стиля строки
Оригинал:
the target string, given as a null-terminated C-style string
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
s -
целевой строки, приведенные в качестве std::basic_string
Оригинал:
the target string, given as a std::basic_string
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
e -
регулярное выражение
Оригинал:
the regular expression
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
flags -
Флаги используются для определения того, как матч будет выполнена
Оригинал:
flags used to determine how the match will be performed
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Требования к типам
-
BidirIt должен соответствовать требованиям BidirectionalIterator.

[править] Возвращаемое значение

Возврат true, если существует совпадение, false иначе. В любом случае, объект m обновляется, а именно:
Оригинал:
Returns true if a match exists, false otherwise. In either case, the object m is updated, as follows:
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Если матч не существует
Оригинал:
If the match does not exist:
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m.ready() == true
m.empty() == true
m.size() == 0
Если соответствия не существует
Оригинал:
If the match exists:
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m.ready() true
m.empty() false
m.size()
число подвыражений плюс 1, то есть 1+e.mark_count()
Оригинал:
number of subexpressions plus 1, that is, 1+e.mark_count()
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m.prefix().first first
m.prefix().second first
m.prefix().matched
false (матч префикс пуст)
Оригинал:
false (the match prefix is empty)
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m.suffix().first last
m.suffix().second last
m.suffix().matched
false (матч суффикс пустой)
Оригинал:
false (the match suffix is empty)
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m[0].first first
m[0].second last
m[0].matched
true (вся последовательность соответствует)
Оригинал:
true (the entire sequence is matched)
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m[n].first
начало последовательности, которая соответствует части выражения п, или last если подвыражение не принимал участия в матче
Оригинал:
the start of the sequence that matched sub-expression n, or last if the subexpression did not participate in the match
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m[n].second
К концу последовательности, которая соответствует части выражения п, или last если подвыражение не принимал участия в матче
Оригинал:
the end of the sequence that matched sub-expression n, or last if the subexpression did not participate in the match
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
m[n].matched
true если подвыражение п участие в матче, false иначе
Оригинал:
true if sub-expression n participated in the match, false otherwise
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

[править] Пример

#include <iostream>
#include <string>
#include <regex>
 
int main()
{
    std::string fnames[] = {"foo.txt", "bar.txt", "zoidberg"};
 
    std::regex txt_regex("[a-z]+\\.txt");
    for (const auto &fname : fnames) {
        std::cout << fname << ": " << std::regex_match(fname, txt_regex) << '\n';
    }
}

Вывод: 

foo.txt: 1
bar.txt: 1
zoidberg: 0

[править] См. также

(C++11)
объекта регулярного выражения
Оригинал:
regular expression object
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(шаблон класса) [edit]
(C++11)
идентифицирует один регулярного выражения, в том числе все части выражения матчей
Оригинал:
identifies one regular expression match, including all sub-expression matches
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(шаблон класса) [edit]
Источник — «http://ru.cppreference.com/mwiki/index.php?title=cpp/regex/regex_match&oldid=34556»