Everything
2.21.1 Input rule

Following is the rules for input to each panel and dialog box.

(1)

Character set

Character sets that are allowed to input are as follows:

Table 2.28

List of Character Set

Character Set

Outline

ASCII

1- byte alphabets, numbers, symbols.

Shift-JIS

2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji and 1-byte Katakana.

EUC-JP

2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji and 1-byte Katakana.

UTF-8

2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.

UTF-16 (Unicode)

2-byte alphabet, number, symbol, Hiragana, Katakana, Kanji (include Chinese characters) and 1-byte Katakana.

(2)

Escape sequence

Escape sequences that are allowed to input are as follows:

Table 2.29

Escape Sequence List

Escape sequence

Value

Description

\0

0x00

null character

\a

0x07

Alert

\b

0x08

Backspace

\t

0x09

Horizontal tab

\n

0x0A

New line

\v

0x0B

Vertical tab

\f

0x0C

Form feed

\r

0x0D

Carriage return

\"

0x22

Double-quotation mark

\'

0x27

Single-quotation mark

\?

0x3F

Question mark

handled as a question mark if ? is entered.

\\

0x5C

Backslash

(3)

Number

Notations allowed when entering numbers are as follows:

Table 2.30

Notation List

Notation

Outline

Binary number

Starts with 0b and continues with the numbers from 0 to 1.

(Case insensitive for alphabets)

Octal number

Starts with 0 and continues with the numbers from 0 to 7.

Decimal number

Starts without 0 and continues with the numbers from 0 to 9.

Hexadecimal number

Starts with 0x and continues with the numbers from 0 to 9 and alphabets a to f.

(Case insensitive for alphabets)

In the input area with the mark, prefix 0x is not needed.

(4)

Expression and operator

Expression represents constants, CPU register name, I/O register name and symbols and those connected with operators.

An expression comes in two types: an address expression and a watch-expression. The expression that requires the address of a symbol is referred to as an address expression, and the one that requires the value of a symbol is referred to as a watch-expression.

(a)

An address expression and operators

With an address expression, the address of a symbol is used to perform operations. Only when a CPU register name is written, the value of the symbol is used to perform operations.

The basic input formats of address expressions are as follows:

Table 2.31

Basic Input Format of Address Expressions

Expression

Description

C/C++ variable name Note 1 No 2

Address of a C/C++ variable

Expression [ExpressionNote 3]

Address of an array

Expression.Member nameNote 4

Address of a structure/union/class member

Expression->Member nameNote 4

Address of a structure/union/class member that is pointed to

Watch-expression.*Cast expression

Address of the pointer to a member variable

Watch-expression->*Cast expression

Address of the pointer to a member variable

CPU register name

Value of a CPU register

I/O register name

Address of an I/O register

Label nameNote 5, EQU symbol nameNote 5, [immediate value]

Address of a label, a value of an EQU symbol, and an immediate address

Integer constant

Address

Note 1.

It represents C89, C99 and C++ variables.

Note 2.

If the register is assigned the value of a C variable, an error results.

Note 3.

The expression that is input as an index to an array is parsed as a watch-expression.

Note 4.

To specify a member variable of base class, specify scope before a member name.
(Example: variable.BaseClass::member)

Note 5.

If a label name or EQU symbol name contains a "$," enclose the name in braces "{ }."
(Example: {$Label})
When you specify the CPU register name "I", add ":REG" (e.g. I:REG) to distinguish it from the keyword "I" that indicates an imaginary number.

 

From "Table 2.31 Basic Input Format of Address Expressions", the following address expressions with operator can be constructed.

Table 2.32

Construction of Address Expressions with Operators

Expression

Description

(Expression)

Specifies the order in which operations are performed

-Expression

Inverts sign

!Expression

Logical negation

~Expression

Bit inversion

Expression * ExpressionNote

Multiplication

Expression / ExpressionNote

Division

Expression % ExpressionNote

Remainder calculation

Expression + ExpressionNote

Addition

Expression - ExpressionNote

Subtraction

Expression & ExpressionNote

Bit-wise logical AND

Expression ^ ExpressionNote

Bit-wise logical exclusive OR

Expression | ExpressionNote

Bit-wise logical (inclusive) OR

Note

Variables and functions can be combined by an operator only with variables, functions and integer constants. (Example: C variable name + I/O register name)

(b)

Watch-expression and operator

With watch-expression, the value of a symbol is used to perform operations. Only when the value does not exist, the address of the symbol is used to perform operations. (Example: main( ) + 1)

The basic input formats of watch-expressions are as follows:

Table 2.33

Basic Input Format of Watch-expressions

Expression

Description

C/C++ variable nameNote 1

Value of a C/C++ variable

Expression[Expression]

