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

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

ファイル操作の極致:VBScriptにおける正規表現後方参照と衝突回避アルゴリズムの設計

多くのエンジニアは、VBScriptを「古臭い、使い捨てのスクリプト」と軽視している。しかし、Windowsのレガシーなインフラストラクチャが動いている限り、この言語は今なお、システム運用の最前線で「静かなる破壊者」あるいは「絶対的な守護者」として君臨し続けている。

本稿で扱うテーマは、単なるファイル名の変更ではない。ファイル名という「不規則な文字列の集合体」を、正規表現という外科手術によって解体し、再構築する。さらに、ファイルシステムにおける衝突(Collision)を数学的に回避するアルゴリズムを、VBScriptという制約の多い環境下でいかに実装するか。

これは、オブジェクトのライフサイクルとメモリ管理、そして例外処理の極限を追求する、シニアエンジニアのための技術論である。

1. 正規表現による「構造の解体」と後方参照の真価

ファイル名のリネームにおいて、最も致命的なミスは「文字列の置換(Replace)」を単純な文字列一致で行うことだ。例えば、`Log_20231027_v1.txt` を `2023-10-27_v1.log` に変えたい場合、単純な置換では他の数値部分まで破壊するリスクがある。

ここで投入するのが、`VBScript.RegExp` オブジェクトによるキャプチャグループ(Capturing Groups)と後方参照(Backreferences)である。

キャプチャグループの概念

正規表現内で `()` を用いることで、マッチした部分文字列をメモリ上の特定のスロットに保持できる。
パターン:`^Log_(\d{4})(\d{2})(\d{2})_(.*)\.txt$`

このパターンは、以下の4つのパーツを抽出する:
1. `$1`: 年 (`\d{4}`)
2. `$2`: 月 (`\d{2}`)
3. `$3`: 日 (`\d{2}`)
4. `$4`: 識別子 (`.*`)

後方参照による再構成

`RegExp.Replace` メソッドにおいて、置換後の文字列に `$1`, `$2` と記述することで、抽出したパーツを任意の順序で再構成できる。
置換文字列:`$1-$2-$3_$4.log`

これにより、ファイル名の「意味論(Semantics)」を維持したまま、構造のみを変換することが可能となる。

2. 衝突回避アルゴリズム:決定論的な枝番付与

リネーム処理において、最も恐るべき事態は「同名ファイルの存在によるエラー」および「意図しない上書き」である。実務レベルのツールには、ファイルが存在するかどうかを判定し、存在する場合は `(1)`, `(2)` といった枝番を自動的に付与する決定論的な回避ロジックが不可欠である。

単に `FileExists` を確認するだけでは不十分だ。ループを用いて、確実に「未使用のファイル名」を特定するまで探索を継続する。

アルゴリズムのステップ

1. 新しいファイル名案を生成する。
2. `FileSystemObject.FileExists` を用いて、その名前が既に存在するかを確認する。
3. 存在する場合、ベース名と拡張子の間にインクリメンタルなカウンターを挿入する。
4. 存在しない名前が見つかるまで、カウンターをインクリメントして再試行する。

3. メモリ管理とオブジェクトのライフサイクル

VBScriptはCOM(Component Object Model)を介して動作する。`FileSystemObject` や `RegExp` といった強力なオブジェクトを使用する場合、それらは参照カウントによって管理されている。

大規模なディレクトリ(数万ファイル規模)を処理する際、ループ内でオブジェクトを適切に解放(`Set obj = Nothing`)しないと、メモリリークを引き起こすだけでなく、Windowsのファイルシステムに対して「ハンドルが解放されていない」という状態を作り出し、後続のプロセスがファイルにアクセスできなくなる致命的なエラーを招く。

「オブジェクトは、その責任を果たした瞬間に、明示的に破棄せよ」。これがアーキテクトの鉄則である。

4. 実装:究極のリネーム・エンジン

以下に、これらすべての知見を統合した、実戦投入可能なVBScriptコードを示す。

'**
' Script: AdvancedRenameEngine.vbs
' Author: Legendary Chief Architect
' Description: 正規表現を用いた高度なリネームおよび衝突回避アルゴリズムの実装
'**
Option Explicit

' 外部依存オブジェクトの定義
Dim fso, regEx
Set fso = CreateObject("Scripting.FileSystemObject")
Set regEx = CreateObject("VBScript.RegExp")

