【実務・中級編】【一括リネーム】正規表現の「後方参照」を利用した複雑なファイル名パターン置換と重複回避アルゴリズム – VBScript (Visual Basic Scripting Edition)解析バイブル

スポンサーリンク
スポンサーリンク

【極限の知見】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、あるいはクラウドネイティブな開発においても全く変わらない。

道具の使い手として、単なる「動くコード」を書く段階を卒業し、「壊れない設計」を構築するエンジニアへと進化せよ。

タイトルとURLをコピーしました