Jump to Functions

2.6 Jump to Functions

When a source file is opened, it automatically recognizes the currently selected characters or the word at the caret position as the function name and jumps to the first executable line of the target function.

Select [Jump to Function] from the context menu after moving the caret to the target function 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]

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

Remark

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

Figure 2.14

Jump to Functions

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

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.

(b)	When [No] is specified with the [Output cross reference information] property of the build tool

-	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 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").