Everything
2.20.1 Input rule

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

(1)

Character set

Character sets that are allowed to input are as follows:

Table 2.24

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 Big-Endian

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

UTF-16 Little-Endian

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

UTF-32 Big-Endian

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

UTF-32 Little-Endian

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.25

Escape Sequence List

Escape Sequence

Value

Outline

\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.26

Notation List

Notation

Outline

Binary number

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

(Case insensitive for alphabets)

Octal number

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

Decimal

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

Hexadecimal number

Start 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, register name, SFR 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.27

Basic Input Format of Address Expressions

Expression

Description

Name of a C/C++ language variableNote 1,2

Address of a C/C++ language 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

Name of a CPU register

Value of the CPU register

Name of a SFR

Address of the SFR

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

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

Integer constant

Address

Note 1.

It represents C language (C89/C99) and C++ language 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 the label name or EQU symbol name includes a "$", be sure to enclose the name in "{ }" (e.g. {$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 "2.20.2 Symbol name completion function", the following expressions with operator can be constructed.

Table 2.28

Construction of Expressions with Operators

Expression

Description

(Expression)

Value of the parenthetical watch-expression

! Expression

Inverts symbol

- Expression

Logical negation

~ Expression

Bit inversion

Expression * ExpressionNote

Multiplication

Expression / ExpressionNote

Division

Expression % ExpressionNote

Remainder calculation

Expression + ExpressionNote

Addition

Expression . ExpressionNote

Subtraction

Expression & ExpressionNote

Logical multiplication by bits

Expression ^ ExpressionNote

Exclusive disjunction by bits

Expression | ExpressionNote

Logical sum by bits

Note

Variables and functions can be combined by an operator only with variables, functions and integer constants.
Example: C variable name + SFR 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 (e.g. main( ) + 1).

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

Table 2.29

Basic Input Format of Watch-expressions

Expression

Description

Name of a C/C++ language variableNote 1

Address of a C/C++ language variable

Expression [Expression]

Element of an array

Expression.Member nameNote 2

Value of a structure/union/class member

Expression->Member nameNote 2

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

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

Name of a CPU register

Value of the CPU register

Name of a SFR

Value of the SFR

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

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

Integer constant

Integer constant value

Floating constant

Floating point constant value

Character constant

Character constant value

Note 1.

It represents C language (C89/C99) and C++ language variables.

Note 2.

To specify a member variable of base class, specify scope before a member name.

(Example: variable.BaseClass::member)

Note 3.

If the label name or EQU symbol name includes a "$", be sure to enclose the name in "{ }" (e.g. {$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.29 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.30

Construction of Expressions with Operators

Expression

Description

(Expression)

Specifies the order in which operations are performed

! Expression

Inverts symbol

- Expression

Logical negation

Expression * ExpressionNote

Multiplication

Expression / ExpressionNote

Division

Expression % ExpressionNote

Remainder calculation

Expression + ExpressionNote

Addition

Expression . ExpressionNote

Subtraction

Expression & ExpressionNote

Logical multiplication by bits

Expression ^ ExpressionNote

Exclusive disjunction by bits

Expression | ExpressionNote

Logical sum by bits

Note

Variables and functions can be combined by an operator only with variables, functions and integer constants.
Example: C variable name + SFR 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 DDD {  //DDD virtually inherits AAA.
public:
    int m_ddd;
} objD
 
class AAA* pa = objA;
class BBB* pb = objB;
class CCC* pc = objC;
class DDD* pd = objD;
 
"(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)
"(AAA*)pd"  Not usable because pd is considered to point to the top address of AAA.
Image of the cast in a program: (AAA*)((void*)pd)

Caution 7.

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