Visual Studio デバッガーでの書式指定子 (C++)

書式指定子を使用して、[ウォッチ]、[自動変数]、[ローカル] の各ウィンドウに表示される値の書式を変更することができます。

また、[イミディエイト] ウィンドウ、[コマンド] ウィンドウ、トレースポイント、ソースのウィンドウでも、書式指定子を使用できます。 これらのウィンドウで式の上にカーソルを合わせると、結果が [データヒント] に表示されます。 [データヒント] の表示には、書式指定子が反映されます。

Note

Visual Studio のネイティブ デバッガーが新しいデバッグ エンジンに変更されたときに、新しい書式指定子がいくつか追加され、古いものがいくつか削除されました。 C++/CLI で相互運用 (ネイティブ コードとマネージド コードの混合) をデバッグする場合は、以前のデバッガーが引き続き使用されます。

書式指定子の設定

次のコード例を使用します。

int main() {
    int my_var1 = 0x0065;
    int my_var2 = 0x0066;
    int my_var3 = 0x0067;
}

デバッグ中に my_var1 変数をウォッチ ウィンドウに追加します ([デバッグ]>[Windows]>[ウォッチ]>[ウォッチ 1])。 次に、変数を右クリックし、[16 進数で表示] を選択します。 これで、ウォッチ ウィンドウに値 0x0065 が示されます。 この値を整数ではなく文字として表示するには、最初に右クリックして [16 進数で表示] を選択解除します。 次に、文字書式指定子 , c を、[Name] 列の変数名の後に追加します。 [Value] 列に 101 'e' が表示されるようになります。

ウォッチ ウィンドウの値にコンマ (,) を追加することで、使用できる書式指定子の一覧を表示して選択できます。

書式指定子

次の表で、Visual Studio で使用できる書式指定子を説明します。 太字で示されている指定子は、新しいデバッガーでのみサポートされており、C++/CLI を使用した相互運用機能デバッグではサポートされていません。

指定子	形式	元の [ウォッチ] の値	表示される値
d	10 進整数	0x00000066	102
o	符号なし 8 進整数。	0x00000066	000000000146
x h	16 進整数	102	0xcccccccc
X H	16 進整数	102	0xcccccccc
xb hb	16 進数の整数 (先頭 0x なし)	102	cccccccc
Xb Hb	16 進数の整数 (先頭 0x なし)	102	CCCCCCCC
b	符号なし 2 進整数	25	0b00000000000000000000000000011001
bb	符号なし 2 進整数 (先頭 0b なし)	25	00000000000000000000000000011001
e	指数表記	25000000	2.500000e+07
g	指数表記と浮動小数点のうちの短い方	25000000	2.5e+07
c	1 文字	0x0065	101 'e'
s	const char* 文字列 (引用符あり)	<場所> "hello world"	"hello world"
sb	const char* 文字列 (引用符なし)	<場所> "hello world"	Hello World
s8	UTF-8 文字列	<場所> "This is a UTF-8 coffee cup ☕"	"This is a UTF-8 coffee cup ☕"
s8b	UTF-8 文字列 (引用符なし)	<場所> "hello world"	Hello World
su	Unicode (UTF-16 エンコード) 文字列 (引用符あり)	<場所> L"hello world"	L"hello world" u"hello world"
sub	Unicode (UTF-16 エンコード) 文字列 (引用符なし)	<場所> L"hello world"	Hello World
bstr	BSTR バイナリ文字列 (引用符あり)	<場所> L"hello world"	L"hello world"
env	環境ブロック (2 つの null で終了する文字列)	<場所> L"=::=::\\"	L"=::=::\\\0=C:=C:\\windows\\system32\0ALLUSERSPROFILE=...
s32	UTF-32 文字列 (引用符あり)	<場所> U"hello world"	u"hello world"
s32b	UTF-32 文字列 (引用符なし)	<場所> U"hello world"	Hello World
en	enum	Saturday(6)	土曜日
hv	ポインター型。検査されるポインター値が配列のヒープ割り当ての結果であることを意味します (たとえば、 new int[3])。	<位置>{<最初のメンバー>}	<位置>{<最初のメンバー>, <2 番目のメンバー>, ...}
na	オブジェクトのポインターのメモリ アドレスを非表示にします。	<位置>, {member=value...}	{member=value...}
nd	基底クラスの情報だけを表示し、派生クラスは無視します。	(Shape*) square には基底クラスおよび派生クラスの情報が含まれます。	基底クラスの情報だけを表示します。
時間	HRESULT または Win32 エラー コード。 この指定子は、デバッガーによって自動的にデコードされるため、HRESULT では不要になりました。	S_OK	S_OK
wc	Windows クラス フラグ	0x0010	WC_DEFAULTCHAR
wm	Windows メッセージ番号	16	WM_CLOSE
nr	"未加工ビュー" 項目の抑制
nvo	数値に対してのみ "未加工ビュー" 項目を表示する
!	データ型の表示カスタマイズをすべて無視した、未処理の書式。	<カスタマイズされた表現>	4
ハンドル	win32 ハンドルに関する情報を表示します	0x000000000000009c	スレッド ID など、ハンドルに関する有用な情報を表示します。

