QRegExp Class

詳細説明

このクラスは Qt 6 では非推奨です。新しいコードにはQRegularExpression を使用してください。QRegExp からQRegularExpression への古いコードの移植に関するガイドラインについては、{QRegularExpression への移植 } を参照してください。

正規表現（regexp）は、テキストの部分文字列をマッチさせるためのパターンです。これは多くの文脈で有用である、

正規表現についての簡単な紹介、Qt の正規表現言語の説明、いくつかの例、そして関数のドキュメントがあります。QRegExp は Perl の正規表現言語をモデルにしています。Unicode を完全にサポートしています。QRegExpは、コマンドシェルに見られる機能に似た、より単純なワイルドカードモードで使用することもできます。QRegExpが使用する構文規則は、setPatternSyntax()で変更することができます。QRegExp::FixedStringこれは、マッチするパターンがプレーン文字列として解釈されることを意味し、特殊文字（バックスラッシュなど）はエスケープされません。

正規表現に関する優れたテキストは、Jeffrey E. F. Friedl著「Mastering Regular Expressions(Third Edition)」ISBN 0-596-52812-4です。

はじめに

正規表現は式、量化子、アサーションから構成されます。最も単純な式は文字で、例えばxや5 です。式は角括弧で囲まれた文字の集合であることもあります。[ABCD]はA、B、C、Dにマッチします。これと同じ式を[A-D]と書くことができ、英語のアルファベットの大文字にマッチする式は[A-Z]と書かれます。

x{1,1}は、1つのxだけにマッチすることを意味します。x{1,5}は、少なくとも1つのxを含み、5つ以下のx文字のシーケンスにマッチすることを意味します。

一般に正規表現では、バランスの取れた括弧やタグをチェックすることはできない。例えば、<b> タグが入れ子になっていない場合、<b> を開き、</b> を閉じる正規表現を書くことができますが、<b> タグが入れ子になっている場合、同じ正規表現は<b> を開き、</b> を閉じるタグにマッチします。フラグメント<b>bold <b>bolder</b></b> の場合、最初の<b> は最初の</b> とマッチすることになり、これは正しくない。しかし、入れ子になった括弧やタグに正しくマッチする正規表現を書くことは可能である。入れ子の数が固定で既知でない場合、失敗しない正規表現を書くことは不可能である。

少なくとも1桁は必要なので、1桁にちょうど1回マッチする[0-9]{1,1}式から始めます。この正規表現は0から9までの整数にマッチします。99までの整数にマッチするには、最大出現回数を2回に増やし、正規表現は[0-9]{1,2}となります。この正規表現は、0から99までの整数にマッチするという本来の要件を満たしますが、文字列の途中で発生する整数にもマッチします。マッチする整数を文字列全体にしたい場合は、アンカー・アサーション^(キャレット) と$(ドル) を使わなければならない。正規表現の最初の文字が^の場合は、正規表現が文字列の先頭からマッチすることを意味する。が正規表現 の最後の文字である場合、正規表現は文字列の最後までマッチしなければならな いことを意味する。正規表現は^[0-9]{1,2}$ となる。アサーション、例えば^や$ は、文字にマッチするのではなく、文字列の中の場所にマッチすることに 注意。

他の場所で正規表現について説明されているのを見たことがある場合、ここで 示されているものとは違って見えるかもしれない。これは、いくつかの文字の集合やいくつかの量 子は非常に一般的であるため、それらを表現するために特別な記号が与えられて いるからです。0-9]は記号[d]で置き換えることができます。つまり、x{1,1}はx と同じです。したがって、0から99までのマッチャーは^d{1,2}$と書くことができます。また、^dd{0,1}$とも書ける。つまり、文字列の先頭から1桁をマッチし、すぐ に0桁か1桁をマッチする。実際には、^d?$と書く。は量化子{0,1}の省略形である。は式を省略可能にする。正規表現^dd?$は、文字列の先頭から1桁マッチし、すぐに0桁または1桁追加され、 すぐに文字列が終了することを意味する。

