構造体ビューは、.yupat で定義した構造を現在のカーソル位置に適用し、バイナリデータをフィールド単位で確認するための機能です。

開き方

1. YuHex で解析したいファイルを開きます。
2. メニュー(設定 - 解析 - 構造体ビュー)から構造体ビューウィンドウを表示します。
3. 構造体ビューの 開く... ボタンから .yupat ファイルを選択します。
4. 16進ダンプ領域 のカーソル位置を基準として、構造体ビューに解析結果が表示されます。

.yupat の書き方

.yupat は、C言語の struct 宣言に、YuHex 用のディレクティブを少し加えた定義ファイルです。

基本ルール

• 文字コードは UTF-8 を推奨します。
• コメントは // ... と /* ... */ が使えます。
• 起点となる構造体は @entry で指定します。
• 構造体定義が 1 つだけのファイルでは、@entry を省略できます。

よく使うディレクティブ

すべてのディレクティブ

対応している宣言

• struct name { ... };
• typedef struct tag { ... } TYPE;
• typedef 既存型 別名;
• typedef struct tag TYPE; のような前方宣言
• 通常メンバー: type name;
• 固定長配列: type name[count];
• 可変長配列: type name[];
• ポインタ: type* name;

制限事項

• union、enum、ビットフィールド、多次元配列には対応していません。
• #include、#define、条件コンパイルなどのプリプロセッサ構文には対応していません。
• 可変長配列 [] は、構造体の最後のメンバーにのみ置けます。

サイズ計算の制限

• x64版では、配列の要素数とサイズ計算の各結果は、符号なし64ビット整数の範囲（最大 18446744073709551615）に収まる必要があります。
• 固定長配列の「要素サイズ × 要素数」、メンバーの「オフセット + サイズ」、アラインメントによるパディングを含む構造体サイズのいずれかが上限を超える場合、定義ファイルの読み込みをエラーにします。小さなサイズへ折り返して解釈することはありません。
• この上限はサイズ計算上の上限です。その大きさのデータを実際に読み込めることを保証するものではありません。

EBNF 風文法

file            = { ws | comment | directive | declaration } ;

directive       = "@entry" ident
                | "@sizeof_short" number
                | "@sizeof_int" number
                | "@sizeof_long" number
                | "@sizeof_long_long" number
                | "@sizeof_float" number
                | "@sizeof_double" number
                | "@pointer_size" number
                | "@member_align" number ;

declaration     = typedef_decl
                | struct_decl
                | forward_decl ;

typedef_decl    = "typedef" type_spec declarator_list ";" ;

struct_decl     = [ "typedef" ] "struct" [ ident ] "{"
                  member_decl* "}" [ ident ] ";" ;

forward_decl    = "typedef" "struct" ident ident ";" ;

member_decl     = type_spec declarator ";" ;

type_spec       = builtin_type
                | ident
                | "struct" ident ;

declarator_list = declarator { "," declarator } ;

declarator      = [ "*" ] ident [ array_suffix ] ;

array_suffix    = "[" number "]"
                | "[" "]" ;

サンプル

@member_align 0
@pointer_size 8
@entry sample_record

typedef unsigned char  BYTE;
typedef unsigned short WORD;
typedef struct nested_header nested_header_t;

struct nested_header {
    WORD flags;
    BYTE reserved[2];
};

typedef struct sample_record {
    WORD            magic;
    BYTE            version;
    BYTE            name_length;
    BYTE            name[8];
    nested_header_t header;
    void*           next;
    char            payload[];
} sample_record;

このサンプルには、typedef、前方宣言、通常メンバー、固定長配列、構造体メンバー、ポインタ、可変長配列が含まれています。

サンプルファイルのダウンロード

無料版・Microsoft Store版で共通のサンプルです。任意のフォルダに保存し、構造体ビューの 開く... から選択してください。配布パッケージには同梱していません。

• syntax_showcase.yupat — 対応する構文とディレクティブの使用例。
• tftp_rrq.yupat — TFTP 読み取り要求の解析例。
• zip_local_file.yupat — ZIP ローカルファイルヘッダーの解析例。

画面の見方

表示の特徴

• 入れ子の構造体は、親行の下に 1 段だけフラット展開して表示します。
• 親となる構造体行の値は空欄で表示します。
• 固定長フィールドの全バイトが入力データ内に収まらない場合、値は -（表示不可）とします。不足分を入力データの範囲外から読み取ることはありません。
• 表示行数は最大 256 行です。超える場合は末尾に ... を表示します。
• 列幅はドラッグで変更できます。列境界をダブルクリックすると既定幅に戻ります。

値の表示設定

値 列の見出し右側にあるボタンから、表示形式を切り替えられます。

ASCII文字列表示では、次のルールで表示します。

• \0 が見つかった場合は、そこまでを文字列として表示します。
• 途中で非 ASCII 文字または制御文字が現れた場合は、そこまでを文字列として表示し、末尾に ... を付けます。
• 先頭から文字列として解釈できない場合は、16進列表示にフォールバックします。

ボタン

エラー表示

• 定義ファイルにエラーがある場合は、構造体ビュー内にエラーメッセージを表示します。
• エラーの位置を特定できる場合は、行番号、列番号、該当行、位置キャレットを表示します。
• エラーメッセージ欄はテキスト選択とコピーに対応しています。

注意事項

• 構造体ビューは、現在のカーソル位置からデータを解釈します。見たい場所へカーソルを移動してから使用してください。
• 構造体ビューは、定義ファイルそのものの意味解釈までは行いません。必要に応じて値の表示形式を切り替えて確認してください。

Microsoft Store版の機能・使い方に戻る