1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Function regex_match</title>
<link rel="stylesheet" href="../../boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="../../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
<link rel="up" href="../../xpressive/reference.html#header.boost.xpressive.regex_algorithms_hpp" title="Header <boost/xpressive/regex_algorithms.hpp>">
<link rel="prev" href="../../BOOST_PROTO_LOCAL_LIMITS.html" title="Macro BOOST_PROTO_LOCAL_LIMITS">
<link rel="next" href="regex_search.html" title="Function regex_search">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
<td align="center"><a href="../../../../index.html">Home</a></td>
<td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
<td align="center"><a href="../../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../../BOOST_PROTO_LOCAL_LIMITS.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../xpressive/reference.html#header.boost.xpressive.regex_algorithms_hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="regex_search.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="refentry" title="Function regex_match">
<a name="boost.xpressive.regex_match"></a><div class="titlepage"></div>
<div class="refnamediv">
<h2><span class="refentrytitle">Function regex_match</span></h2>
<p>boost::xpressive::regex_match — See if a regex matches a sequence from beginning to end. </p>
</div>
<h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2>
<div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis"><span class="emphasis"><em>// In header: <<a class="link" href="../../xpressive/reference.html#header.boost.xpressive.regex_algorithms_hpp" title="Header <boost/xpressive/regex_algorithms.hpp>">boost/xpressive/regex_algorithms.hpp</a>>
</em></span>
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> BidiIter>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(BidiIter begin, BidiIter end,
<a class="link" href="match_results.html" title="Struct template match_results">match_results</a>< BidiIter > & what,
<a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< BidiIter > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> BidiIter>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(BidiIter begin, BidiIter end,
<a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< BidiIter > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> Char>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(Char * begin, <a class="link" href="match_results.html" title="Struct template match_results">match_results</a>< Char * > & what,
<a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< Char * > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> BidiRange, <span class="bold"><strong>typename</strong></span> BidiIter>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(BidiRange & rng, <a class="link" href="match_results.html" title="Struct template match_results">match_results</a>< BidiIter > & what,
<a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< BidiIter > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default,
<span class="emphasis"><em>unspecified</em></span> = 0);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> BidiRange, <span class="bold"><strong>typename</strong></span> BidiIter>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(BidiRange <span class="bold"><strong>const</strong></span> & rng, <a class="link" href="match_results.html" title="Struct template match_results">match_results</a>< BidiIter > & what,
<a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< BidiIter > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default,
<span class="emphasis"><em>unspecified</em></span> = 0);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> Char>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(Char * begin, <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< Char * > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> BidiRange, <span class="bold"><strong>typename</strong></span> BidiIter>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(BidiRange & rng, <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< BidiIter > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default,
<span class="emphasis"><em>unspecified</em></span> = 0);
<span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> BidiRange, <span class="bold"><strong>typename</strong></span> BidiIter>
<span class="type"><span class="bold"><strong>bool</strong></span></span> regex_match(BidiRange <span class="bold"><strong>const</strong></span> & rng, <a class="link" href="basic_regex.html" title="Struct template basic_regex">basic_regex</a>< BidiIter > <span class="bold"><strong>const</strong></span> & re,
regex_constants::match_flag_type flags = regex_constants::match_default,
<span class="emphasis"><em>unspecified</em></span> = 0);</pre></div>
<div class="refsect1" title="Description">
<a name="id2115725"></a><h2>Description</h2>
<p>Determines whether there is an exact match between the regular expression <code class="computeroutput">re</code>, and all of the sequence <code class="computeroutput">[begin, end)</code>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term">Parameters:</span></p></td>
<td><div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><code class="computeroutput">begin</code></span></p></td>
<td><p>The beginning of the sequence. </p></td>
</tr>
<tr>
<td><p><span class="term"><code class="computeroutput">end</code></span></p></td>
<td><p>The end of the sequence. </p></td>
</tr>
<tr>
<td><p><span class="term"><code class="computeroutput">flags</code></span></p></td>
<td><p>Optional match flags, used to control how the expression is matched against the sequence. (See <code class="computeroutput">match_flag_type</code>.) </p></td>
</tr>
<tr>
<td><p><span class="term"><code class="computeroutput">re</code></span></p></td>
<td><p>The regular expression object to use </p></td>
</tr>
<tr>
<td><p><span class="term"><code class="computeroutput">what</code></span></p></td>
<td><p>The <code class="computeroutput">match_results</code> struct into which the sub_matches will be written </p></td>
</tr>
</tbody>
</table></div></td>
</tr>
<tr>
<td><p><span class="term">Requires:</span></p></td>
<td>
<p>Type <code class="computeroutput">BidiIter</code> meets the requirements of a Bidirectional Iterator (24.1.4). </p>
<p><code class="computeroutput">[begin,end)</code> denotes a valid iterator range. </p>
</td>
</tr>
<tr>
<td><p><span class="term">Returns:</span></p></td>
<td><p><code class="computeroutput">true</code> if a match is found, <code class="computeroutput">false</code> otherwise </p></td>
</tr>
<tr>
<td><p><span class="term">Throws:</span></p></td>
<td>
<a class="link" href="regex_error.html" title="Struct regex_error">regex_error</a> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright © 2007 Eric Niebler<p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
</p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="../../BOOST_PROTO_LOCAL_LIMITS.html"><img src="../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../../xpressive/reference.html#header.boost.xpressive.regex_algorithms_hpp"><img src="../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="regex_search.html"><img src="../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>
|