std::regex_match

来自cppreference.com
< cpp‎ | regex

该页由英文版wiki使用Google Translate机器翻译而来。

该翻译可能存在错误或用词不当。鼠标停留在文本上可以看到原版本。你可以帮助我们修正错误或改进翻译。参见说明请点击这里.

点击这里参见该页的英文版本

 
C++
 
正则表达式库
类
原文：
Classes
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
(C++11)
(C++11)
算法
原文：
Algorithms
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
regex_match
(C++11)
(C++11)
(C++11)
迭代器
原文：
Iterators
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
(C++11)
例外
原文：
Exceptions
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
性状
原文：
Traits
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
常量
原文：
Constants
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
(C++11)
(C++11)
(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.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
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

[编辑] 另请参阅

(C++11)
正则表达式对象
原文：
regular expression object
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(类模板) [编辑]
(C++11)
标识正则表达式的匹配结果，包含所有子表达式的匹配结果
原文：
identifies one regular expression match, including all sub-expression matches
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(类模板) [编辑]
来自“http://zh.cppreference.com/mwiki/index.php?title=cpp/regex/regex_match&oldid=38512”