std::regex_match

来自cppreference.com
< cpp‎ | regex

定义于头文件 <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.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
2)
表现为上述(1),省略了比赛的结果.
原文:
Behaves as (1) above, omitting the match results.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
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).
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
4)
返回std::regex_match(s.begin(), s.end(), m, e, flags).
原文:
Returns std::regex_match(s.begin(), s.end(), m, e, flags).
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
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).
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
6)
返回std::regex_match(s.begin(), s.end(), e, flags).
原文:
Returns std::regex_match(s.begin(), s.end(), e, flags).
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 参数

first, last -
目标应用正则表达式的字符范围,作为迭代器
原文:
the target character range to apply the regex to, given as iterators
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m -
比赛结果
原文:
the match results
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
str -
在目标字符串,给出一个空结束的C风格字符串
原文:
the target string, given as a null-terminated C-style string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
s -
在目标字符串,作为一个std::basic_string
原文:
the target string, given as a std::basic_string
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
e -
正则表达式
原文:
the regular expression
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
flags -
使用的标志,以确定比赛将如何进行
原文:
flags used to determine how the match will be performed
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
类型要求
-
BidirIt 必须满足 BidirectionalIterator 的要求。

[编辑] 返回值

返回true如果存在匹配,false其他方式。无论在哪一种情况下,被更新的对象m,如下:
原文:
Returns true if a match exists, false otherwise. In either case, the object m is updated, as follows:
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
如果不存在匹配
原文:
If the match does not exist:
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m.ready() == true
m.empty() == true
m.size() == 0
如果匹配存在
原文:
If the match exists:
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m.ready() true
m.empty() false
m.size()
的子表达式数加1,即,1+e.mark_count()
原文:
number of subexpressions plus 1, that is, 1+e.mark_count()
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m.prefix().first first
m.prefix().second first
m.prefix().matched
false(匹配前缀为空)
原文:
false (the match prefix is empty)
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m.suffix().first last
m.suffix().second last
m.suffix().matched
false(匹配后缀是空的)
原文:
false (the match suffix is empty)
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m[0].first first
m[0].second last
m[0].matched
true(整个序列的匹配)
原文:
true (the entire sequence is matched)
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m[n].first
的序列,如果该子表达式匹配的子表达式n,或last没有参加比赛的开始
原文:
the start of the sequence that matched sub-expression n, or last if the subexpression did not participate in the match
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m[n].second
的序列,如果该子表达式匹配的子表达式n,或last没有参加比赛的结束
原文:
the end of the sequence that matched sub-expression n, or last if the subexpression did not participate in the match
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
m[n].matched
true如果子的表达式n参加的比赛中,false其他方式
原文:
true if sub-expression n participated in the match, false otherwise
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 示例

#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

[编辑] 另请参阅

正则表达式对象
(类模板) [编辑]
标识一个正则表达式匹配,包含所有子表达式匹配
(类模板) [编辑]