例えば、'email'、'mailman'、'mailer'、'letterbox'などである。完全に表現すると、正規表現はm{1,1}a{1,1}i{1,1}l{1,1}ですが、文字表現は自動的に{1,1}で定量化されるので、正規表現を単純化してmail、すなわち、'm'の後に'a'が続き、その後に'i'が続き、その後に'l'が続く、とすることができます。これで、縦棒｜（または）を使って他の2つの単語を含めることができるので、3つの単語のいずれかにマッチする正規表現はmail|letter|correspondenceとなる。mail」または「letter」または「correspondence」にマッチする。この正規表現はマッチさせたい3つの単語のいずれかにマッチしますが、マッチさせたくない単語、たとえば'email'にもマッチします。正規表現が不要な単語にマッチしないようにするには、単語の境界でマッチを開始・終了するように指示しなければならない。まず正規表現を括弧で囲み、(mail|letter|correspondence)とします。括弧は式をグループ化し、capture 。括弧で式を囲むことで、より複雑な正規表現の構成要素として使用することができます。また、3つの単語のどれが実際にマッチしたかを調べることもできる。マッチの開始と終了を単語の境界で強制的に行うために、正規表現を♪b word boundaryassertions で囲みます：\b(mail|letter|correspondence)。これで正規表現が意味するのは単語境界にマッチし、その後に括弧内の正規表現が続き、その後に単語境界が続く。\bアサーションは、文字ではなく正規表現内の位置にマッチします。単語境界とは、スペース、改行、文字列の先頭または末尾など、単語以外の文字のことです。

アンパサンド文字をHTMLエンティティ&で置き換えたい場合、マッチする正規表現は単純に&です。しかしこの正規表現は、すでにHTMLエンティティに変換されているアンパサンドにもマッチします。まだamp;がついていないアンパサンドだけを置換したいのです。そのためには、(?!__)という負のルックアヘッド・アサーションが必要です。正規表現は、&(?!amp;)、つまり、amp;がついて いない アンパサンドにマッチする、と書くことができる。

Eric'と'Eirik'の出現を文字列の中ですべて数えたい場合、2つの有効な解は、'Eric|Eirik'˶と'Ei?ri[ck]˶'です。単語境界アサーション'˶'は、'Ericsson'など、どちらかの名前を含む単語とのマッチングを避けるために必要です。2番目の正規表現は、'Eric'、'Erik'、'Eiric'、'Eirik'など、必要以上に多くのスペルにマッチすることに注意してください。

上述した例のいくつかは、code examples セクションに実装されている。

文字集合の文字と省略形

注意:C++ コンパイラは文字列内のバックスラッシュを変換します。\\正規表現にバックスラッシュを含めるには、バックスラッシュを2回入力します。\\\\バックスラッシュ文字そのものにマッチさせるには、4 回入力します。

文字のセット

角括弧は、角括弧に含まれるすべての文字にマッチすることを意味する。上述した文字セットの省略形は、角括弧の中の文字セットに含めることができる。文字セットの省略形と以下の2つの例外を除いて、文字は角括弧の中で特別な意味を持ちません。

定義済みの文字セットの略語を使う方が、プラットフォームや言語間で文字範囲を使うよりも移植性が高い。例えば、[0-9]は西洋のアルファベットの数字にマッチしますが、"˶" は どのアルファベットの数字にもマッチします。

注意: 他の正規表現文書では、文字の集合はしばしば "文字クラス "と呼ばれます。

量記号

デフォルトでは、式は自動的に{1,1}で量化されます。以下のリストでは、Eはexpressionを表します。式は文字、または文字の集合の省略形、または角括弧内の文字の集合、または括弧内の式です。

直前の文字以上に量化子を適用するには、括弧を使って文字をグループ化します。たとえば、tag+は、't'の後に'a'が続き、その後に少なくとも1つの'g'が続く場合にマッチし、(tag)+は、少なくとも1つの'tag'が出現する場合にマッチする。

