123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367 |
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
- <title>Options for POSIX Extended Regular Expressions</title>
- <link rel="stylesheet" href="../../../../../../../doc/src/boostbook.css" type="text/css">
- <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
- <link rel="home" href="../../../index.html" title="Boost.Regex 5.1.4">
- <link rel="up" href="../syntax_option_type.html" title="syntax_option_type">
- <link rel="prev" href="syntax_option_type_perl.html" title="Options for Perl Regular Expressions">
- <link rel="next" href="syntax_option_type_basic.html" title="Options for POSIX Basic Regular Expressions">
- </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="syntax_option_type_perl.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../syntax_option_type.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="syntax_option_type_basic.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
- </div>
- <div class="section">
- <div class="titlepage"><div><div><h4 class="title">
- <a name="boost_regex.ref.syntax_option_type.syntax_option_type_extended"></a><a class="link" href="syntax_option_type_extended.html" title="Options for POSIX Extended Regular Expressions">Options
- for POSIX Extended Regular Expressions</a>
- </h4></div></div></div>
- <p>
- Exactly one of the following must always be set for <a class="link" href="../../syntax/basic_extended.html" title="POSIX Extended Regular Expression Syntax">POSIX
- extended regular expressions</a>:
- </p>
- <div class="informaltable"><table class="table">
- <colgroup>
- <col>
- <col>
- <col>
- </colgroup>
- <thead><tr>
- <th>
- <p>
- Element
- </p>
- </th>
- <th>
- <p>
- Standardized
- </p>
- </th>
- <th>
- <p>
- Effect when set
- </p>
- </th>
- </tr></thead>
- <tbody>
- <tr>
- <td>
- <p>
- extended
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that the grammar recognized by the regular expression
- engine is the same as that used by POSIX extended regular expressions
- in IEEE Std 1003.1-2001, Portable Operating System Interface
- (POSIX ), Base Definitions and Headers, Section 9, Regular Expressions
- (FWD.1).
- </p>
- <p>
- Refer to the <a class="link" href="../../syntax/basic_extended.html" title="POSIX Extended Regular Expression Syntax">POSIX
- extended regular expression guide</a> for more information.
- </p>
- <p>
- In addition some perl-style escape sequences are supported (The
- POSIX standard specifies that only "special" characters
- may be escaped, all other escape sequences result in undefined
- behavior).
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- egrep
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that the grammar recognized by the regular expression
- engine is the same as that used by POSIX utility grep when given
- the -E option in IEEE Std 1003.1-2001, Portable Operating System
- Interface (POSIX ), Shells and Utilities, Section 4, Utilities,
- grep (FWD.1).
- </p>
- <p>
- That is to say, the same as <a class="link" href="../../syntax/basic_extended.html" title="POSIX Extended Regular Expression Syntax">POSIX
- extended syntax</a>, but with the newline character acting
- as an alternation character in addition to "|".
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- awk
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that the grammar recognized by the regular expression
- engine is the same as that used by POSIX utility awk in IEEE
- Std 1003.1-2001, Portable Operating System Interface (POSIX ),
- Shells and Utilities, Section 4, awk (FWD.1).
- </p>
- <p>
- That is to say: the same as <a class="link" href="../../syntax/basic_extended.html" title="POSIX Extended Regular Expression Syntax">POSIX
- extended syntax</a>, but with escape sequences in character
- classes permitted.
- </p>
- <p>
- In addition some perl-style escape sequences are supported (actually
- the awk syntax only requires \a \b \t \v \f \n and \r to be recognised,
- all other Perl-style escape sequences invoke undefined behavior
- according to the POSIX standard, but are in fact recognised by
- Boost.Regex).
- </p>
- </td>
- </tr>
- </tbody>
- </table></div>
- <p>
- The following options may also be set when using POSIX extended regular
- expressions:
- </p>
- <div class="informaltable"><table class="table">
- <colgroup>
- <col>
- <col>
- <col>
- </colgroup>
- <thead><tr>
- <th>
- <p>
- Element
- </p>
- </th>
- <th>
- <p>
- Standardized
- </p>
- </th>
- <th>
- <p>
- Effect when set
- </p>
- </th>
- </tr></thead>
- <tbody>
- <tr>
- <td>
- <p>
- icase
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that matching of regular expressions against a character
- container sequence shall be performed without regard to case.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- nosubs
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that when a regular expression is matched against a
- character container sequence, then no sub-expression matches
- are to be stored in the supplied <a class="link" href="../match_results.html" title="match_results"><code class="computeroutput"><span class="identifier">match_results</span></code></a> structure.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- optimize
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that the regular expression engine should pay more
- attention to the speed with which regular expressions are matched,
- and less to the speed with which regular expression objects are
- constructed. Otherwise it has no detectable effect on the program
- output. This currently has no effect for Boost.Regex.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- collate
- </p>
- </td>
- <td>
- <p>
- Yes
- </p>
- </td>
- <td>
- <p>
- Specifies that character ranges of the form <code class="computeroutput"><span class="special">[</span><span class="identifier">a</span><span class="special">-</span><span class="identifier">b</span><span class="special">]</span></code>
- should be locale sensitive. This bit is on by default for POSIX-Extended
- regular expressions, but can be unset to force ranges to be compared
- by code point only.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- newline_alt
- </p>
- </td>
- <td>
- <p>
- No
- </p>
- </td>
- <td>
- <p>
- Specifies that the \n character has the same effect as the alternation
- operator |. Allows newline separated lists to be used as a list
- of alternatives.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- no_escape_in_lists
- </p>
- </td>
- <td>
- <p>
- No
- </p>
- </td>
- <td>
- <p>
- When set this makes the escape character ordinary inside lists,
- so that <code class="computeroutput"><span class="special">[\</span><span class="identifier">b</span><span class="special">]</span></code> would match either '\' or 'b'.
- This bit is on by default for POSIX-Extended regular expressions,
- but can be unset to force escapes to be recognised inside lists.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- no_bk_refs
- </p>
- </td>
- <td>
- <p>
- No
- </p>
- </td>
- <td>
- <p>
- When set then backreferences are disabled. This bit is on by
- default for POSIX-Extended regular expressions, but can be unset
- to support for backreferences on.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- no_except
- </p>
- </td>
- <td>
- <p>
- No
- </p>
- </td>
- <td>
- <p>
- Prevents <a class="link" href="../basic_regex.html" title="basic_regex"><code class="computeroutput"><span class="identifier">basic_regex</span></code></a> from throwing
- an exception when an invalid expression is encountered.
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- save_subexpression_location
- </p>
- </td>
- <td>
- <p>
- No
- </p>
- </td>
- <td>
- <p>
- When set then the locations of individual sub-expressions within
- the <span class="emphasis"><em>original regular expression string</em></span> can
- be accessed via the <a class="link" href="../basic_regex.html#boost_regex.basic_regex.subexpression"><code class="computeroutput"><span class="identifier">subexpression</span><span class="special">()</span></code></a>
- member function of <code class="computeroutput"><span class="identifier">basic_regex</span></code>.
- </p>
- </td>
- </tr>
- </tbody>
- </table></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 © 1998-2013 John Maddock<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="syntax_option_type_perl.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../syntax_option_type.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="syntax_option_type_basic.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
- </div>
- </body>
- </html>
|