Element values of an array

Expression.Member nameNote 2

Member values of a structure/union/class

Expression->Member nameNote 2

Member values of the structure/union/class pointed to by a pointer

Watch-expression.*Cast expression

Value of a pointer to member variable

Watch-expression->*Cast expression

Value of a pointer to member variable

*Expression

Value of pointer variable

&Expression

Location address

CPU register name

Value of a CPU register

I/O register name

Value of an I/O register

Label nameNote 3, EQU symbol nameNote 3, [immediate value]

Value of a label, value of an EQU symbol, value of an immediate address

Integer constant

Constant value of an integer

Floating constant

Constant value of a floating point

Character constant

Constant value of a character

Note 1.

It represents C89, C99 and C++ variables.

Note 2.

To specify a member variable of base class, specify scope before a member name.
(Example: variable.BaseClass::member)

Note 3.

If a label name or EQU symbol name contains a "$," enclose the name in braces "{ }."
(Example: {$Label})
Any imaginary number must be multiplied by an uppercase "I" (e.g. 1.0 + 2.0*I). When you specify the CPU register name "I", add ":REG" (e.g. I:REG) to distinguish it from the keyword "I" that indicates an imaginary number.

 

From "Table 2.33 Basic Input Format of Watch-expressions", the following watch-expressions with operator can be constructed. For the operators listed in the table below, the expression is parsed according to C language specifications.

Table 2.34

Construction of Watch-expressions with Operators

Expression

Description

(Expression)

Specifies the order in which operations are performed

!Expression

Logical negation

~Expression

Bit inversion

Expression * ExpressionNote

Multiplication

Expression / ExpressionNote

Division

Expression % ExpressionNote

Remainder calculation

Expression + ExpressionNote

Addition

Expression - ExpressionNote

Subtraction

Expression & ExpressionNote

Bit-wise logical AND

Expression ^ ExpressionNote

Bit-wise logical exclusive OR

Expression | ExpressionNote

Bit-wise logical (inclusive) OR

Note

Variables and functions can be combined by an operator only with variables, functions and integer constants. (Example: C variable name + I/O register name)

 

Caution 1.

When two or more variables are defined with the same name in unnamed name spaces of different source files, the Watch panel only shows the information on the first variable to be found.

Caution 2.

After the member-variable pointer "mp1" defined in the program below is registered with the Watch panel and Local Variables panel, the type of the pointer is indicated as "int *", not "int Foo::*".

class Foo {
    int m1;
};
int Foo::*mp1 = &Foo::m1;

Caution 3.

When a char-type one-dimensional array is assigned to multiple locations in registers or memory as shown below, no character string will be displayed in the value column of the Watch panel or Local Variables panel even after the array "array" has been registered with the panel.
char array[5] = "ABCD";

Caution 4.

When the selection for [Scope] in the Local Variables panel is not [Current], the values of variables assigned to registers are not displayed correctly. Editing these values is also not possible.

Caution 5.

When a defined variable satisfies both of the conditions given below, the Watch panel and Local Variables panel indicate the location of the entire variable rather than the location of its member variables.

[Conditions]

<1>

The variable is assigned to two or more addresses or registers (i.e. two or more addresses or registers are displayed in the address column).

<2>

A structure-, class-, array-, or union-type member is defined in the variable.

 

[Example]

struct Mem {
    long m_base;
};
struct Sample {
    long m_a;
    struct Mem m_b; <- Condition <2>
};
 
main () {
    struct Sample obj;
}

 

Display in the Watch and Local Variables panels:

"obj"                        -    { R1:REG, R2:REG }      (struct Sample)
    L m_a           0x00000000    { R1:REG }              (long)
    L m_b                    -    { R1:REG, R2:REG }      (struct Base)
        L m_base    0x00000000    { R2:REG }              (long)

 

Caution 6.

When a variable is cast to another type in the Watch panel, casting of the variable is C-style.
For this reason, the result of casting a class using virtual inheritance to its base class is not the same as the result of the cast within the program.

class AAA [
    int m_aaa;
} objA;
class BBB : public AAA {  //BBB inherits AAA.
    int m_bbb;
} objB;
class CCC {  //CCC does not inherit AAA.
    int m_ccc;
} objC
 
class AAA* pa = objA;
class BBB* pb = objB;
class CCC* pc = objC;
 
"(AAA*)pa"  Usable
"(BBB*)pb"  Usable
"(AAA*)pb"  Usable
"(CCC*)pc"  Usable
"(AAA*)pc"  Not usable because pc is considered to point to the top address of AAA.
Image of the cast in a program: (AAA*)((void*)pc)

Caution 7.

In case of a variable with the size beyond 0x10000, Value, Style and Address indicate "?" in the Watch panel.