English: README-EN.md is also available.
Windows の CTest で ANSI コードページ出力するテストプログラムを正しく扱うためのテストランナーラッパーです。CP932（日本語）をはじめ、CP936（簡体字中国語）・CP949（韓国語）など任意の ANSI コードページに対応します。
次の条件に当てはまるプロジェクトで使用します。
- Windows 上で CMake + CTest を使っている
- テストプログラムが ANSI コードページ（CP932・CP936・CP949 など）でテキストを出力する
- テスト出力に マルチバイト文字が含まれており、文字化けなく表示したい
ANSI コードページ出力が残っているのは、ほとんどの場合、UTF-8 移行が完了していないレガシーなソフトウェアです。
CTest（CMake 3.20 以降）はテストプロセスの出力を UTF-8 バイト列として処理 します。有効な UTF-8 シーケンス（ASCII を含む）はそのまま通過しますが、UTF-8 として無効なバイト列は U+FFFD（\xEF\xBF\xBD）に置換 されます。CP932 のマルチバイト文字は UTF-8 として無効なため、CP932 でエンコードされた日本語が文字化けします。
CP932 の 2 バイト文字はリードバイト（0x81–0x9F, 0xE0–0xFC）とトレイルバイト（0x40–0x7E, 0x80–0xFC）で構成されます。トレイルバイトの一部（0x40–0x7E）は ASCII 範囲のためそのまま通過します。結果として U+FFFD と意図しない ASCII 断片が混在した文字化けになります。
stdout: 日本語テスト出力 を CP932 で出力した場合の実際の表示：
期待: stdout: 日本語テスト出力
実際: stdout: ���{��e�X�g�o��
（? = U+FFFD 置換文字、{・e・X・g・o は CP932 トレイルバイトが ASCII として通過した断片）
add_test(COMMAND cmd.exe /C ...) は使えません。CTest は COMMAND の各引数を 個別にクォート して CreateProcess に渡すため、/C が "/C" になり、cmd.exe がフラグとして認識できず次のエラーで失敗します。
コマンドの構文が誤っています。
ctest_cp932_runner.exe がテストプロセスをラップします。
テストプロセス (stdout/stderr: ANSI コードページ)
→ ctest_cp932_runner がパイプでキャプチャ（2 スレッドで並行読み取り）
→ MultiByteToWideChar(コードページ) + WideCharToMultiByte(CP_UTF8) で変換
→ WriteFile で UTF-8 を自身の stdout/stderr へ出力
→ CTest が UTF-8 バイト列をそのまま通過させる
→ 文字化けなしに正しいテキストが表示される
stdout と stderr を 2 スレッドで並行読み取りすることで、バッファが満杯になったときのデッドロックを防ぎます。出力には WriteFile を使用し、C ランタイムによるエンコーディング変換を回避します。
| ソフトウェア | バージョン |
|---|---|
| Windows | 10 以降 |
| CMake | 3.20 以上 |
| Visual Studio | 2022 または 2026（MSVC コンパイラ） |
MinGW-w64 でもビルド可能ですが、動作確認は MSVC で行っています。
注意: CMake FetchContent で組み込む場合は個別のビルドは不要です。FetchContent による組み込みを参照してください。
cmake -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release32 ビット版が必要な場合は -A Win32 に変更します。ビルド後に build\Release\ctest_cp932_runner.exe が生成されます。
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build buildビルド後に build\ctest_cp932_runner.exe が生成されます。
--codepage N オプションで変換に使うコードページを指定できます。省略した場合はシステムの ANSI コードページ（GetACP()）が使われます。
| コードページ | 言語 |
|---|---|
| 932 | 日本語（CP932 / Windows-31J） |
| 936 | 簡体字中国語（GBK） |
| 949 | 韓国語（EUC-KR 互換） |
| 950 | 繁体字中国語（Big5） |
| 1252 | 西欧（Windows-1252） |
# CP932 を明示指定
add_test(NAME my_test
COMMAND "$<TARGET_FILE:ctest_cp932_runner>" --codepage 932 "$<TARGET_FILE:my_test_exe>"
)
# システムの ANSI コードページを使う（省略時）
add_test(NAME my_test
COMMAND "$<TARGET_FILE:ctest_cp932_runner>" "$<TARGET_FILE:my_test_exe>"
)自分のプロジェクトの CMakeLists.txt に以下を追加します。
include(FetchContent)
FetchContent_Declare(
ctest_cp932_runner
GIT_REPOSITORY https://github.com/neige68/ctest_cp932_runner
GIT_TAG v1.0.0
)
FetchContent_MakeAvailable(ctest_cp932_runner)
enable_testing()
add_test(NAME my_test
COMMAND "$<TARGET_FILE:ctest_cp932_runner>" --codepage 932 "$<TARGET_FILE:my_test_exe>"
)enable_testing()
add_test(NAME my_test
COMMAND "C:/tools/ctest_cp932_runner.exe" --codepage 932 "$<TARGET_FILE:my_test_exe>"
)テストプロセスへの引数はそのまま渡されます。スペースを含む引数は自動的にクォートされます。
add_test(NAME my_test
COMMAND "$<TARGET_FILE:ctest_cp932_runner>"
--codepage 932
"$<TARGET_FILE:my_test_exe>"
--input "path with spaces/data.txt"
--verbose
)