boost_regex_说明文档资源-CSDN文库

boost

regex

4星 · 超过85%的资源需积分: 10 130 浏览量 2009-06-04 13:18:03 上传评论收藏 1.15MB PDF 举报

资源推荐

资源详情

资源评论

Boost.Regex

John Maddock

Distributed under the Boost Software License, Version 1.0. (See accompanying ﬁle LICENSE_1_0.txt or copy at ht-

tp://www.boost.org/LICENSE_1_0.txt)

Table of Contents

Conﬁguration ............................................................................................................................................................. 2

Compiler Setup ................................................................................................................................................... 2

Locale and traits class selection .............................................................................................................................. 3

Linkage Options .................................................................................................................................................. 3

Algorithm Selection ............................................................................................................................................. 3

Algorithm Tuning ................................................................................................................................................ 3

Building and Installing the Library .................................................................................................................................. 4

Introduction and Overview ............................................................................................................................................ 8

Unicode and Boost.Regex ............................................................................................................................................ 10

Understanding Marked Sub-Expressions and Captures ...................................................................................................... 11

Partial Matches .......................................................................................................................................................... 15

Regular Expression Syntax .......................................................................................................................................... 18

Perl Regular Expression Syntax ............................................................................................................................ 18

POSIX Extended Regular Expression Syntax .......................................................................................................... 27

POSIX Basic Regular Expression Syntax ................................................................................................................ 34

Character Class Names ....................................................................................................................................... 39

Character Classes that are Always Supported ................................................................................................... 39

Character classes that are supported by Unicode Regular Expressions .................................................................. 40

Collating Names ................................................................................................................................................ 42

Digraphs .................................................................................................................................................. 42

POSIX Symbolic Names ............................................................................................................................. 42

Named Unicode Characters .......................................................................................................................... 45

The Leftmost Longest Rule .................................................................................................................................. 45

Search and Replace Format String Syntax ....................................................................................................................... 46

Sed Format String Syntax .................................................................................................................................... 46

Perl Format String Syntax .................................................................................................................................... 47

Boost-Extended Format String Syntax .................................................................................................................... 48

Reference ................................................................................................................................................................. 49

basic_regex ....................................................................................................................................................... 49

match_results .................................................................................................................................................... 62

sub_match ........................................................................................................................................................ 68

regex_match ..................................................................................................................................................... 83

regex_search ..................................................................................................................................................... 87

regex_replace .................................................................................................................................................... 91

regex_iterator .................................................................................................................................................... 95

regex_token_iterator ......................................................................................................................................... 101

bad_expression ................................................................................................................................................ 109

syntax_option_type ........................................................................................................................................... 110

syntax_option_type Synopsis ...................................................................................................................... 110

Overview of syntax_option_type ................................................................................................................. 110

XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/

Options for Perl Regular Expressions ........................................................................................................... 111

Options for POSIX Extended Regular Expressions ......................................................................................... 112

Options for POSIX Basic Regular Expressions ............................................................................................... 113

Options for Literal Strings .......................................................................................................................... 114

match_ﬂag_type .............................................................................................................................................. 115

error_type ....................................................................................................................................................... 117

regex_traits ..................................................................................................................................................... 118

Interfacing With Non-Standard String Types .......................................................................................................... 119

Working With Unicode and ICU String Types ................................................................................................ 119

Introduction to using Regex with ICU .................................................................................................. 119

Unicode regular expression types ........................................................................................................ 119

Unicode Regular Expression Algorithms ............................................................................................... 121

Unicode Aware Regex Iterators ........................................................................................................... 123

Using Boost Regex With MFC Strings .......................................................................................................... 129

Introduction to Boost.Regex and MFC Strings ....................................................................................... 129

Regex Types Used With MFC Strings ................................................................................................... 129

Regular Expression Creation From an MFC String ................................................................................. 130

Overloaded Algorithms For MFC String Types ....................................................................................... 130

Iterating Over the Matches Within An MFC String .................................................................................. 133

POSIX Compatible C API's ................................................................................................................................ 135

Concepts ........................................................................................................................................................ 138

charT Requirements .................................................................................................................................. 138

Traits Class Requirements .......................................................................................................................... 139

Iterator Rrequirements ............................................................................................................................... 141

Deprecated Interfaces ........................................................................................................................................ 141

regex_format (Deprecated) ......................................................................................................................... 141

regex_grep (Deprecated) ............................................................................................................................ 142

regex_split (deprecated) ............................................................................................................................. 148

High Level Class RegEx (Deprecated) .......................................................................................................... 150

Background Information ............................................................................................................................................ 156

Headers .......................................................................................................................................................... 156

Localization .................................................................................................................................................... 157

Thread Safety .................................................................................................................................................. 162

Test and Example Programs ............................................................................................................................... 163

References and Further Information ..................................................................................................................... 164

FAQ ............................................................................................................................................................... 165

Performance .................................................................................................................................................... 166

Standards Conformance ..................................................................................................................................... 166

Redistributables ............................................................................................................................................... 168

Acknowledgements .......................................................................................................................................... 168

History ........................................................................................................................................................... 169

Configuration

Compiler Setup

You shouldn't need to do anything special to conﬁgure Boost.Regex for use with your compiler - the Boost.Conﬁg subsystem should

already take care of it, if you do have problems (or you are using a particularly obscure compiler or platform) then Boost.Conﬁg has a

conﬁgure script that you can run.

Boost.Regex

XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/

Locale and traits class selection

The following macros (see user.hpp) control how Boost.Regex interacts with the user's locale:

descriptionmacro

Forces Boost.Regex to use the global C locale in its traits class support: this is now de-

precated in favour of the C++ locale.

BOOST_REGEX_USE_C_LOCALE

Forces Boost.Regex to use std::locale in it's default traits class, regular expressions can

then be imbued with an instance speciﬁc locale. This is the default behaviour on non-

Windows platforms.

BOOST_REGEX_USE_CPP_LOCALE

Tells Boost.Regex not to use any Win32 API's even when available (implies

BOOST_REGEX_USE_CPP_LOCALE unless BOOST_REGEX_USE_C_LOCALE is

set).