注意：量化子は通常「欲張り」である。常にできる限り多くのテキストにマッチする。例えば、0+は、最初に見つけたゼロと、最初のゼロの後に連続するすべてのゼロにマッチします。20005'に適用すると、'20005'にマッチします。量化子は、setMinimal() を参照。

テキストのキャプチャ

括弧を使うと、要素をグループ化して定量化したりキャプチャしたりすることができます。たとえば、mail|letter|correspondenceという式が文字列にマッチした場合、どれかの単語がマッチしたことはわかりますが、どれがマッチしたかはわかりません。そのため、(mail|letter|correspondence)を使ってこの正規表現と "I sent you some email" という文字列をマッチさせた場合、cap() やcapturedTexts() 関数を使ってマッチした文字、この場合は 'mail' を抽出することができます。

キャプチャしたテキストは正規表現内で使用することができます。キャプチャしたテキストを参照するには、cap （）と同じように、1 からインデックス付けされる後方参照を使用します。これは、単語境界、1つ以上の単語文字、1つ以上の非単語文字、最初の括弧で囲まれた式 と同じテキスト、単語境界の順にマッチすることを意味します。

もし括弧を純粋にグループ分けのために使い、キャプチャーのために使いたくない場合は、例えば(?:green|blue)のように、キャプチャーのない構文を使うことができます。捕捉しない括弧は'(?:'で始まり、')'で終わります。この例では'green'か'blue'のどちらかにマッチしますが、マッチをキャプチャしないので、マッチしたかどうかだけがわかり、実際にどの色を見つけたかはわかりません。キャプチャしない括弧を使う方が、キャプチャする括弧を使うよりも、正規表現エンジンが帳簿を管理する手間が省けるので効率的です。

キャプチャする括弧もしない括弧も入れ子にすることができます。

歴史的な理由から、捕捉括弧に適用される量化子（*など）は、他の量化子よりも「貪欲」である。例えば、a*(a*)は、cap(1) == "aaa "で "aaa "にマッチする。この動作は、他の正規表現エンジン（特にPerl）が行う動作とは異なります。より直感的な捕捉動作を得るには、QRegExpコンストラクタにQRegExp::RegExp2 を指定するか、setPatternSyntax(QRegExp::RegExp2) を呼び出します。

マッチの数が事前に決定できない場合、一般的なイディオムは、ループ内でcap() を使用することです。例えば

QRegExp rx("(\\d+)");
QString str = "Offsets: 12 14 99 231 7";
QStringList list;
int pos = 0;

while ((pos = rx.indexIn(str, pos)) != -1) {
    list << rx.cap(1);
    pos += rx.matchedLength();
}
// list: ["12", "14", "99", "231", "7"]

アサーション

アサーションは正規表現で出現する箇所でテキストについて何らかのステートメントを行いますが、いかなる文字にもマッチしません。以下のリストでは、Eは任意の式を表します。

ワイルドカード・マッチング

bashや cmd.exeのようなほとんどのコマンドシェルは、ワイルドカードを使用してファイルのグループを識別する機能である「ファイルグロビング」をサポートしています。正規表現モードとワイルドカード・モードを切り替えるには、setPatternSyntax （）関数を使用する。ワイルドカード・マッチングは完全な正規表現よりもはるかに単純で、4つの機能しかない：

ワイルドカードモードでは、ワイルドカード文字はエスケープできません。モードWildcardUnix では、文字 ' \' はワイルドカードをエスケープします。

例えば、ワイルドカード・モードで、ファイル名を含む文字列がある場合、*.htmlでHTMLファイルを識別することができる。これは、0個以上の文字の後にドットが続き、その後に'h'、't'、'm'、'l'が続く場合にマッチする。

文字列をワイルドカード表現と照合するには、exactMatch （）を使用する。例えば

