Code Folding

What is code folding?

Code folding is a feature of the MPLAB® X editor that makes it possible to collapse (hide) and expand parts of a file, making it easier to focus just on the parts of interest. In general, any code block surrounded by braces '{' and '}' will be collapsible. This includes function bodies, compound statements and also groups of compiler directives. Code folds may be nested, providing a high degree of control over which parts of a file are visible at any one time. Code folding is configurable to include or exclude numerous code structures and also provides a means of creating custom code folds to hide and reveal any part of a file you desire.

How to use code folding

On the far left of the editor window, immediately to the right of the glyph margin, you will see some small boxes with either a '+' or a '-' inside them. When a block is expanded, you will see a '-' that may be clicked to collapse the code. Likewise, when the code is collapsed, clicking on the '+' will expand it.

Function Unfolded:

FunctionUnfolded.png

Function Folded:

FunctionFolded.png

How to configure code folding options

General code folding is enabled by default, but many of its features are not. To change code folding options (or disable it altogether if you are so inclined) do the following:

1

Go to the menu Tools ► Options

2

In the window that opens, select the Editor icon Tools_Options_Editor.png from the top.

3

Select the General tab.

4

Check or uncheck each item under the Code Folding section as desired.

CodeFoldingOptions.png
Click image to enlarge.

How to create custom code folds in C

Sometimes, you may want to collapse sections of code that are not automatically detected as are function bodies and other blocks within braces. To do this, there are special comments that may be used to force the editor to create a collapsible block, set its default state and even provide a label to be displayed when it is collapsed.
To create a custom code fold, use the following comment tags around your code like this:

// <editor-fold defaultstate="collapsed" desc="user-description">
Code to collapse here...
// </editor-fold>

(Note the '/' inside the ending </editor-fold> tag.)

Instead of typing in the tags shown above, you can take advantage of code templates and simply type in fcom followed by the TAB key, and both the <editor-fold…> and the </editor-fold> tags will automatically appear.


Code Expanded:

Selection_001.png

Code Collapsed:

Selection_002.png

The above example is simplistic so that it can easily be seen on one screen. You can have as much code or other text between the two comment tags as you like.

How to create custom code folds in MPASM

(Not supported yet…)

© 2024 Microchip Technology, Inc.
Notice: ARM and Cortex are the registered trademarks of ARM Limited in the EU and other countries.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.