Selecting entire function definition in Vim

FunctionVimSelectDefinition

Function Problem Overview


I've been trying Vim for any text editing work for almost a week now. I want to know the fastest way to select a C function definition.

For example, if I have a function like this:

void helloworlds( int num )
{
    int n;
    for ( n = 0; n < num; ++n ) {
        printf( "Hello World!\n" );
    }
}

How would I be able to delete the whole definition including the function name?

Function Solutions


Solution 1 - Function

As is common in Vim, there are a bunch of ways!

Note that the first two solutions depend on an absence of blank lines.

  • If your cursor is on the line with the function name, try d}. It will delete everything to the next block (i.e. your function body).

  • Within the function body itself, dap will delete the 'paragraph'.

  • You can delete a curly brace block with da}. (If you like this syntax, I recommend Tim Pope's fantastic surround.vim, which adds more features with a similar feel).

  • You could also try using regular expressions to delete until the next far left-indented closing curly brace: d/^}Enter

  • ]] and [[ move to the next/previous first-column curly brace (equivalent to using / and ? with that regex I mentioned above. Combine with the d motion, and you acheive the same effect. In addons like Python-mode, these operators are redefined to mean exactly what you're looking for: move from function to function.

How to delete the whole block, header included

If you're on the header/name, or the line before the block, da} should do the trick.

If you're below a block, you can also make use of the handy 'offset' feature of a Vim search. d?^{?-1 will delete backwards to one line before the first occurrence of a first-column opening curly brace. This command's a bit tricky to type. Maybe you could make a <leader> shortcut out of it.

Plugins

I don't do much C programming in Vim, but there are surely plugins to help with such a thing. Try Vim Scripts or their mirror at GitHub.

Solution 2 - Function

To delete an entire function, including its definition, such as:

function tick() {
		// ... 
}
  • Move to the line with the function name.
  • Move the cursor to the opening brace, f{ should do it, or simply $.
  • Press V%d (Visual line, move to matching pair, delete)

If your functions look like this:

function tick() 
{
		// ... 
}
  • Move to the line with the function name.
  • Press J (join the current line with line bellow. This also puts your cursor at the last character on the resulting line, {, just the one we need for the next command.)
  • Press V%d (Visual line, move to matching pair, delete.)

or

  • Move to the line with the function name.
  • Press V[Down]%d (Visual line, move one line down, move to matching pair, delete.)

Solution 3 - Function

If you are willing to install plugins vim-textobj-function will give you vif for Visual select Inside Function and vaf for Visual select A Function.

daf will delete the function, both the line with the signature and the function body ({})

The text object defined by this plugin are more specific and they don't rely on the function body being a contiguous block of text or { being placed at the first character on the line.

The drawback is that you depend on an external plugin.

Solution 4 - Function

You can use this shortcut to delete not only the function, also the lines between curly braces, i.e the code between if-else statements,while,for loops ,etc.

Press Shitf + v [Will get you in visual Mode] at the curly brace start/end.

Then Press ] + } i.e ] + Shitf ] - If you are in start brace.

Then Press [ + { i.e [ + Shitf [ - If you are in end brace.

Then DEL to delete the lines selected.

Solution 5 - Function

Use this simple way

   1.Go to the function definition 
   2.dd  - delete function definition 
   3.d    -start delete operation 
   4.shift+5(%) - delete the lines between { to }

Solution 6 - Function

The simplest and most direct way way is as follows (works anywhere inside function):

v   enter visual mode
{   move to first brace in function (may have to press more than once)
o   exchange cursor from top to bottom of selection
}   extend selection to bottom of function
d   delete selected text

The complete command sequence would be v{o}d. Note that you can do other operations besides delete the same way. For example, to copy the function, use y (yank) instead of d.

Solution 7 - Function

If your function were separated by the blank lines, just type:

dip

which means "delete inner paragraph".

Solution 8 - Function

Another way is to go to the line of the start of your function and hit: Vj% (or V%% if your style puts the opening brace on the same line). This puts you into Visual-Line mode and the percent takes you to the matching closing brace. In the second style, the first % takes you to the opening brace on the line that you selected and the second to its matching closing brace.

Also works for parentheses, brackets, C-style multi-line comments and preprocessor directives.

See the manual for more info.

Solution 9 - Function

Pre-condition: be somewhere inside the function. Go to the previous closing curly bracket on the first line using

[]

Then delete down to the next closing curly bracket on the first line using

d][

Solution 10 - Function

Most posted methods have a downside or two. Usually, when working withing a class definition of some object oriented language, you might not have an empty line after the function body, because many code formatters put the closing braces of last method and class on consecutive lines. Also, you might have annotations on top of the function. To make matters worse, there might be empty lines within your function body. Additionally you'd prefer a method that works with the cursor anywhere within the function, because having to move it to a specific line or worse, character, takes valuable time. Imagine something like

public class Test {

    /* ... */

    @Test
    public void testStuff() {
        // given
        doSetup();

        // when
        doSomething();

        // then
        assertSomething();
    }
}

In this scenario, vap won't do you any good, since it stops at the first empty line within your function. v{o} is out for the same reason. va{V is better but doesn't catch the annotation on top of the method. So what I would do in the most general case is va{o{. va{ selects the whole function body (caveat: if your cursor is within a nested block, for instance an inner if statement, then you'll only get that block), o puts the cursor to the beginning of the selection and { selects the whole paragraph prepending your selection. This means you'll get the function definition, all annotations and doc comments.

Solution 11 - Function

non-visual way:

d/^}/e

... delete by searching for } at line beining, including it for deletion.

without /e (not mentioned in above answers), solution is incomplete.

with /e - searching goes to end of match, so closing bracket is included, and command is well for yanking too:

y/^}/e

Solution 12 - Function

if you use neovim version :>0.5
the modern way is to use treesitter and build your model, then you can be selected or yanked or deleted...

> Tree-sitter is a parser generator tool and an incremental parsing library. It can build a concrete syntax tree for a source file and efficiently update the syntax tree as the source file is edited

I suggested this video on youtube to learn how to use treesitter to build your model : Let's create a Neovim plugin using Treesitter and Lua

Solution 13 - Function

I tried all the top answers here, but none of them works except the one by Nick which suggests to press f{ to get to the opening curly brace. Then V%d to delete the whole function.

Note that, the whole function gets yanked, so you can paste it elsewhere. I come across this use-case frequently, especially when moving if blocks inside another.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionJacky BoenView Question on Stackoverflow
Solution 1 - FunctionDavid CainView Answer on Stackoverflow
Solution 2 - FunctionNick ZalutskiyView Answer on Stackoverflow
Solution 3 - FunctionRubenLagunaView Answer on Stackoverflow
Solution 4 - FunctionManikandaraj SrinivasanView Answer on Stackoverflow
Solution 5 - FunctionKalanidhiView Answer on Stackoverflow
Solution 6 - FunctionTyler DurdenView Answer on Stackoverflow
Solution 7 - FunctionwzFelixView Answer on Stackoverflow
Solution 8 - FunctiongvkvView Answer on Stackoverflow
Solution 9 - FunctionHopeView Answer on Stackoverflow
Solution 10 - FunctionYasammezView Answer on Stackoverflow
Solution 11 - FunctionAsain KujovicView Answer on Stackoverflow
Solution 12 - FunctionnextloopView Answer on Stackoverflow
Solution 13 - FunctionflipcoinView Answer on Stackoverflow