VBAで正規表現を使い始めると、「一致するかどうかを判定するTestメソッド」と「文字列を置換するReplaceメソッド」は比較的理解しやすい一方で、Executeメソッドの役割が分かりにくいと感じる方も多いのではないでしょうか。
Executeメソッドは、一致した文字列そのものや、その位置、長さなどの情報を取得できるメソッドです。
例えば、メールアドレスだけを抽出したり、電話番号を一覧化したり、特定のパターンをすべて取得したりする処理では欠かせません。
この記事では、Executeメソッドの基本的な使い方から、MatchCollection・Matchオブジェクトとの関係、実務で活用しやすい設計まで詳しく解説します。
✅ VBA正規表現のExecuteメソッドとは
Executeメソッドは、正規表現に一致した結果を取得するためのメソッドです。
「一致したかどうか」を知るだけであればTestメソッドでも十分ですが、実務では一致した文字列そのものを取得したい場面が数多くあります。
例えば、
- メールアドレスだけ抽出する
- 電話番号だけ取得する
- 郵便番号だけ一覧化する
- 数字だけ取り出す
といった処理では、Executeメソッドが活躍します。
ここを理解しておくと、文字列検索の幅が大きく広がります。
「一致するかどうか」だけを判定したい場合は、ExecuteメソッドよりTestメソッドの方がシンプルです。それぞれの使い分けについては、【VBA】正規表現のTestメソッドの使い方|一致判定を実務で活用する方法で詳しく解説しています。
・Executeメソッドの役割
Executeメソッドは、
RegExp.Execute(対象文字列)
という形で使用します。
戻り値はTrueやFalseではなく、
MatchCollection
というオブジェクトになります。
このMatchCollectionの中に、一致したすべての文字列が格納されています。
つまり、
対象文字列
↓
Execute
↓
MatchCollection ↓
Matchオブジェクト
という流れで情報を取得します。
・Testメソッドとの違い
Testメソッドは、
「一致したか」
だけを返します。
例えば、
If regEx.Test(targetText) Then
であれば、
True
または
False
しか取得できません。
一方Executeメソッドは、
- 一致した文字列
- 一致した位置
- 一致した長さ
まで取得できます。
実務では、
検索だけならTest
取得するならExecute
と考えると理解しやすくなります。
Executeメソッドは、正規表現オブジェクトの機能の一つです。RegExpオブジェクトの作成方法や各プロパティ・メソッドの全体像については、【VBA】正規表現(RegExp)の使い方|オブジェクト作成・検索・抽出を実務向けに解説で詳しく紹介しています。
✅ Executeメソッドの基本的な使い方
Executeメソッドは、一見するとコード量が多く感じられます。
しかし、役割ごとにオブジェクトを分けておくことで、後から処理を追加しやすくなります。
実務では、「動くコード」よりも「変更しやすいコード」の方が長く使えるため、変数名や処理の流れを明確にしておくことが重要です。
ここでは、保守性を意識した基本形を紹介します。
・一致した文字列を取得する基本例
まずは、一致した文字列を1件取得する最も基本的な例です。
Sub GetMatchText()
'=========================================
' 変数宣言
'=========================================
Dim regEx As Object
Dim matchResults As Object
Dim matchItem As Object
Dim targetText As String
'=========================================
' 検索対象
'=========================================
targetText = "お問い合わせは test@example.com までお願いします。"
'=========================================
' 正規表現オブジェクト生成
'=========================================
Set regEx = CreateObject("VBScript.RegExp")
With regEx
.Pattern = "[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}"
.Global = False
.IgnoreCase = True
End With
'=========================================
' Executeメソッドで検索
'=========================================
Set matchResults = regEx.Execute(targetText)
'=========================================
' 一致結果が存在する場合
'=========================================
If matchResults.Count > 0 Then
Set matchItem = matchResults(0)
MsgBox matchItem.Value
Else
MsgBox "一致する文字列はありません。"
End If
End Sub
Executeメソッドの結果は、Patternプロパティで設定した検索条件によって決まります。正規表現パターンの書き方や指定方法について詳しく知りたい方は、【VBA】正規表現:Patternプロパティの使い方も参考にしてください。
・なぜこの構成にしているのか
このコードでは、
- 正規表現オブジェクト
- 検索結果
- 一致したデータ
をそれぞれ別の変数で管理しています。
実務では、
後から
- ループ処理を追加する
- 件数を取得する
- 一致位置を取得する
といった仕様変更が発生することも珍しくありません。
最初から役割を分けておくことで、修正範囲を最小限に抑えられます。
・もっと短く書く方法との違い
例えば、
MsgBox regEx.Execute(targetText)(0).Value
のように1行で書くこともできます。
しかし、この書き方では、
- 途中結果を確認しにくい
- デバッグしづらい
- 後からループ処理へ変更しにくい
というデメリットがあります。
実務では、可読性や保守性を考慮して、一度変数へ格納する書き方が推奨されます。
・実務で使うときの注意点
Executeメソッドは、
一致しない場合でもエラーにはならず、
MatchCollection.Count
が0になります。
そのため、
If matchResults.Count > 0 Then
のように件数を確認してからMatchオブジェクトへアクセスすることが重要です。
この確認を省略すると、
matchResults(0)
の部分で実行時エラーが発生する可能性があります。
実務では、まず件数を確認することを基本ルールにしておくと安全です。
✅ Matchオブジェクトから取得できる情報
Executeメソッドの便利な点は、「一致した文字列」だけではなく、その文字列に関するさまざまな情報を取得できることです。
「何が一致したのか」だけでなく、「どこに一致したのか」「何文字一致したのか」が分かるため、データ抽出や文字列解析などの実務でも活用できます。
ここを理解すると、Executeメソッドをより柔軟に使いこなせるようになります。
・Valueプロパティ
一致した文字列そのものを取得します。
例えば、
test@example.com
だけを取得したい場合は、
matchItem.Value
を使用します。
最も利用頻度の高いプロパティです。
・FirstIndexプロパティ
一致した位置を取得します。
例えば、
ABC123XYZ
という文字列で「123」が一致した場合、
開始位置が数値で返されます。
文字列の解析や加工処理では、この情報を利用することがあります。
・Lengthプロパティ
一致した文字数を取得します。
例えば、
test@example.com
なら、
文字数を取得できます。
一致位置と組み合わせることで、対象文字列の前後を切り出す処理などにも利用できます。
Matchオブジェクトでは、ValueだけでなくFirstIndexやLengthなど、取得できる情報が数多くあります。それぞれのプロパティや活用方法については、【VBA】正規表現:Matchオブジェクトの使い方で詳しく紹介しています。
✅ Executeメソッドで複数の一致結果を取得する方法
実務では、一致する文字列が1件だけとは限りません。
例えば、
- メールアドレスをすべて抽出する
- 電話番号を一覧化する
- 商品コードをすべて取得する
といった処理では、複数の一致結果を順番に処理する必要があります。
そのため、ExecuteメソッドはFor Eachと組み合わせて使用することが一般的です。
・複数一致を取得する実務コード
ここでは、メールアドレスが複数含まれる文字列から、すべて取得する例を紹介します。
コードは、後から別の処理へ流用しやすいように、役割ごとに変数を分けています。
Sub GetAllMatches()
'=========================================
' 変数宣言
'=========================================
Dim regEx As Object
Dim matchResults As Object
Dim matchItem As Object
Dim targetText As String
'=========================================
' 検索対象
'=========================================
targetText = _
"営業部:sales@example.com" & vbCrLf & _
"総務部:general@example.com" & vbCrLf & _
"経理部:account@example.com"
'=========================================
' 正規表現設定
'=========================================
Set regEx = CreateObject("VBScript.RegExp")
With regEx
.Pattern = "[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}"
.Global = True
.IgnoreCase = True
End With
'=========================================
' Execute実行
'=========================================
Set matchResults = regEx.Execute(targetText)
'=========================================
' 一致結果を順番に処理
'=========================================
For Each matchItem In matchResults
Debug.Print matchItem.Value
Next matchItem
End Sub
・なぜこの書き方にしているのか
一致結果は件数が固定ではありません。
実務では、
- 0件
- 1件
- 数百件
になることもあります。
そのため、
For Each matchItem In matchResults
で処理しておけば、件数を意識せずに対応できます。
後から検索対象が増えても、コードを書き換える必要がありません。
・配列や添字で取得する方法との違い
例えば、
matchResults(0)
matchResults(1)
のように取得することもできます。
しかし、
一致件数が変わるたびにコードを修正しなければならず、
保守性はあまり高くありません。
For Eachなら、
一致件数に関係なく同じコードで処理できます。
実務ではこちらの方が圧倒的に利用されています。
・実務で使うときの注意点
複数取得する場合は、
.Global = True
が非常に重要です。
Falseのままだと、
最初の1件しか取得できません。
「Executeを使っているのに1件しか取得できない」
という原因の多くは、この設定漏れによるものです。
✅ Execute・Test・Replaceメソッドの使い分け
正規表現には複数のメソッドがありますが、目的に応じて使い分けることが重要です。
適切なメソッドを選ぶことで、コードもシンプルになり、処理速度や可読性の向上にもつながります。
文字列検索では、正規表現だけでなくFindメソッドを使った方がシンプルなケースもあります。用途ごとの使い分けについては、【VBA】文字列を検索する方法|Findメソッドで部分一致・複数一致まで徹底解説で詳しく解説しています。
・Testメソッドを使う場面
一致するかどうかだけ確認したい場合です。
例えば、
- 入力チェック
- 郵便番号形式か確認
- メールアドレス形式か確認
などではTestメソッドが適しています。
・Executeメソッドを使う場面
一致したデータそのものが必要な場合です。
例えば、
- メールアドレス抽出
- 商品コード取得
- 電話番号一覧作成
などではExecuteメソッドを使用します。
・Replaceメソッドを使う場面
一致した文字列を別の文字へ置き換えたい場合です。
例えば、
- ハイフン削除
- 全角・半角変換前処理
- HTMLタグ除去
などではReplaceメソッドが適しています。
✅ 実務でExecuteメソッドが活躍する場面
Executeメソッドは、「文字列を検索するだけ」の機能ではありません。
一致した情報を取得できるため、データ整理やファイル管理など、多くの業務で利用できます。
条件によっては、正規表現ではなくLike演算子だけで十分対応できる場合もあります。Like演算子との違いや使い分けについては、【VBA】Like演算子で複数条件を扱う方法|条件が増えても壊れない設計の基本もぜひご覧ください。
・メールアドレス抽出
お問い合わせ一覧から、
メールアドレスだけ取得して一覧化できます。
・商品コードの取得
例えば、
商品:ABC-001
商品:ABC-002
のようなデータから、
コードだけ抽出できます。
・ログ解析
システムログから、
- エラーコード
- 日付
- IPアドレス
などを抽出する処理でも利用されています。
・CSVデータ整理
CSV内の特定パターンだけ取得して、
データ加工する処理でも活躍します。
単なる検索ではなく、
「必要な情報だけ取得する」
という場面ではExecuteメソッドが非常に便利です。
Executeメソッドで取得した値は、その後の比較や出力処理で文字列として扱うことも少なくありません。文字列への型変換や実務での扱い方については、【VBA】Valueを文字列に変換する方法|CStr・Format・実務で失敗しない型変換の考えも参考にしてください。
✅ まとめ:Executeメソッドで一致した文字列を柔軟に取得しよう
Executeメソッドは、正規表現で一致した文字列そのものを取得するための重要なメソッドです。
Testメソッドでは取得できない位置情報や一致文字列まで扱えるため、実務ではデータ抽出や文字列解析など幅広い用途で利用されています。
今回紹介したポイントをまとめると、
- ExecuteメソッドはMatchCollectionを返す
- MatchオブジェクトからValue・FirstIndex・Lengthを取得できる
- 複数一致はFor Eachで処理すると保守性が高い
- 複数取得する場合はGlobal=Trueを忘れない
- Test・Execute・Replaceは目的に応じて使い分ける
- メールアドレスや商品コード、ログ解析など実務で活躍する場面が多い
Executeメソッドを使いこなせるようになると、「一致したかどうか」の判定だけでなく、「一致したデータを自由に活用する」処理が実現できます。正規表現をさらに実務へ活かしたい方は、ぜひExecuteメソッドを活用してみてください。