Formatbezeichner für C++ im Visual Studio-Debugger

Mit Formatbezeichnern können Sie das Format ändern, in dem ein Wert in den Fenstern Überwachung, Auto und Lokal angezeigt wird.

Formatbezeichner können auch im Fenster Direkt, im Fenster Befehl, in Ablaufverfolgungspunkten und sogar in Quellcodefenstern verwendet werden. Wenn Sie einen Ausdruck in diesen Fenstern anhalten, wird das Ergebnis in einem DataTip angezeigt. Die DataTip-Anzeige entspricht dem Formatbezeichner.

Hinweis

Wenn der native Debugger von Visual Studio in eine neue Debug-Engine geändert wurde, wurden einige neue Formatbezeichner hinzugefügt, während einige alte Bezeichner entfernt wurden. Der ältere Debugger wird weiterhin verwendet, wenn Sie das Interop-Debuggen (systemeigen und verwaltet) mit C++/CLI durchführen.

Festlegen von Formatbezeichnern

Wir verwenden den folgenden Beispielcode:

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

Fügen Sie beim Debuggen dem Fenster Überwachung die Variable my_var1 hinzu, Debuggen>Fenster>Überwachung>Überwachen 1. Klicken Sie dann mit der rechten Maustaste auf die Variable, und wählen Sie Hexadezimale Anzeige aus. Im Fenster Überwachung wird jetzt der Wert 0x0065 angezeigt. Um diesen Wert als ein Zeichen und nicht als Integer auszudrücken, klicken Sie zunächst mit der rechten Maustaste, und deaktivieren Sie Hexadezimale Anzeige. Fügen Sie dann den Zeichenformatbezeichner , c in der Spalte Name nach dem Variablennamen hinzu. In der Spalte Wert wird jetzt 101 'e' angezeigt.

Sie können eine Liste der verfügbaren Formatbezeichner anzeigen und Formatbezeichner darin auswählen, indem Sie an den Wert im Fenster Überwachung ein Komma (,) anfügen.

Formatbezeichner

Die folgenden Tabellen beschreiben die Formatbezeichner, die Sie in Visual Studio verwenden können. Fett formatierte Bezeichner werden nur für den neuen Debugger unterstützt und nicht für das Interop-Debuggen mit C++/CLI.

Bezeichner	Format	Ursprünglicher Wert in "Überwachen"	Angezeigter Wert
T	Ganze Dezimalzahl	0x00000066	102
o	Oktale ganze Zahl ohne Vorzeichen	0x00000066	000000000146
w h	Ganze Hexadezimalzahl	102	0xcccccccc
X H	Ganze Hexadezimalzahl	102	0xcccccccc
xb hb	Ganze Hexadezimalzahl (ohne vorangestelltes 0x)	102	cccccccc
Xb Hb	Ganze Hexadezimalzahl (ohne vorangestelltes 0x)	102	CCCCCCCC
k	Binäre ganze Zahl ohne Vorzeichen	25	0b00000000000000000000000000011001
bb	Binäre ganze Zahl ohne Vorzeichen (ohne vorangestelltes 0b)	25	00000000000000000000000000011001
e	Wissenschaftliche Schreibweise	25000000	2.500000e+07
g	Kürzere Variante aus wissenschaftlicher oder Gleitkommaschreibweise	25000000	2.5e+07
c	Einzelnes Zeichen	0x0065	101 'e'
s	const char*-Zeichenfolge (mit Anführungszeichen)	<Speicherort> "hello world“	"hello world"
sb	const char*-Zeichenfolge (ohne Anführungszeichen)	<Speicherort> "hello world“	hello world
s8	UTF-8-Zeichenfolge	<Speicherort> „This is a UTF-8 coffee cup ☕“	"This is a UTF-8 coffee cup ☕"
s8b	UTF-8-Zeichenfolge (ohne Anführungszeichen)	<Speicherort> "hello world“	hello world
su	Unicode-Zeichenfolge (UTF-16-Codierung mit Anführungszeichen)	<Speicherort> L“hello world“	L"hello world" u"hello world"
sub	Unicode-Zeichenfolge (UTF-16-Codierung ohne Anführungszeichen)	<Speicherort> L“hello world“	hello world
bstr	BSTR-Binärzeichenfolge (mit Anführungszeichen)	<Speicherort> L“hello world“	L"hello world"
env	Umgebungsblock (doppelt nullterminierte Zeichenfolge)	<Speicherort> L“=::=::\\“	L"=::=::\\\0=C:=C:\\windows\\system32\0ALLUSERSPROFILE=...
s32	UTF-32-Zeichenfolge (mit Anführungszeichen)	<Speicherort> U“hello world"	u"hello world"
s32b	UTF-32-Zeichenfolge (ohne Anführungszeichen)	<Speicherort> U“hello world"	hello world
en	enum	Samstag(6)	Samstag
hv	Zeigertyp - gibt an, dass der überprüfte Zeigerwert das Ergebnis der Heapzuweisung eines Arrays ist, z. B. new int[3].	<Speicherort>{<Erster Member>}	<Speicherort>{<Erster Member>, <zweiter Member>, ...}
na	Unterdrückt die Speicheradresse eines Zeigers auf ein Objekt.	<Speicherort>, {member=value…}	{member=value...}
nd	Es werden nur die Basisklasseninformationen angezeigt, die abgeleiteten Klassen werden ignoriert.	(Shape*) square enthält die Basisklassen- und abgeleitete Klasseninformationen	Zeigt nur Basisklasseninformationen an
hr	HRESULT oder Win32-Fehlercode. Dieser Bezeichner wird nicht mehr für HRESULTs benötigt, da er vom Debugger automatisch decodiert wird.	S_OK	S_OK
wc	Fensterklassenflag	0x0010	WC_DEFAULTCHAR
wm	Windows-Meldungsnummern	16	WM_CLOSE
nr	"Raw View"-Element unterdrücken
nvo	"Raw View"-Element nur für numerische Werte anzeigen
!	Rohdatenformat, jegliche Ansichtsanpassungen für den Datentyp werden ignoriert.	<Benutzerdefinierte Darstellung>	4
Handlebezeichner	Zeigt Informationen zum Win32-Handle an.	0x000000000000009c	Zeigt nützliche Informationen zum Handle wie Thread-ID usw. an.

