現場のエンジニアへ：VBScriptの引数パースという「地雷」を完全制圧する
VBScriptによる業務自動化を推進する中で、最も多くのエンジニアが躓き、そして最も多くの「謎のバグ」を生み出す元凶をご存知だろうか。それは、コマンドライン引数の「解釈」だ。
「バッチファイルからパスを渡しただけでスクリプトが落ちる」「パスワード文字列に `&` が含まれていると処理が止まる」。これらは単なるエラーではない。Windowsシェル（cmd.exe）の仕様と、VBScriptのWScript.Argumentsオブジェクトの間の「文化的な断絶」を理解していないことによる設計ミスだ。
今回は、この断絶を埋め、どんな特殊文字が来ようとも微塵も動じない、堅牢な引数パーサーの極意を伝授する。
—
1. なぜ「そのまま」受け取ってはいけないのか
コマンドプロンプトにおいて、`&`, `|`, `<`, `>`, `^` といった記号はすべて「メタ文字」として定義されている。
cscript //nologo script.vbs “C:\Data & Reports\file.txt”
上記のようなコマンドを打ったとき、cmd.exeは `&` をコマンドセパレータとして解釈しようと試みる。引用符で囲めば回避できるケースも多いが、環境変数経由での呼び出しや、複雑なバッチのパイプライン処理が絡むと、引用符が剥がれたり、予期せぬエスケープシーケンスとして処理されたりして、VBScriptに届くときには「文字列が断片化」していることが多々ある。
我々が目指すべきは、「シェル側の解釈に依存せず、生の文字列をそのまま受け取る」という設計思想だ。
—
2. 極限の解釈エンジン：SafeArgumentParser
単なる `WScript.Arguments` の参照は、いわば無防備な状態だ。以下に、引数を安全に取得し、さらに必要に応じてエスケープを正規化するクラス設計を示す。
堅牢な引数処理コード（コピペ実装用）
‘ クラス名: ArgumentEngine
‘ 目的: シェルのメタ文字干渉を排除し、安全に引数を抽出する
Class ArgumentEngine
Private args
Public Sub Class_Initialize()
Set args = WScript.Arguments
End Sub
‘ 引数を配列として安全に取得する
Public Function GetRawArgs()
Dim i, arr()
ReDim arr(args.Count – 1)
For i = 0 To args.Count – 1
‘ 必要に応じて、ここでさらにサニタイズ処理を追加可能
arr(i) = args(i)
Next
GetRawArgs = arr
End Function
‘ 特定の記号をエスケープして処理を継続させるためのクリーナー
Public Function Sanitize(inputStr)
Dim s
s = inputStr
‘ 必要に応じて、特定の特殊記号をエスケープコードに置換する
‘ ここでは例として “&” を制御文字として保護する場合の処理
Sanitize = Replace(s, “&”, “%%AMP%%”)
End Function
End Class
‘ — 利用例 —
Dim parser: Set parser = New ArgumentEngine
Dim argList: argList = parser.GetRawArgs()
If UBound(argList) >= 0 Then
WScript.Echo “処理開始: ” & argList(0)
Else
WScript.Echo “引数が指定されていません。”
End If
—
3. 実務における「落とし穴」と対策
この設計を導入する際、以下の3点だけは必ず押さえておいてほしい。
- データベース連携の罠: 引数をSQLに埋め込む際、引数内の `’`（シングルクォート）は致命的だ。`Replace(arg, “‘”, “””)` の徹底は基本中の基本だが、上記パーサーに組み込んでおけば、ロジックの漏れを防げる。
- パスの末尾のバックスラッシュ: `C:\Temp\` のように、パスの末尾にバックスラッシュがあると、シェルは「後ろの引用符をエスケープした」と誤解することがある。パース後の文字列に対し、末尾の `\` の数をチェックし、偶数個なら警告を出すなどのバリデーションを入れるのがプロの仕事だ。
- WScript.Argumentsの限界: WScript.Argumentsは「実行時」の引数しか持たない。複雑な環境変数を読み込む必要がある場合は、`WScript.CreateObject(“WScript.Shell”).Environment` を併用し、引数と環境変数のハイブリッドで設定を管理せよ。
—
4. 最後に：エンジニアとしての矜持
VBScriptは古くから存在する言語だが、その「古さ」は「枯れている」ことと同義だ。正しく扱えば、これほど軽量で、OSの深部まで制御できる自動化ツールは他にない。
「動けばいい」コードを書くのは素人だ。「どんな汚い入力が来ても、システムを壊さずにエラーをハンドリングする」のが、業務自動化エンジニアの責務である。今回提示したパーサーをベースに、君たちの現場の要件に合わせてさらに研ぎ澄ましてほしい。
この知見が、君たちの自動化スクリプトを、より堅牢で信頼性の高いプロダクションコードへと昇華させる一助となれば幸いだ。健闘を祈る。
