SysTutorials

How to Check if a Function Is Defined in Bash

· Eric Ma

To check whether a function exists in Bash, use the type builtin with the -t option. This returns a string identifying what the name is: alias, keyword, function, builtin, or file.

Basic Check

The simplest approach:

if [[ $(type -t f1) == "function" ]]; then
    echo "f1 is defined as a function"
fi

This works because type -t returns the type on stdout. If the name doesn’t exist, it outputs nothing and returns a non-zero exit code.

Handling Errors with set -e

If you’re running with set -o errexit (or set -e), a command that fails will exit the script. To prevent that when checking a potentially undefined function, suppress the error:

if [[ $(type -t f1 2>/dev/null) == "function" ]]; then
    echo "f1 is defined as a function"
fi

The 2>/dev/null redirects stderr to silence the “not found” message.

Alternative: Direct Exit Code Check

You can also check the exit code directly without capturing output:

if type -t f1 &>/dev/null; then
    echo "f1 is defined"
fi

This is cleaner when you only care whether something exists, not its type.

Distinguishing Between Types

Since type -t returns different strings, you can check for specific types:

name_type=$(type -t f1 2>/dev/null)

case "$name_type" in
    function)
        echo "f1 is a function"
        ;;
    builtin)
        echo "f1 is a builtin command"
        ;;
    alias)
        echo "f1 is an alias"
        ;;
    file)
        echo "f1 is a file (executable in PATH)"
        ;;
    *)
        echo "f1 is not defined"
        ;;
esac

Full Type Information

For more details than just the type, use type without -t:

type f1

This outputs something like:

f1 is a function
f1 () 
{ 
    echo "Hello from f1"
}

This is useful for debugging or seeing the full function definition.

Practical Example: Conditional Function Definition

A common pattern is defining a function only if it doesn’t already exist:

if [[ $(type -t my_func 2>/dev/null) != "function" ]]; then
    my_func() {
        echo "Default implementation"
    }
fi

This allows sourcing a script multiple times or layering function definitions without duplicates.

Checking Multiple Functions

To verify that all required functions are defined before proceeding:

required_functions=(func1 func2 func3)
missing=()

for func in "${required_functions[@]}"; do
    if [[ $(type -t "$func" 2>/dev/null) != "function" ]]; then
        missing+=("$func")
    fi
done

if [[ ${#missing[@]} -gt 0 ]]; then
    echo "Error: Missing functions: ${missing[*]}" >&2
    exit 1
fi

This pattern is valuable in scripts that depend on function libraries being sourced first.

2026 Best Practices

This article extends “How to Check if a Function Is Defined in Bash” with practical guidance. Modern development practices emphasize security, performance, and maintainability. Follow these guidelines to build robust, production-ready systems.

2026 Comprehensive Guide for Bash

This article extends “How to Check if a Function Is Defined in Bash” with advanced techniques and best practices for 2026. Following modern guidelines ensures reliable, maintainable, and secure systems.

Advanced Implementation Strategies

For complex deployments involving bash, consider Infrastructure as Code for reproducible environments, container-based isolation for dependency management, and CI/CD pipelines for automated testing and deployment.

Security and Hardening

Security should be built into workflows from the start. Use strong authentication methods, encrypt sensitive data, and follow the principle of least privilege for access controls.

Performance Optimization

Troubleshooting Methodology

Follow a systematic approach to debugging: reproduce issues, isolate variables, check logs, test fixes. Keep detailed logs and document solutions found.

Best Practices

Resources and Further Reading

For more information on bash, consult official documentation and community resources. Stay updated with the latest tools and frameworks.

← All posts