' --- 設定領域 ---
Dim targetFolderPath, pattern, replacement
targetFolderPath = "C:\Work\TestFiles" ' 対象ディレクトリ
pattern          = "^Log_(\d{4})(\d{2})(\d{2})_(.*)\.txt$" ' 抽出パターン
replacement      = "$1-$2-$3_$4.log"                       ' 再構成パターン
' ----------------

Main targetFolderPath, pattern, replacement

Sub Main(path, pat, rep)
    Dim folder, file
    
    ' ディレクトリの存在確認
    If Not fso.FolderExists(path) Then
        WScript.Echo "Error: Target folder not found."
        WScript.Quit
    End If

    Set folder = fso.GetFolder(path)
    
    ' RegExpの設定
    regEx.Pattern = pat
    regEx.Global = False
    regEx.IgnoreCase = True

    WScript.Echo "Starting rename process..."

    For Each file In folder.Files
        ' 正規表現にマッチするか確認
        If regEx.Test(file.Name) Then
            ProcessFile file, rep
        End If
    Next

    WScript.Echo "Process completed."
    
    ' オブジェクトの明示的な解放
    Set folder = Nothing
    Set regEx = Nothing
    Set fso = Nothing
End Sub

Sub ProcessFile(fileObj, repPattern)
    Dim oldName, newBaseName, newExt, finalName, counter
    Dim baseNamePart, extensionPart
    
    oldName = fileObj.Name
    
    ' 1. 正規表現による再構成
    ' Replaceメソッドはマッチしない場合は元の文字列を返す
    finalName = regEx.Replace(oldName, repPattern)
    
    ' 2. 衝突回避アルゴリズム (Collision Avoidance)
    ' ファイル名が変更される場合のみ、重複チェックを行う
    If LCase(oldName) <> LCase(finalName) Then
        
        ' 拡張子とベース名を分離
        baseNamePart = fso.GetBaseName(finalName)
        extensionPart = "." & fso.GetExtensionName(finalName)
        
        ' 暫定的なフルパス
        Dim targetPath
        targetPath = fso.BuildPath(fileObj.ParentFolder.Path, finalName)
        
        counter = 1
        ' 同名ファイルが存在する限り、枝番を付与してループ
        Do While fso.FileExists(targetPath)
            ' 重複回避用の新しい名前を生成: "BaseName (1).ext"
            finalName = baseNamePart & " (" & counter & ")" & extensionPart
            targetPath = fso.BuildPath(fileObj.ParentFolder.Path, finalName)
            counter = counter + 1
        Loop
        
        ' 3. 実行とエラーハンドリング
        On Error Resume Next
        fileObj.Name = finalName
        
        If Err.Number <> 0 Then
            WScript.Echo "Failed to rename: " & oldName & " -> " & Err.Description
            Err.Clear
        Else
            WScript.Echo "Success: " & oldName & " -> " & finalName
        End If
        On Error GoTo 0
    End If
End Sub

技術的解説:コードの肝

1. `regEx.Test(file.Name)`:
`Replace` を実行する前に `Test` メソッドでマッチングを確認している。これは、不要な文字列操作を回避するための最適化である。
2. `Do While fso.FileExists(targetPath)`:
ここが衝突回避の心臓部だ。`counter` をインクリメントしながら、ファイルシステムに対して「空き」があるかを確認し続ける。これにより、`file.txt` が既にあれば `file (1).txt`、それもあれば `file (2).txt` と、数学的に確実な名前を導き出す。
3. `On Error Resume Next` の局所的使用:
エラーハンドリングをスクリプト全体に広げるのは素人のすることだ。リネームという「外部要因(ファイルロック等)に左右される不安定な操作」に対してのみ、ピンポイントで適用し、`Err.Number` を即座に評価することで、堅牢性を担保している。
4. `LCase` による比較:
Windowsのファイルシステムはケースインセンティブ(大文字小文字を区別しない)である。`LCase(oldName) <> LCase(finalName)` とすることで、大文字小文字の変化のみを目的とした無駄なリネームを防いでいる。

結論

VBScriptによる自動化において、重要なのは「動くコード」を書くことではない。「壊れないコード」を書くことだ。正規表現による精密な構造解析と、衝突を許さないアルゴリズム、そしてリソースの厳格な管理。これらが組み合わさったとき、レガシーなスクリプトは、現代の洗練されたツールに比肩する信頼性を手にする。

エンジニアとしての矜持を持て。細部にこそ、真理は宿る。

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