Hinweis

Wenn der Formatbezeichner hv vorhanden ist, versucht der Debugger, die Länge des Puffers zu bestimmen, und zeigt die betreffende Anzahl von Elementen an. Da der Debugger nicht immer die exakte Puffergröße eines Arrays finden kann, sollten Sie möglichst immer einen Größenbezeichner (pBuffer,[bufferSize]) verwenden. Der Formatbezeichner hv ist nützlich, wenn die Puffergröße nicht unmittelbar verfügbar ist.

Größenbezeichner für Zeiger als Arrays

Wenn Sie über einen Zeiger für ein Objekt verfügen, das Sie als Array anzeigen möchten, können Sie eine ganze Zahl oder einen Ausdruck verwenden, um die Anzahl von Arrayelementen zu bestimmen.

Bezeichner	Format	Ursprünglicher Wert in "Überwachen"	Angezeigter Wert
n	Dezimalzahl oder ganze Hexadezimalzahl	pBuffer,[32] pBuffer, [0x20]	Zeigt pBuffer als Array mit 32 Elementen an.
[exp]	Ein gültiger C++-Ausdruck, der für eine ganze Zahl ausgewertet wird.	pBuffer,[bufferSize]	Zeigt pBuffer als Array von bufferSize Elementen an.
expand(n)	Ein gültiger C++-Ausdruck, der für eine ganze Zahl ausgewertet wird	pBuffer, expand(2)	Zeigt das dritte Element von pBuffer an

Formatbezeichner für das Interop-Debuggen mit C++/CLI

Bezeichner	Format	Ursprünglicher Wert in "Überwachen"	Angezeigter Wert
o	Oktale ganze Zahl ohne Vorzeichen	0xF065	0170145
w X	Ganze Hexadezimalzahl	61541	0x0000f065
c	Einzelnes Zeichen	<location>	101 'e'
s	const char* (mit Anführungszeichen)	<location>	"hello world"
su	const wchar_t* const char16_t* (mit Anführungszeichen)	<location>	L"hello world"
sub	const wchar_t* const char16_t*	<location>	hello world
s8	const char* (mit Anführungszeichen)	<location>	"hello world"
hr	HRESULT oder Win32-Fehlercode. Dieser Bezeichner wird nicht mehr für HRESULTs benötigt, da er vom Debugger automatisch decodiert wird.	S_OK	S_OK
wc	Fensterklassenflag	0x00000040,	WC_DEFAULTCHAR
wm	Windows-Meldungsnummern	0x0010	WM_CLOSE
!	Rohdatenformat, jegliche Ansichtsanpassungen für den Datentyp werden ignoriert	<Benutzerdefinierte Darstellung>	4

Die Spezifizierer d, e, f, g, h, i, l, m, ma, mb, md, mq, mu, mw und u für nativen und C++/CLI-Code erforderten den Legacy-Debugger, der in Visual Studio 2022 oder späteren Versionen nicht unterstützt wird.

Größenbezeichner für Zeiger als Arrays beim Interop-Debuggen mit C++/CLI

Wenn Sie einen Zeiger für ein Objekt haben, das Sie als Array anzeigen möchten, können Sie eine ganze Zahl verwenden, um die Anzahl von Arrayelementen zu bestimmen.

Bezeichner	Format	expression	Angezeigter Wert
n	Ganze Dezimalzahl	pBuffer[32]	Zeigt pBuffer als Array mit 32 Elementen an.