QRegExp rx("*.txt");
rx.setPatternSyntax(QRegExp::Wildcard);
rx.exactMatch("README.txt");        // returns true
rx.exactMatch("welcome.txt.bak");   // returns false

Perlユーザーのためのメモ

characters and abbreviations for sets of charactersPerl でサポートされている文字クラスの省略形のほとんどは QRegExp でサポートされています。

QRegExpでは、文字クラス内を除けば、^ は常に文字列の開始を意味するので、キャレットはその目的で使用されない限り、常にエスケープされなければなりません。Perlでは、キャレットが出現する場所によって自動的に意味が変わるので、キャレットをエスケープする必要はほとんどありません。QRegExpでは常に文字列の終わりを意味する$ 。

QRegExpの量化子はPerlの貪欲な量化子と同じです（ただし、note above を参照してください）。非貪欲マッチングは個々の量子に適用することはできませんが、パターン内のすべての量子に適用することができます。例えば、Perlの正規表現ro+?

QRegExp rx("ro+m");
rx.setMinimal(true);

Perlの/i オプションに相当するのはsetCaseSensitivity(Qt::CaseInsensitive) です。

Perlの/g オプションは、loop を使ってエミュレートできます。

QRegExp の. は任意の文字にマッチするので、すべての QRegExp 正規表現は Perl の/s オプションと等価です。QRegExpにはPerlの/m オプションに相当するものはありませんが、入力を行に分割したり、改行を検索する正規表現でループさせるなど、様々な方法でエミュレートすることができます。

QRegExp は文字列指向なので、˶A、˶Z、˶zアサーションはありません。をエミュレートすることができます。

