Regular Expressions

Regular expressions (REs), unlike simple text queries, allow you to search for text which matches a particular pattern.

Introduction

REs are similar to (but much more powerful than) the "wildcards" used in the command-line interfaces found in operating systems such as Unix and MS-DOS. REs are supported by sophisticated search engines, as well as by many Unix-based languages and tools ( e.g., awk, grep, lex, perl, and sed ).

Examples

%SEARCH{type="regex"}% also supports the ; and ! operators in regular expression searches.

• ; is used to indicate an "and" search. For example, Peace;War to search for topics matching the regular expressions Peace and War.
• ! is used to negate the sense of the following regular expression. For example, Peace;!War will find topics that match the expression Peace, but do not match the expression War.

The ";" and "!" operators are %SEARCH -specific and are not part of the standard regular expression syntax.

Use of Advanced Regular Expressions

Foswiki strives to support as much as possible of the Perl syntax for regular expressions. Be warned, though, that Foswiki only guarantees to support a subset of regular expression syntax, as documented in Foswiki:Development.RegularExpressions. This limitation is imposed by the third-party tools that Foswiki integrates with.

You can use more advanced features of Perl regular expressions, but your searches are not guaranteed to be supported on all Foswiki configurations, for example where a database store is in use and the database doesn't support the full Perl syntax for REs.

Related Links:

• http://perldoc.perl.org/perlretut.html - Regular expressions tutorial
• http://www.perl.com/doc/manual/html/pod/perlre.html - Perl regular expressions

Related Topics: UserDocumentationCategory