IronHSP UTF-16 ワイド文字列型 (wstr) - 設計書

最終更新: 2026-04-11

1. 概要

HSP の変数型に UTF-16 LE ワイド文字列型 wstr (HSPVAR_FLAG_WSTR = 10) を追加する。 既存の文字列関数は第1引数の変数型を見て str/wstr を自動判定し、戻り値も同じ型で返す。

wsdim ws, 256
ws = L"Unicode文字列"        ; L"..." リテラルで UTF-16 直接代入
ws = "Shift-JIS文字列"       ; str → wstr 自動変換

n = strlen(ws)               ; wstr なので wcslen 動作 → 文字数
s = strmid(ws, 0, 4)         ; wstr → wstr 部分文字列
mes ws                        ; wstr → str 自動変換して表示

#func MessageBoxW "MessageBoxW" int, wstr, wstr, int
MessageBoxW 0, L"本文", L"題名", 0

2. 変数型の定義

自動変換ルール

L"..." リテラル

コンパイラのトークナイザで L" を検出し、ソース文字列を UTF-16 に変換してデータセグメント (DS) に格納。 バイトコードでは新しい即値型 TYPE_WSTR として扱う。

ws = L"Hello"     ; DS に 48 00 65 00 6C 00 6C 00 6F 00 00 00 (UTF-16 LE) を格納
ws = "Hello"      ; DS に "Hello\0" (SJIS/UTF-8) を格納 → ランタイムで wstr に自動変換

3. 命令・関数の対応一覧

以下の全ての命令・関数を wstr 対応にする。第1引数（対象文字列変数）の型が wstr の場合、内部的に wchar_t ベースの処理に切り替える。

3.1 文字列関数 (戻り値あり)

3.2 文字列命令 (戻り値なし)

3.3 ノートパッド命令

notesel で選択した変数が wstr の場合、以降の note 系命令は全て wchar_t ベースで動作する。 改行コードは L"\r\n" (0x000D 0x000A) を使用。

3.4 変換命令

3.5 新規命令・関数

4. 内部実装

4.1 hspvar_wstr.cpp

既存の hspvar_str.cpp と同様の FlexBuffer 方式。ただし char の代わりに wchar_t を使用。

// 主要関数
HspVarWstr_Cnv()       // str/int/double → wstr 変換
HspVarWstr_CnvCustom() // wstr → str/int/double 変換
HspVarWstr_Set()       // wchar_t* のコピー
HspVarWstr_AddI()      // 文字列結合 (wcscat)
HspVarWstr_GetSize()   // wcslen() * sizeof(wchar_t)

// FlexBuffer: wchar_t* の配列
// pval->pt → wchar_t* (offset 0)
// pval->master → wchar_t*[] (配列要素)

4.2 型判定パターン（既存関数の拡張）

// hsp3int.cpp - strlen の例

case 0x002:  // strlen
{
    int chk = code_get();
    if (chk <= PARAM_END) throw HSPERR_INVALID_FUNCPARAM;

    if (mpval->flag == HSPVAR_FLAG_WSTR) {
        // wstr: 文字数を返す
        wchar_t *ws = (wchar_t *)HspVarCoreCnvPtr(mpval, HSPVAR_FLAG_WSTR);
        reffunc_intfunc_ivalue = (int)wcslen(ws);
    } else {
        // str: バイト数を返す（従来通り）
        char *ss = (char *)HspVarCoreCnvPtr(mpval, HSPVAR_FLAG_STR);
        reffunc_intfunc_ivalue = (int)strlen(ss);
    }
    ptr = &reffunc_intfunc_ivalue;
    break;
}

4.3 L"..." リテラルのコンパイル

// codegen.cpp - トークナイザ

if ((a1 == 'L' || a1 == 'l') && wp[1] == 0x22) {  // L"
    wp += 2;
    Pickstr();  // s3 に SJIS/UTF-8 文字列を取得

    // UTF-16 に変換
    int wlen = MultiByteToWideChar(codepage, 0, (char*)s3, -1, NULL, 0);
    wchar_t *wbuf = new wchar_t[wlen];
    MultiByteToWideChar(codepage, 0, (char*)s3, -1, wbuf, wlen);

    // DS に UTF-16 バイト列を格納
    int dsofs = PutDSBufW(wbuf, wlen * sizeof(wchar_t));
    delete[] wbuf;

    val = dsofs;
    return TK_WSTRING;  // 新トークン型
}

// PutCS で TYPE_WSTR として出力
// ランタイムが DS からワイド文字列ポインタを取得

5. 実装フェーズ

6. 互換性