バイナリの深淵を掌握せよ:ADODB.StreamとAscBによるリトルエンディアン・デコードの極意
業務自動化の現場において、我々は時として「テキスト」という安全な領域を追われ、生(Raw)のバイナリデータという荒野に放り出されることがある。
古い基幹システムのログファイル、独自の通信プロトコルで吐き出されるバイナリダンプ、あるいは特定のセンサーが生成するバイナリ形式のデータ。これらを解析しようとした際、多くのエンジニアが「文字化け」や「数値の異常」という泥沼に嵌まり、立ち往生する。
なぜ彼らは失敗するのか? 理由は単純だ。VBScriptを「テキスト処理の言語」だと思い込み、メモリ上のビット列としての本質を見失っているからだ。
本稿では、VBScriptにおけるバイナリ操作の決定版として、`ADODB.Stream`を用いた堅牢なストリーム制御と、`AscB`関数によるバイト抽出、そしてリトルエンディアン形式の数値再構築ロジックについて、プロフェッショナルな設計思想と共に解説する。
1. なぜ FileSystemObject (FSO) では不十分なのか
初心者がよく犯す致命的なミスは、バイナリファイルを `FileSystemObject` で開き、テキストとして読み込もうとすることだ。
FSOは「文字」を扱うためのオブジェクトであり、内部的に文字コード(ANSIやUnicode)を介在させる。バイナリデータに含まれる `0x00` (Null文字) や、制御文字を「文字の終端」や「不正な文字」として解釈し、読み込み時に勝手に変換・欠落させてしまうのだ。
バイナリを扱う際の鉄則:
「文字(Character)」としてではなく、「バイト(Byte)」としてストリームを制御せよ。そのための唯一無二の武器が `ADODB.Stream` である。
2. リトルエンディアンの数学的解釈
コンピュータが数値をメモリに格納する際、その「並び順」にはルールがある。我々が扱う多くのWindows環境(x86/x64アーキテクチャ)では、リトルエンディアン (Little-Endian) が採用されている。
例えば、16進数で `0x1234` という2バイトの数値があるとする。
- ビッグエンディアン: `12` が先、`34` が後(人間にとって直感的)
- リトルエンディアン: `34` が先、`12` が後(メモリ上の配置)
VBScriptでこのデータをデコードする場合、先に読み込んだバイトを「下位バイト (LSB: Least Significant Byte)」、後に読み込んだバイトを「上位バイト (MSB: Most Significant Byte)」として、ビット演算または算術演算によって結合しなければならない。
3. プロダクション・グレードの実装:BinaryReader クラス
単なるコードの断片をコピペして済ませるな。保守性と再利用性を担保するためには、バイナリ読み込みの責務をカプセル化した「ロジック」として設計すべきだ。
以下に、実務でそのまま投入可能な、堅牢なデコードロジックを実装したコードを示す。
'-------------------------------------------------------------------------------
' Class: BinaryReader
' Purpose: ADODB.Stream を用いてバイナリファイルから数値を安全に抽出する
'-------------------------------------------------------------------------------
Class BinaryReader
Private m_stream
' 初期化: ファイルパスを受け取り、バイナリモードでストリームを開く
Private Sub Class_Initialize(filePath)
On Error Resume Next
Set m_stream = CreateObject("ADODB.Stream")
m_stream.Type = 1 ' adTypeBinary
m_stream.Open
m_stream.LoadFromFile filePath
If Err.Number <> 0 Then
Err.Raise 1, "BinaryReader", "Failed to open file: " & filePath
End If
On Error GoTo 0
End Sub
' 終了処理: ストリームを確実に閉じる(リソースリーク防止)
Private Sub Class_Terminate()
If Not m_stream Is Nothing Then
If m_stream.State <> 0 Then m_stream.Close
Set m_stream = Nothing
End If
End Sub
' 16bit整数 (Short) の読み込み: リトルエンディアン対応
Public Function ReadInt16()
Dim b1, b2
b1 = m_stream.Read(1)
b2 = m_stream.Read(1)
' AscBを使用して、バイトの生の値(0-255)を取得
' リトルエンディアン: b1が下位、b2が上位
ReadInt16 = AscB(b1) + (AscB(b2) * 256)
End Function
' 32bit整数 (Long) の読み込み: リトルエンディアン対応
Public Function ReadInt32()
Dim b1, b2, b3, b4
b1 = m_stream.Read(1)
b2 = m_stream.Read(1)
b3 = m_stream.Read(1)
b4 = m_stream.Read(1)
' リトルエンディアン:
' 32bit整数は 256^0, 256^1, 256^2, 256^3 の重みで合成する
ReadInt32 = AscB(b1) + _
(AscB(b2) * 256) + _
(AscB(b3) * 65536) + _
(AscB(b4) * 16777216)
End Function
' 現在の読み込み位置をスキップさせる
Public Sub Skip(bytes)
m_stream.Skip bytes
End Sub
' ファイルの末尾に到達したか確認
Public Function IsEndOfStream()
IsEndOfStream = (m_stream.Size = m_stream.Position)
End Function
End Class
'-------------------------------------------------------------------------------
' メインロジック (実行例)
'-------------------------------------------------------------------------------
On Error Resume Next
Dim filePath, reader, val16, val32
' テスト用のファイルパスを指定
filePath = "C:\temp\sample_data.bin"
' ファイルが存在するかチェック(実務では必須)
Dim fso: Set fso = CreateObject("Scripting.FileSystemObject")
If Not fso.FileExists(filePath) Then
WScript.Echo "Error: File not found."
WScript.Quit
End If
Set reader = New BinaryReader(filePath)
If Err.Number <> 0 Then
WScript.Echo "Error: " & Err.Description
WScript.Quit
End If
WScript.Echo "--- Binary Decoding Started ---"
' データの構造に従って順番に読み込む
' 例: 最初の2バイトはInt16、次の4バイトはInt32とする
val16 = reader.ReadInt16()
WScript.Echo "Decoded Int16: " & val16
val32 = reader.ReadInt32()
WScript.Echo "Decoded Int32: " & val32
WScript.Echo "--- Decoding Completed ---"
' オブジェクトの破棄(Class_Terminateが呼ばれる)
Set reader = Nothing
4. リーダーからの技術的アドバイス:設計上の陥穽
このコードを運用環境に投入するにあたり、以下の3点を肝に銘じておけ。
① 符号付き (Signed) と符号なし (Unsigned) の境界
VBScriptの数値型(Variant/Double)は、非常に大きな数値を扱えるが、32bit整数のビット演算結果を扱う際、最上位ビット(MSB)が `1` の場合、それを「負の数」として扱うか「正の大きな数」として扱うかは、設計思想に依存する。
もし読み込んだデータが `Unsigned Int32` である場合、上記の `ReadInt32` ロジックで正しく計算されるが、結果が $2^{31}$ を超えると、VBScriptの内部的な数値処理の挙動に注意を払う必要がある。
② リソース管理の徹底
`ADODB.Stream` は、OSのファイルハンドルを掴む。スクリプトが異常終了したり、`Close` を忘れたりすると、ファイルがロックされたままになり、後続のプロセスが失敗する原因となる。必ず `Class_Terminate` や `On Error` を用いて、確実にリソースを解放する設計にせよ。
③ パフォーマンスの最適化
もし数百万行のバイナリデータを処理する必要があるなら、1バイトずつ `Read(1)` を呼び出すのは非効率だ。ある程度のサイズ(例:4KBのバッファ)を一度に `Read` し、メモリ上の変数(バイト配列的な挙ニック)として保持してから処理する「バッファリング戦略」へ昇華させる必要がある。
結論
VBScriptは決して強力な言語ではない。しかし、`ADODB.Stream` と `AscB` を正しく理解し、低レイヤーのデータ構造を意識した設計を行えば、エンタープライズ領域の自動化においても、極めて堅牢なツールへと進化する。
「動けばいい」というコードを書くエンジニアで終わるか、データの構造を支配するアーキテクトになるか。その差は、こうした細部への執着に宿る。
