Jump to Functions or Variables

2.6 Jump to Functions or Variables

While a source file is open in the Editor panel, you can make CS+ recognize the currently selected string or the word at the position of the caret as a function or variable name and jump to the corresponding function or variable.

After a jump, the name of the given function or variable is indicated as being selected. If the compiler has not output cross-reference information, however, the jump to a function will be to the first line of executable code within the function, and jumping to variables will not work.

Select [Jump to Function or Variable] from the context menu after moving the caret to the target function or variable on the source text.

Caution 1.

When multiple statements are described in a line, a jump to an illegal location may be made.

Caution 2.

For C++ source files [CC-RX]
The following notes apply to the selection of functions within C++ source files if CC-RX is in use.

-	When a given character string does not fully specify the desired function, jumping may not be possible or the jump may actually be to a different function with the same name.

-	Member functions in classes The name of the class to which the target function belongs must be included. When other functions have the same name as the target function but the arguments are different, also include the argument types.

-	Functions defined in namespaces The full name of the namespace to which the target function belongs must be included. When other functions have the same name as the target function but the arguments are different, also include the argument types.

-	Template functions The types of the arguments must be included in the case of functions generated by the compiler.

Caution 3.

A jump to a variable is only possible when the compiler has output cross-reference information.

Remark

The judgement of words will depend on the build tool being used.

Figure 2.14

Jump to Functions or Variables

Note that this function is available only when the following conditions are satisfied for each specific build tool.

(1)	When CC-RH/CC-RX/CC-RL is used

(a)	When [Yes(-Xcref)][CC-RH][CC-RX]/[Yes(-cref)][CC-RL] is specified with the [Output cross reference information] property of the build tool

-	Run and complete a build.

Remark 1.

If functions with the same name exist, then the Jump to Function dialog box will be opened, and you can select the jump destination function.

Remark 2.

When a function and a variable with the same name exist, the jump to the function takes precedence.

(b)	When [No] is specified with the [Output cross reference information] property of the build tool, the scope of the operation becomes only functions, not variables

-	When disconnected from the debug tool:

-	The type of the project specified as the active project is "Application".

-	The target function is a global function.

-	The target function is defined in a file that is specified as the first file in the [Download files] property in the [Download] category on the [Download File Settings] tab of the Property panel. In addition, the file includes the symbol information.

-	When connected to the debug tool and downloaded the load module file:

-	The downloaded load module file includes the symbol information for the function.

-	Calling the target function from the file corresponding to the address of the program counter (PC). For example, a jump to a static function defined other than in the file corresponding to the address of the program counter (PC) is not possible.

(2)	When an external build tool is used, the scope of the operation becomes only functions, not variables

-	The target function resides in an active project. In case it is disconnected from the debug tool, a jump to a static function cannot be made.

A file with the symbol informationNote is specified with the [Download files] property in the [Download] category on the [Download File Settings] tab of the Property panel. In case it is disconnected from the debug tool, the above file is specified as the first file in the [Download files] property.

Note	When the file is in the format other than the load module file, the setting for downloading the symbol information is required (see "CS+ Debug Tool").