Perl の $& は cap(0) またはcapturedTexts()[0] です。QRegExpには$`、$'、$+に相当するものはありません。Perl のキャプチャ変数 $1, $2, ... は、cap(1) またはcapturedTexts()[1], cap(2) またはcapturedTexts()[2] などに対応します。

パターンを代入するには、QString::replace() を使用します。

Perlの拡張/x 構文はサポートされていません。また、(?i)などのディレクティブや、(?#comment)などの正規表現コメントもサポートされていません。一方、C++のリテラル文字列の規則を使えば、同じことができます：

QRegExp mark("\\b"      // word boundary
              "[Mm]ark" // the word we want to match
            );

Perlと同じ構文で、ゼロ幅の正のルックアヘッド・アサーション（?=pattern）とゼロ幅の負のルックアヘッド・アサーション（?Perl の lookbehind アサーション、"独立 "部分式、条件式はサポートされていません。

キャプチャしない括弧も、同じ (?:pattern) 構文でサポートされています。

Perlのsplit関数とjoin関数に相当するものについては、QString::split()とQStringList::join()を参照してください。

注：C++は、"˶"を2回変換するので、"˶"は"˶b "と書く必要があります。

コード例

QRegExp rx("^\\d\\d?$");    // match integers 0 to 99
rx.indexIn("123");          // returns -1 (no match)
rx.indexIn("-6");           // returns -1 (no match)
rx.indexIn("6");            // returns 0 (matched at position 0)

3番目の文字列は'6'にマッチします。これは 0 から 99 までの整数に対する単純な検証正規表現です。

QRegExp rx("^\\S+$");       // match strings without whitespace
rx.indexIn("Hello world");  // returns -1 (no match)
rx.indexIn("This_is-OK");   // returns 0 (matched at position 0)

番目の文字列は'This_is-OK'にマッチする。空白を含まない文字列にマッチするように、文字セットの省略形 '˶S'(空白なし)とアンカーを使用しています。

以下の例では、'mail'、'letter'、'correspondence'を含む文字列にマッチしますが、単語全体にのみマッチします。

QRegExp rx("\\b(mail|letter|correspondence)\\b");
rx.indexIn("I sent you an email");     // returns -1 (no match)
rx.indexIn("Please write the letter"); // returns 17

2番目の文字列は、"Please write theletter"にマッチする。letter'という単語も捕捉されます（括弧があるため）。このように、どのようなテキストをキャプチャしたかを見ることができる：

QString captured = rx.cap(1); // captured == "letter"

これは、最初にキャプチャした括弧からテキストをキャプチャします（キャプチャした左の括弧を左から右に数えます）。cap(0)はマッチした正規表現全体（ほとんどの正規表現エンジンでは'&'に相当）なので、括弧は1から数えます。

QRegExp rx("&(?!amp;)");      // match ampersands but not &
QString line1 = "This & that";
line1.replace(rx, "&");
// line1 == "This & that"
QString line2 = "His & hers & theirs";
line2.replace(rx, "&");
// line2 == "His & hers & theirs"

ここでは、QString の replace() 関数に QRegExp を渡して、マッチしたテキストを新しいテキストに置き換えています。

QString str = "One Eric another Eirik, and an Ericsson. "
              "How many Eiriks, Eric?";
QRegExp rx("\\b(Eric|Eirik)\\b"); // match Eric or Eirik
int pos = 0;    // where we are in the string
int count = 0;  // how many Eric and Eirik's we've counted
while (pos >= 0) {
    pos = rx.indexIn(str, pos);
    if (pos >= 0) {
        ++pos;      // move along in str
        ++count;    // count our Eric or Eirik
    }
}

indexIn() 関数を使って、文字列中の正規表現に繰り返しマッチさせています。pos++ 、1文字ずつ先に進むのではなく、pos += rx.matchedLength() 、すでにマッチした文字列をスキップするように書くこともできる。カウントは3になり、「エリックが一人、エイリークがもう一人、エリクソンが一人」とマッチする。Eiriks、Ericは何人でしょう？'にマッチする。'Ericsson'や'Eiriks'には単語以外の境界がないのでマッチしない。

正規表現の一般的な使い方の1つは、区切りデータの行をそれぞれのフィールドに分割することである。

str = "The Qt Company Ltd\tqt.io\tFinland";
QString company, web, country;
rx.setPattern("^([^\t]+)\t([^\t]+)\t([^\t]+)$");
if (rx.indexIn(str) != -1) {
    company = rx.cap(1);
    web = rx.cap(2);
    country = rx.cap(3);
}

この例では、入力行は会社名、ウェブアドレス、国という形式になっている。これ以上フィールドを増やすとコードが壊れてしまう。もっとシンプルで良い解決策は、区切り文字、この例では'˶'を探して、その周りのテキストを取ることです。QString::split （）関数は、区切り文字列または正規表現を引数として取り、それに応じて文字列を分割することができます。

QStringList field = str.split("\t");

ここでは、field[0]が会社、field[1]がウェブ・アドレス、といった具合だ。

シェルのマッチングを模倣するには、ワイルドカード・モードを使用します。

QRegExp rx("*.html");
rx.setPatternSyntax(QRegExp::Wildcard);
rx.exactMatch("index.html");                // returns true
rx.exactMatch("default.htm");               // returns false
rx.exactMatch("readme.txt");                // returns false

ワイルドカード・マッチングは単純なので便利だが、どのようなワイルドカード 正規表現も完全正規表現を使って定義できる。test.html.bak'にもマッチする*.htm*を使わない限り、ワイルドカードで.html と.htm の両方のファイルにマッチさせることはできない。完全な正規表現を使えば、必要な精度が得られる。

QRegExpはsetCaseSensitivity()を使って大文字小文字を区別せずにマッチさせることができます。また、setMinimal()を参照して、非貪欲なマッチングを使うこともできます。デフォルトではQRegExpは完全正規表現を使用しますが、これはsetPatternSyntax()で変更できます。検索は、indexIn() で前方検索、lastIndexIn() で後方検索が可能です。キャプチャされた文字列には、capturedTexts() を使用してアクセスすることができます。 () は、キャプチャされたすべての文字列のリストを返し、cap() は、指定されたインデックスのキャプチャ文字列を返します。pos() 関数は、マッチしたインデックスを受け取り、マッチした文字列の位置を返す (マッチしなかった場合は -1)。

QRegularExpression への移植

Qt 5 で導入されたQRegularExpression クラスは Perl 互換の正規表現を実装しており、提供される API、サポートされるパターン構文、実行速度の点で QRegExp を大きく改善しています。最大の違いは、QRegularExpression は単に正規表現を保持するだけで、マッチが要求されても変更されないことです。代わりに、QRegularExpressionMatch オブジェクトが返され、マッチの結果をチェックし、キャプチャされた部分文字列を抽出します。グローバル・マッチングやQRegularExpressionMatchIterator も同様です。

その他の違いの概要は以下のとおりです。

異なるパターン構文

正規表現を QRegExp からQRegularExpression に移植する場合、パターン自体の変更が必要になることがあります。

特定のシナリオでは、QRegExpは甘すぎて、QRegularExpression を使用するときに単に無効なパターンを受け入れていました。これらのパターンを使って構築されたQRegularExpression オブジェクトは無効なので、これを検出するのは簡単です（QRegularExpression::isValid （）を参照）。

また、QRegExpからQRegularExpression に移植されたパターンが、無言のうちにセマンティクスを変更している場合もあります。したがって、使用するパターンを見直す必要がある。サイレント非互換性の最も顕著なケースは以下のとおりです：

• \xHHHH のような2桁以上の16進数エスケープを使用するには、中括弧が必要です。\x2022 のようなパターンは、\x{2022} に移植する必要がある。さもないと、スペース（0x20 ）の後に文字列"22" が続くパターンにマッチしてしまう。一般に、桁数に関係なく、\x のエスケープには中括弧を使うことを強く推奨します。
• {,n} のような0対nの数量化は、セマンティクスを保持するために{0,n} に移植する必要がある。そうでないと、\d{,3} のようなパターンは、数字に続く正確な文字列"{,3}" にマッチしてしまいます。
• QRegExpはデフォルトでUnicodeを意識したマッチングを行いますが、QRegularExpression は別のオプションが必要です。
• QRegExpのc{.}は、デフォルトで改行文字を含むすべての文字にマッチします。QRegularExpression は、デフォルトで改行文字を除外します。改行文字を含めるには、QRegularExpression::DotMatchesEverythingOption patternオプションを設定します。

QRegularExpression でサポートされている正規表現構文の概要については、PCRE（Perl互換正規表現のリファレンス実装）でサポートされているパターン構文について説明したpcrepattern(3)man ページを参照してください。

QRegExp::exactMatch() からの移植

QRegExp::exactMatch() は二つの目的を果たしました: 正規表現と対象文字列を正確にマッチさせることと、 部分マッチを実装することです。

QRegExp の完全一致からの移植

完全マッチングは、正規表現が対象文字列全体にマッチするかどうかを示します。例えば、"abc123" ：

完全一致はQRegularExpression には反映されません。 subject 文字列が正規表現に完全に一致することを確認したい場合は、QRegularExpression::anchoredPattern() 関数を使用してパターンをラップします：

QString p("a .*|pattern");

// re matches exactly the pattern string p
QRegularExpression re(QRegularExpression::anchoredPattern(p));

QRegExpの部分マッチングからの移植

QRegExp::exactMatch()を使用する場合、完全一致が見つからなくても、QRegExp::matchedLength()を呼び出すことで、対象文字列が正規表現にどれだけ一致したかを調べることができます。返された長さが対象文字列の長さと等しい場合、部分一致が見つかったと結論づけることができます。

QRegularExpression は、適切な を使って部分一致を明示的にサポートしています。QRegularExpression::MatchType

グローバル・マッチング

QRegExp APIの制限により、グローバルマッチングを正しく（つまりPerlのように）実装することは不可能でした。特に、（"a*" のような）0 文字にマッチするパターンは問題です。

QRegularExpression::globalMatch() は Perl のグローバルマッチを正しく実装しており、返されるイテレータを使って各結果を調べることができます。

例えば

QString subject("the quick fox");

int offset = 0;
QRegExp re("(\\w+)");
while ((offset = re.indexIn(subject, offset)) != -1) {
    offset += re.matchedLength();
    // ...
}

のように書き換えることができます：

QString subject("the quick fox");

QRegularExpression re("(\\w+)");
QRegularExpressionMatchIterator i = re.globalMatch(subject);
while (i.hasNext()) {
    QRegularExpressionMatch match = i.next();
    // ...
}

ユニコードプロパティのサポート

QRegExp を使用する場合、\w 、\d などの文字クラスは、対応する Unicode プロパティを持つ文字にマッチします。例えば、\d は、UnicodeNd (10進数) プロパティを持つあらゆる文字にマッチします。

これらの文字クラスは、QRegularExpression を使用する場合、デフォルトでは ASCII 文字にのみマッチします：例えば、\d は0-9 ASCII 範囲の文字に正確にマッチします。この動作を変更するには、QRegularExpression::UseUnicodePropertiesOption patternオプションを使います。

ワイルドカード・マッチング

QRegularExpression でワイルドカード・マッチングを行う直接的な方法はありません。 しかし、QRegularExpression::wildcardToRegularExpression() メソッドが用意されており、グロブ・パターンを Perl 互換の正規表現に変換することができます。

例えば、以下のようなコードがあるとします：

QRegExp wildcard("*.txt");
wildcard.setPatternSyntax(QRegExp::Wildcard);

のようなコードがあれば、次のように書き換えることができる：

auto wildcard = QRegularExpression(QRegularExpression::wildcardToRegularExpression("*.txt"));

ただし、シェルのようなワイルドカード・パターンの中には、期待通りに変換されないものもあるので注意してほしい。以下のコード例は、上記の関数を使って単純に変換すると、無言のうちに壊れてしまいます：

const QString fp1("C:/Users/dummy/files/content.txt");
const QString fp2("/home/dummy/files/content.txt");

QRegExp re1("*/files/*");
re1.setPatternSyntax(QRegExp::Wildcard);
re1.exactMatch(fp1); // returns true
re1.exactMatch(fp2); // returns true

// but converted with QRegularExpression::wildcardToRegularExpression()

QRegularExpression re2(QRegularExpression::wildcardToRegularExpression("*/files/*"));
re2.match(fp1).hasMatch(); // returns false
re2.match(fp2).hasMatch(); // returns false

これは、デフォルトではQRegularExpression::wildcardToRegularExpression() が返す正規表現が完全にアンカーされているためです。アンカーされていない正規表現を取得するには、変換オプションとしてQRegularExpression::UnanchoredWildcardConversion を渡します：

QRegularExpression re3(QRegularExpression::wildcardToRegularExpression(
                           "*/files/*", QRegularExpression::UnanchoredWildcardConversion));
re3.match(fp1).hasMatch(); // returns true
re3.match(fp2).hasMatch(); // returns true

最小マッチング

QRegExp::setMinimal()は単純に量化子の貪欲さを反転させることで最小マッチングを実装した (QRegExp は*?,+? のような遅延量化子をサポートしていなかった)。QRegularExpression は代わりに貪欲、遅延、所有量化子をサポートしている。QRegularExpression::InvertedGreedinessOption パターンオプションは、QRegExp::setMinimal() の効果をエミュレートするのに便利です。有効にすると、量化子の欲張り度が反転します（欲張りなものは怠け者になり、その逆も同様です）。

キャレットモード

QRegExp::CaretAtOffset の動作をエミュレートするにはQRegularExpression::AnchorAtOffsetMatchOption match オプションを使用します。他のQRegExp::CaretMode モードに相当するものはない。