【入門編】【ユーザー入力の堅牢化】InputBox における「キャンセル」ボタンと「空文字」を正確に識別し、処理の中断を安全に行う判定ロジック – VBScript (Visual Basic Scripting Edition)解析バイブル

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

InputBoxの罠を回避せよ:ユーザー入力を「正しく」扱うための堅牢な判定ロジック

ようこそ、自動化の世界へ。

マクロの記録から一歩踏み出し、自分の手でスクリプトを書き始めたあなた。今、あなたは「プログラムに命令を出す」という魔法を使い始めています。しかし、魔法には必ず「代償」と「落とし穴」がつきものです。

今日、私があなたに伝えたいのは、非常に地味ですが、プロフェッショナルとアマチュアを分かつ決定的な境界線についてです。

それは、「ユーザーの意図を正確に読み取る」という技術です。

1. 忍び寄る「空文字」の罠

業務自動化のスクリプトを書いていると、必ずと言っていいほど「ユーザーに何かを入力してもらう」場面に遭遇します。その際、最も手軽に使われるのが `InputBox` 関数です。

' 初心者が書きがちな、少し危ういコード
Dim userName
userName = InputBox("あなたの名前を入力してください")

MsgBox userName & " さん、こんにちは!"

一見、完璧に見えますよね? しかし、このコードには致命的な弱点が潜んでいます。

ユーザーが「名前を入力せずにOKを押した」とき。あるいは、「入力をやめようとしてキャンセルボタンを押した」とき。このとき、`InputBox` は一体何を返すのでしょうか?

答えは、どちらも「空文字(””)」です。

ここが最大の落とし穴です。プログラム側から見れば、「ユーザーがわざわざ『何も入力しない』という選択をしたのか」、それとも「作業自体を『キャンセル』したのか」の区別がつかないのです。

もし、この後に「入力された名前でファイルを作成する」という処理が続いていたらどうなるでしょう? 空の名前のファイルを作ろうとしてエラーが発生するか、最悪の場合、意図しない動作でシステムを混乱させてしまうかもしれません。

2. InputBox の挙動を解剖する

アーキテクトとして、まずは対象の挙動を正確に把握しましょう。VBScriptにおける `InputBox` の戻り値は、常に String(文字列型) です。

ユーザーの操作 戻り値 型
文字を入力して「OK」 `”入力された文字”` String
何も入力せず「OK」 `””` (空文字) String
「キャンセル」をクリック `””` (空文字) String

VBA(Excelマクロなど)の `Application.InputBox` とは異なり、WSH(Windows Script Host)で動く純粋なVBScriptの `InputBox` は、キャンセル時に `False` を返してくれません。常に「文字列」として返ってくるのです。

この「区別がつかない」という性質を前提に、「どうやって安全に処理を中断させるか」という設計思想が必要になります。

3. 【実践】堅牢な判定ロジックのテンプレート

では、プロフェッショナルはどう書くのか。
最も推奨されるパターンは、「空文字が返ってきたら、それは『中断』とみなして、スクリプトを安全に終了させる」という設計です。

以下のコードを、あなたのライブラリに加えておいてください。

' =================================================================
' テーマ:堅牢なユーザー入力取得処理
' 目的:InputBoxにおけるキャンセルと空文字を安全にハンドリングする
' =================================================================

Option Explicit ' 変数の宣言を強制し、スペルミスによるバグを防ぐ(必須習慣!)

Dim userInput
Dim targetFolder

' 1. ユーザーに情報を求める
userInput = InputBox("処理対象のフォルダパスを入力してください。" & vbCrLf & _
                     "※キャンセルした場合は処理を中断します。", "フォルダ指定")

' 2. 【重要】判定ロジック
' InputBoxが ""(空文字)を返した場合、それは「キャンセル」または「未入力」
' 実務上、これらは「処理続行不可」として扱うのが最も安全です。
If userInput = "" Then
    ' ユーザーに中断したことを優しく伝える
    MsgBox "入力がなかったため、処理を中断しました。", vbExclamation, "中断"
    
    ' スクリプト自体を安全に終了させる
    WScript.Quit
End If

' 3. 入力があった場合のメイン処理
' ここに到達した時点で、userInput は必ず「何らかの文字」が入っていることが保証される
targetFolder = userInput

MsgBox "以下のフォルダに対して処理を開始します:" & vbCrLf & targetFolder, vbInformation, "実行確認"

' --- ここから実際の業務ロジックを記述 ---
' (例: ファイル操作、ログ出力など)

' =================================================================

このコードの「ここがプロ」ポイント

1. `Option Explicit` の使用:
変数の宣言漏れを防ぐのは、エンジニアの最低限の嗜みです。これがないと、タイポ(打ち間違い)が原因で原因不明のバグを生みます。
2. `If userInput = “” Then` による早期リターン:
「異常な状態(入力なし)」を最初に見つけ出し、すぐに `WScript.Quit` で処理を抜ける。これを「ガード句」と呼びます。メインの処理を `If` の中に深くネスト(入れ子)させずに済むため、コードが非常に読みやすくなります。
3. `vbExclamation` による視覚的フィードバック:
単に終了するのではなく、`MsgBox` で「なぜ止まったのか」をユーザーに伝える。これが「使いやすいツール」を作る秘訣です。

4. さらに高みを目指すあなたへ:究極の区別が必要な場合

もし、あなたの業務ロジックにおいて、「『空文字』を入力すること自体が正当な操作である」という特殊なケースがあるとしたら、どうすればいいでしょうか?

残念ながら、標準の `InputBox` だけでは、キャンセルと空文字を論理的に分離することは不可能です。その場合は、設計のレイヤーを一段上げましょう。

  • 方法A: 別の確認手段を併用する

「入力してください」の後に、「この内容でよろしいですか?(はい/いいえ)」という `MsgBox` を挟む。

  • 方法B: HTA (HTML Application) を作成する

HTMLとJavaScriptを使って、独自のダイアログ画面を作成します。これなら「キャンセルボタン」の挙動を完全にコントロールできます。

しかし、ほとんどの業務自動化において、前述の「空文字なら中断」というルールで事足りるはずです。

まとめ

プログラミングにおける「堅牢さ」とは、「ユーザーが想定外の操作をしたときに、いかに優雅に、かつ安全に振る舞えるか」にかかっています。

  • `InputBox` は、キャンセル時も空文字 `””` を返す。
  • 「空文字 = 処理の中断」と定義して、早期に `WScript.Quit` する。
  • `Option Explicit` を使い、コードの品質を担保する。

ここをクリアすれば、あなたの書くスクリプトは「ただ動くもの」から「信頼される道具」へと進化します。

さあ、自信を持って次のコードを書き進めてください。応援していますよ。

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