【極限の知見】VBScriptによる堅牢な一括リネーム:正規表現「後方参照」と重複回避アルゴリズムの設計学
業務自動化の現場において、「ファイル名の整理」は一見、単純なタスクに見える。しかし、その実態は泥沼だ。
日付のフォーマットが混在し、連番が欠落し、リネームした結果、既存のファイル名と衝突してデータが消失しかける――。
もし君が、単なる `Replace` 関数や、単純なループ処理だけでリネームツールを組もうとしているなら、今すぐその設計書を破り捨ててほしい。それは「自動化」ではなく、単なる「バグの高速生成」に過ぎない。
プロフェッショナルが求めるのは、「パターンの抽出(分解)」「構造の再構築(結合)」「衝突の検知と回避(整合性)」という3つのフェーズが完璧に分離され、かつ堅牢に統合されたアーキテクチャである。
本稿では、VBScriptにおける正規表現の「後方参照」を極め、実務に耐えうる「重複回避アルゴリズム」を組み込んだ、真のプロダクションコードの書き方を伝授する。
1. 正規表現の真髄:後方参照(Backreference)による構造の再定義
多くの開発者は、正規表現を「特定の文字列を探すための道具」と考えている。だが、それは初歩的な誤解だ。高度なリネームにおいて、正規表現は「文字列の構造を解体し、再構成するための設計図」である。
例えば、以下のようなファイル名があるとしよう。
`Report_20231027_Sales.csv`
これを `20231027_Report_Sales.csv` という「日付が先頭に来る形式」に変換したい場合、文字列を切り貼りするのではなく、「キャプチャグループ」を利用してパーツを定義し、「後方参照」を用いてその位置を入れ替える。
キャプチャグループの概念
正規表現内で括弧 `()` を用いることで、マッチした部分をメモリ上に一時的に保持できる。これがキャプチャグループだ。
- `(.*)_(\d{8})_(.*)`
- `$1`: `Report`
- `$2`: `20231027`
- `$3`: `Sales`
後方参照による置換
VBScriptの `RegExp.Replace` メソッドでは、置換後の文字列に `$1`, `$2` と記述することで、キャプチャした内容を呼び出せる。
- 置換パターン: `$2_$1_$3`
- 結果: `20231027_Report_Sales`
この手法の利点は、「ルールが明確であれば、複雑な文字列操作ロジックを一切書かずに済む」という点にある。ロジックが減ることは、バグが減ることを意味する。
2. 重複回避アルゴリズム:衝突は「予見」し「回避」せよ
リネーム処理における最大の脆弱性は、「生成した新しいファイル名が、既にディレクトリ内に存在する場合」に発生する。
初心者はここで `On Error Resume Next` でエラーを握りつぶし、処理を強行しようとする。これは最悪の設計だ。リネームに失敗したファイルが元の名前のまま放置されるか、あるいは予期せぬ上書きが発生するリスクを孕んでいる。
設計指針:インクリメンタル・ネーミング
堅牢なツールは、以下のプロセスを辿るべきである。
1. 新名称の生成: 正規表現に基づき、新しいファイル名を仮決定する。
2. 存在確認: `FileSystemObject.FileExists` を用いて、その名称が既に存在するかをチェックする。
3. 枝番の付与(ループ処理): 存在する場合、`ファイル名_(1).ext`, `ファイル名_(2).ext` と、重複が解消されるまでインクリメントを繰り返す。
4. 最終決定: 重複しない名前が確定した段階で、初めて `Name` ステートメントを実行する。
この「決定してから実行する」というアトミック(不可分)な思考こそが、データの整合性を守る鍵となる。
3. 実戦投入用:プロダクション・グレード・コード
以下に、これら全ての知見を詰め込んだ、そのまま実務で使用可能なコードを示す。このコードは、単なるスクリプトではない。保守性と堅牢性を考慮した、エンジニアリングの結晶だ。
'**
' Module: Professional Mass Renamer
' Description: 正規表現を用いた高度なリネームと重複回避アルゴリズムの実装
' Author: Chief Architect
'**
Option Explicit
' メイン処理の実行
Call Main()
Sub Main()
Dim fso, targetFolder, regExp
Set fso = CreateObject("Scripting.FileSystemObject")
' --- 設定エリア ---
' 対象フォルダのパスを指定
targetFolder = "C:\Test\TargetFiles"
' 正規表現パターン: "名前_日付_種別.拡張子" を想定
' 例: Report_20231027_Sales.csv -> 20231027_Report_Sales.csv
Dim pattern, replacement
pattern = "^(.*)_(\d{8})_(.*)\.(.*)$"
replacement = "$2_$1_$3.$4"
' ------------------
If Not fso.FolderExists(targetFolder) Then
WScript.Echo "Error: 指定されたフォルダが存在しません。"
Exit Sub
End If
Set regExp = New RegExp
regExp.Pattern = pattern
regExp.Global = False ' 1ファイルにつき1回の置換
regExp.IgnoreCase = True
Dim folder, file, newName, finalName
Set folder = fso.GetFolder(targetFolder)
WScript.Echo "リネーム処理を開始します..."
For Each file In folder.Files
' 正規表現にマッチするか確認
If regExp.Test(file.Name) Then
' 1. 新しいファイル名の生成(正規表現による再構成)
newName = regExp.Replace(file.Name, replacement)
' 2. 重複回避アルゴリズムの適用
finalName = GetUniqueFileName(fso, folder.Path, newName)
' 3. 実行(元の名前と異なる場合のみ)
If file.Name <> finalName Then
On Error Resume Next
file.Name = finalName
If Err.Number <> 0 Then
WScript.Echo "Error: [" & file.Name & "] のリネームに失敗しました: " & Err.Description
Err.Clear
Else
WScript.Echo "Success: [" & file.Name & "] -> [" & finalName & "]"
End If
On Error GoTo 0
End If
End If
Next
WScript.Echo "すべての処理が完了しました。"
Set fso = Nothing
Set regExp = Nothing
End Sub
'**
' Function: GetUniqueFileName
' Purpose: ファイル名が重複する場合、末尾に枝番を付与して一意のパスを返す
'**
Function GetUniqueFileName(fso, folderPath, targetName)
Dim baseName, extension, fullPath, i
Dim dotPos
' 拡張子とベース名を分離
dotPos = InStrRev(targetName, ".")
If dotPos > 0 Then
baseName = Left(targetName, dotPos - 1)
extension = Mid(targetName, dotPos) ' "." を含む
Else
baseName = targetName
extension = ""
End If
fullPath = folderPath & "\" & targetName
' 重複している間、枝番をインクリメントする
i = 1
Do While fso.FileExists(fullPath)
' 形式: baseName_(i).extension
fullPath = folderPath & "\" & baseName & "_(" & i & ")" & extension
i = i + 1
Loop
' ファイル名部分のみを抽出して返す(Nameプロパティに代入するため)
' ※実際にはフルパスを扱う方が安全だが、file.Nameへの代入を想定
GetUniqueFileName = fso.GetFileName(fullPath)
End Function
4. アーキテクトの教訓:保守性を高めるための設計思想
このコードを読み解き、君の血肉としてほしい。以下の3点は、現場のリーダーがコードレビューで必ずチェックするポイントだ。
① 責務の分離 (Separation of Concerns)
上記のコードでは、`Main` 関数が全体のフローを制御し、`GetUniqueFileName` が「一意性の確保」という単一の責任のみを担っている。もし将来、「枝番の形式を `(1)` ではなく `-01` に変えたい」という要求が来ても、修正すべき箇所は `GetUniqueFileName` だけだ。
② エラーハンドリングの局所化
`On Error Resume Next` をスクリプトの冒頭に書くのは、素人のすることだ。エラーハンドリングは、「失敗する可能性がある最小限の範囲」に閉じ込める。これにより、予期せぬエラー(メモリ不足やシステムエラー)を見逃すリスクを最小化できる。
③ 冪等性 (Idempotency) の意識
このスクリプトは、「2回実行しても、2回目は何も起こらない(あるいは安全に終了する)」という性質を持っている。正規表現にマッチしないファイルは無視され、既に正しい名前になっているファイルも再処理されない。この「冪等性」こそが、自動化ツールにおける信頼性の根幹である。
結論
VBScriptは古い言語かもしれない。しかし、その背後にある「オブジェクトのライフサイクル」「ファイルシステムの挙動」「アルゴリズムの整合性」という原則は、現代のPythonやGo、あるいはクラウドネイティブな開発においても全く変わらない。
道具の使い手として、単なる「動くコード」を書く段階を卒業し、「壊れない設計」を構築するエンジニアへと進化せよ。