BOOST_REGEX_NO_W32

Linkage Options

descriptionmacro

For Microsoft and Borland C++ builds, this tells Boost.Regex that it should link to the dll build

of the Boost.Regex. By default boost.regex will link to its static library build, even if the dynamic

C runtime library is in use.

BOOST_REGEX_DYN_LINK

For Microsoft and Borland C++ builds, this tells Boost.Regex that it should not automatically select

the library to link to.

BOOST_REGEX_NO_LIB

Algorithm Selection

descriptionmacro

Tells Boost.Regex to use a stack-recursive matching algorithm. This is generally the fastest

option (although there is very little in it), but can cause stack overﬂow in extreme cases, on

Win32 this can be handled safely, but this is not the case on other platforms.

BOOST_REGEX_RECURSIVE

Tells Boost.Regex to use a non-stack recursive matching algorithm, this can be slightly slower

than the alternative, but is always safe no matter how pathological the regular expression. This

is the default on non-Win32 platforms.

BOOST_REGEX_NON_RECURS-

IVE

Algorithm Tuning

The following option applies only if BOOST_REGEX_RECURSIVE is set.

descriptionmacro

Tells Boost.Regex that Microsoft style __try - __except blocks are supported,

and can be used to safely trap stack overﬂow.

BOOST_REGEX_HAS_MS_STACK_GUARD

Boost.Regex

XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/

The following options apply only if BOOST_REGEX_NON_RECURSIVE is set.

descriptionmacro

In non-recursive mode, Boost.Regex uses largish blocks of memory to act as a stack

for the state machine, the larger the block size then the fewer allocations that will

BOOST_REGEX_BLOCKSIZE

take place. This defaults to 4096 bytes, which is large enough to match the vast ma-

jority of regular expressions without further allocations, however, you can choose

smaller or larger values depending upon your platforms characteristics.

Tells Boost.Regex how many blocks of size BOOST_REGEX_BLOCKSIZE it is

permitted to use. If this value is exceeded then Boost.Regex will stop trying to ﬁnd

BOOST_REGEX_MAX_BLOCKS

a match and throw a std::runtime_error. Defaults to 1024, don't forget to tweek this

value if you alter BOOST_REGEX_BLOCKSIZE by much.

Tells Boost.Regex how many memory blocks to store in it's internal cache - memory

blocks are taken from this cache rather than by calling ::operator new. Generally

BOOST_REGEX_MAX_CACHE_BLOCKS

speeking this can be an order of magnitude faster than calling ::opertator new each

time a memory block is required, but has the downside that Boost.Regex can end up

caching a large chunk of memory (by default up to 16 blocks each of

BOOST_REGEX_BLOCKSIZE size). If memory is tight then try deﬁning this to 0

(disables all caching), or if that is too slow, then a value of 1 or 2, may be sufﬁcient.

On the other hand, on large multi-processor, multi-threaded systems, you may ﬁnd

that a higher value is in order.

Building and Installing the Library

When you extract the library from its zip ﬁle, you must preserve its internal directory structure (for example by using the -d option when

extracting). If you didn't do that when extracting, then you'd better stop reading this, delete the ﬁles you just extracted, and try again!

This library should not need conﬁguring before use; most popular compilers/standard libraries/platforms are already supported "as is".

If you do experience conﬁguration problems, or just want to test the conﬁguration with your compiler, then the process is the same as

for all of boost; see the conﬁguration library documentation.

The library will encase all code inside namespace boost.

Unlike some other template libraries, this library consists of a mixture of template code (in the headers) and static code and data (in cpp

ﬁles). Consequently it is necessary to build the library's support code into a library or archive ﬁle before you can use it, instructions for

speciﬁc platforms are as follows:

Building with bjam

This is now the preferred method for building and installing this library, please refer to the getting started guide for more information.

Building With Unicode and ICU Support

A default build of this library does not enable Unciode support via ICU. There is no need to enable this support if you don't need it, but