Note

hv 書式指定子が存在する場合、デバッガーはバッファーの長さを判断してその要素の数を表示しようと試みます。 デバッガーは配列の正確なバッファー サイズを常に判断できるとは限らないため、可能な場合には必ずサイズ指定子 (pBuffer,[bufferSize]) を使用してください。 hv 書式指定子は、バッファー サイズをすぐに利用できない場合に役立ちます。

配列としてのポインターのサイズ指定子

オブジェクトに対するポインターを配列として表示する場合、整数または式で配列要素数を指定できます。

指定子	形式	元の [ウォッチ] の値	表示される値
n	10 進数または 16 進数 の整数	pBuffer,[32] pBuffer,[0x20]	pBuffer を 32 要素の配列として表示します。
[exp]	整数に評価される有効な C++ 式	pBuffer,[bufferSize]	pBuffer を bufferSize 要素の配列として表示します。
expand(n)	整数に評価される有効な C++ 式	pBuffer, expand(2)	pBuffer の 3 番目の要素を表示します

C++/CLI での相互運用機能デバッグ用の書式指定子

指定子	形式	元の [ウォッチ] の値	表示される値
o	符号なし 8 進整数。	0xF065	0170145
x X	16 進整数	61541	0x0000f065
c	1 文字	<location>	101 'e'
s	const char* (引用符あり)	<location>	"hello world"
su	const wchar_t* const char16_t* (引用符あり)	<location>	L"hello world"
sub	const wchar_t* const char16_t*	<location>	Hello World
s8	const char* (引用符あり)	<location>	"hello world"
時間	HRESULT または Win32 エラー コード。 この指定子は、デバッガーによって自動的にデコードされるため、HRESULT では不要になりました。	S_OK	S_OK
wc	Windows クラス フラグ	0x00000040,	WC_DEFAULTCHAR
wm	Windows メッセージ番号	0x0010	WM_CLOSE
!	データ型の表示カスタマイズをすべて無視した、未処理の書式	<カスタマイズされた表現>	4

ネイティブおよび C++/CLI コードの d、e、f、g、h、i、l、m、ma、mb、md、mq、mu、mw、および u 指定子には、Visual Studio 2022 以降のバージョンではサポートされていないレガシ デバッガーが必要でした。

C++/CLI を使用した相互運用デバッグでの配列としてのポインターのサイズ指定子

オブジェクトに対するポインターを配列として表示する場合、整数で配列要素数を指定できます。

指定子	形式	式	表示される値
n	10 進整数	pBuffer[32]	pBuffer を 32 要素の配列として表示します。