TotalView Users Guide - CI Wiki

Changing a Variable’s Data Type
Type String Language Size Description
$wchar_u16 C 16 bits wide character whose storage is
unsigned 16 bits
$wchar_s32 C 32 bits wide character whose storage is
signed 32 bits
$wchar_u32 C 32 bits wide character whose storage is
unsigned 32 bits
$wstring C platform-specific Platform-specific string
composed of $wchar characters
$wstring_s16 C 16 bits String composed of $wchar_s16
characters (not currently used
by any platform)
$wstring_u16 C 16 bits String composed of
$wchar_u16 characters
$wstring_s32 C 32 bits String composed of $wchar_s32
characters
$wstring_u32 C 32 bits String composed of
$wchar_u32 characters
Viewing Character Arrays ($string Data Type)
If you declare a character array as char vbl[n], TotalView automatically
changes the type to $string[n]; that is, a null-terminated, quoted string with
a maximum length of n. This means that TotalView displays an array as a
quoted string of n characters, terminated by a null character. Similarly,
TotalView changes char* declarations to $string* (a pointer to a null-terminated
string).
Since most character arrays represent strings, the TotalView $string type
can be very convenient. But if this isn’t what you want, you can edit the
$string and change it back to a char (or char[n]), to display the variable as
you declared it.
Viewing Wide Character Arrays ($wchar Data Types)
If you create an array of wchar_t wide characters, TotalView automatically
changes the type to $wstring[n]; that is, it is displayed as a null-terminated,
quoted string with a maximum length of n. For an array of wide characters,
the null terminator is L’0’. Similarly, TotalView changes wchar_t* declarations
to $wstring* (a pointer to a null-terminated string). (See Figure 202
on page 319.)
This figure shows the declaration of two wide characters in the Process
Window. The Expression List Window shows how TotalView displays their
data. The L in the data indicates that TotalView is displaying a wide literal.
Since most wide character arrays represent strings, the $wstring type can
be very convenient. But if this isn’t what you want, you can edit the
$wstring and change it back to a wchar_t (or wchar[n] or $wchar or
$wchar[n]), to display the variable as you declared it.
318 Chapter 14: Examining and Changing Data