91

How do I show the definition of a function in zsh? type foo doesn't give the definition.

In bash:

bash$ function foo() { echo hello; }

bash$ foo
hello

bash$ type foo
foo is a function
foo () 
{ 
    echo hello
}

In zsh:

zsh$ function foo() { echo hello; }

zsh$ foo
hello

zsh$ type foo
foo is a shell function
1
  • 1
    declare -f foo is the better choice even in bash - and it works in zsh too; see my answer for background.
    – mklement0
    Nov 13, 2014 at 14:53

4 Answers 4

124

The zsh idiom is whence, the -f flag prints function definitions:

zsh$ whence -f foo
foo () {
    echo hello
}
zsh$

In zsh, type is defined as equivalent to whence -v, so you can continue to use type, but you'll need to use the -f argument:

zsh$ type -f foo
foo () {
    echo hello
}
zsh$

And, finally, in zsh which is defined as equivalent to whence -c - print results in csh-like format, so which foo will yield the same results.

man zshbuiltins for all of this.

9
  • 1
    "whence" just returns the name of the function. It does not show the function definition. Jul 13, 2012 at 21:38
  • 2
    @RobBednark look more closely: -f is used in the answer, which does print function definitions
    – pb2q
    Jul 13, 2012 at 21:39
  • type -f foo also does this; type is equivalent to whence -v. Jul 13, 2012 at 21:48
  • I see, "whence -f foo" does give the behavior that I'm looking for. Equivalent to Thor's "which foo". Jul 13, 2012 at 21:49
  • @pb2q, nice details for the 3 different ways, as well as the reference. Thanks! Jul 14, 2012 at 13:53
31

I've always just used which for this.

2
  • 6
    "which" gives the behavior I'm looking for -- thanks Thor! (Note that "which" is a zsh builtin whereas in bash it calls /usr/bin/which , and /usr/bin/which has different behavior than the zsh builtin function "which") Jul 13, 2012 at 21:44
  • 2
    Works, but only if no alias of the same name happens to be defined, in which case that is reported (which reports the highest-precedence form of the command).
    – mklement0
    Nov 13, 2014 at 14:28
23

tl;dr

declare -f foo  # works in zsh and bash

typeset -f foo  # works in zsh, bash, and ksh

If you don't mind or prefer including all command forms that exist for a given name in the output:Thanks, Raine Revere.

type -af  # zsh only (works differently in bash and ksh)

type -f / whence -f / which are suboptimal in this case, because their purpose is to report the command form with the highest precedence that happens to be defined by that name - as opposed to specifically reporting on the operand as a function.

That said, in practice this means that only an alias of the same name takes precedence (and technically also a shell keyword, though naming functions for shell keywords is probably a bad idea anyway).

Note that zsh does expand aliases in scripts by default (as does ksh, but not bash), and even if you turn alias expansion off first, type -f / whence -f / which still report aliases first.

In zsh, the -f option only includes shell functions in the lookup in zsh, so - unless -a is also used to list all command forms - an alias by the given name would print as the only output.

In bash and ksh, type -f actually excludes functions from the lookup; whence doesn't exist in bash, and in ksh it doesn't print the function definition; which is not a builtin in ksh and bash, and the external utility by definition cannot print shell functions.

1
  • 1
    Thanks, @RaineRevere; I've added your suggestion to the top section of the answer and added a clarification to the bottom section.
    – mklement0
    Jan 23, 2021 at 20:26
9

If you're not quite sure what you are looking for, you can type just

functions

and it will show you all the defined functions.

Note that there are sometimes a LOT of them, so you might want to pipe to a pager program:

functions | less

to undefine a function, use

unfunction functionname
1
  • 1
    +1; Note that functions is equivalent to typeset -f (except for the -M option), so you can even use the grammatically slightly counter-intuitive command functions foo to get information about a given function.
    – mklement0
    Nov 13, 2014 at 14:58

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.