if you use ICU for your Unicode support already, and want to work with Unicode-aware regular expressions then read on.

Most of the information you will need is in the getting started guide, the only additional step you need to take is to tell bjam that you

want Boost.Regex to use ICU and optionally to tell bjam where ICU is located.

Boost.Regex

XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/

If you're building on a Unix-like platform, and ICU is already installed in you're compilers search path (with an install preﬁx of /usr

or /usr/local for example), then set the environment variable HAVE_ICU to enable ICU support. For example you might build with

the command line:

bjam -sHAVE_ICU=1 --toolset=toolset-name install

If ICU is not already in your compiler's path then you need to set the environment variable ICU_PATH to point to the root directory of

your ICU installation, for example if ICU was installed to /usr/local/icu/3.3 you might use:

bjam -sICU_PATH=/usr/local/icu/3.3 --toolset=toolset-name install

Note that ICU is a C++ library just like Boost is, as such your copy of ICU must have been built with the same C++ compiler (and

compiler version) that you are using to build Boost. Boost.Regex will not work correctly unless you ensure that this is the case: it is up

to you to ensure that the version of ICU you are using is binary compatible with the toolset you use to build Boost.

Building via makefiles

Borland C++ Builder:

•

Open up a console window and change to the <boost>\libs\regex\build directory.

• Select the appropriate makeﬁle (bcb4.mak for C++ Builder 4, bcb5.mak for C++ Builder 5, and bcb6.mak for C++ Builder 6).

• Invoke the makeﬁle (pass the full path to your version of make if you have more than one version installed, the makeﬁle relies on the

path to make to obtain your C++ Builder installation directory and tools) for example:

make -fbcb5.mak

The build process will build a variety of .lib and .dll ﬁles (the exact number depends upon the version of Borland's tools you are using)

the .lib and dll ﬁles will be in a sub-directory called bcb4 or bcb5 depending upon the makeﬁle used. To install the libraries into your

development system use:

make -fbcb5.mak install

library ﬁles will be copied to <BCROOT>/lib and the dll's to <BCROOT>/bin, where <BCROOT> corresponds to the install path of

your Borland C++ tools.

You may also remove temporary ﬁles created during the build process (excluding lib and dll ﬁles) by using:

make -fbcb5.mak clean

Finally when you use Boost.Regex it is only necessary for you to add the <boost> root director to your list of include directories for

that project. It is not necessary for you to manually add a .lib ﬁle to the project; the headers will automatically select the correct .lib ﬁle

for your build mode and tell the linker to include it. There is one caveat however: the library can not tell the difference between VCL

and non-VCL enabled builds when building a GUI application from the command line, if you build from the command line with the 5.5

command line tools then you must deﬁne the pre-processor symbol _NO_VCL in order to ensure that the correct link libraries are selected:

the C++ Builder IDE normally sets this automatically. Hint, users of the 5.5 command line tools may want to add a -D_NO_VCL to

bcc32.cfg in order to set this option permanently.

If you would prefer to do a dynamic link to the regex libraries when using the dll runtime then deﬁne BOOST_REGEX_DYN_LINK

(you must do this if you want to use Boost.Regex in multiple dll's), otherwise Boost.Regex will be statically linked by default.

Boost.Regex

XML to PDF by RenderX XEP XSL-FO Formatter, visit us at http://www.renderx.com/

剩余169页未读，继续阅读

评论收藏

内容反馈

yunsicai

2012-11-22

全是英文，没看懂！
香草天空

2014-04-08

还是有一定参考价值的

cbwxl

粉丝: 0
资源: 1

boost_regex_说明文档

boost regex帮助文档

boost_1_42 官方说明文档

Linux+boost+python3+gcc编译说明文档1

win7+boost+python3+vs2010编译说明文档1

boost_regex-vc80-mt-1_34.lib

boost_regex.dll

boost_regex-vc6-1_37

boost_regex-vc80-mt-1_34.dll

boost_1_49_0

boost_regex_only_1_34_0.rar

boost_regex_only3file_1_34_0.rar

qt编译boost_1_69库

Boost_Regex_C_正则表达式快速入门.pdf

libboost_regex.zip

db2-正则表达式.zip

libboost_regex-vc90-mt-s-1_53.lib

boost_1_34_0的包含文件（boost目录下的全部文件）

VC正则表达式编译文件（boost1.33.1——Regex库）

boost-regex-1.41.0-11.el6_1.2.i686.rpm

boost_1.34库及VC6下使用此库

boost.regex手册

C#_Regex_深入正则表达式.doc

libboost_regex-vc80-mt-sgd-1_34.lib

Qt 5实现串口调试助手 （源工程文件、0积分下载）

【SystemVerilog】路科验证V2学习笔记（全600页）.pdf

AutoSAR标准协议4.2.2

光伏-储能并网系统仿真.rar

NPPJSONViewer.zip

GD32替换STM32注意事项.pdf

最新资源

Qt 5实现串口调试助手（源工程文件、0积分下载）