The CFUNC macro is an outliner that opens a window to list each function definition found in your C program source file. You can select a function from this list and hit enter to jump to it's location, or you can just peek at the function definition and return to your original location.
While in CFUNC window, you can use the following keys:
| Up, Down | Select a function. |
|---|---|
| Left or Right | Show function in source code but stay in Cfunc. |
| Enter | Go to function in source code, exit Cfunc. |
| Esc or F12 | Cancel. Exit Cfunc and return to original location. |
| Alt-Left Alt-Right |
Scroll function list window horisontally. |
| Page Up Page Dn |
Move one page up/down in function list window. |
| Home | Move to top of function list. |
| End | Move to end of function list. |
| F1 | Show this help page. |
| F2 | Open configuration dialog box (see below). |
| Backspace | Clear search (see below) |
| Other keys | Enter search string (see below). |
If your source file contains lots of functions, you can use incremental search to find the correct one.
Just start typing text that is part of the function name or parameter name you are looking for. Cfunc jumps to first function that contains the search string. Type more text to narrow the search. Those lines that do not contain match change to syntax highlight "comment" color.
You can then jump between the matching functions by using Up/Down keys or any other keys in the table above. Press backspace to clear the search.
Note: each line begins with space. If you want to search for function that begins with specific string, start the search string with space. Pattern matching codes can be used, too.
You can change the way Cfunc operates by changing some configuration settings. Press F2 to open the configuration dialog box. The dialog box contains the following fields:
| Window Color: | Enter a numeric value of color to be used in Cfunc window. The color values are same as those in Config -> Editing colors dialog. For example, 32 = Black on green, 48 = Black on cyan. |
| Update edit window: | If set, the source code edit window is automatically updated
every time you move cursor in the function list window. If not set, the edit window is updated only when you request update by pressing left or right key. |
| Show return-type: | If set, the return-type (e.g. int or void) on the function definition is displayed in the function list window. If not set, only function name and parameters are displayed. |
The configuration settings are stored in file CFUNC.INI in USER-MAC directory.