【実務・中級編】【バイナリ解析】ADODB.Stream と AscB 関数を用いた「リトルエンディアン」数値データのデコードと値変換 – VBScript (Visual Basic Scripting Edition)解析バイブル

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

バイナリの深淵を掌握せよ: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` を正しく理解し、低レイヤーのデータ構造を意識した設計を行えば、エンタープライズ領域の自動化においても、極めて堅牢なツールへと進化する。

「動けばいい」というコードを書くエンジニアで終わるか、データの構造を支配するアーキテクトになるか。その差は、こうした細部への執着に宿る。

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