Passing Input to a Bash Function via Arguments or stdin

Published: Jun 29, 2019
Updated: May 3, 2021

I have a collection of Bash functions that I often use. For some of them, I needed to ability to read input from all of the following:

This was not as straight-forward as I would have hoped. After much trial and error, though, here’s what I came to. We’ll use the length function as an example:

Bash Function #

length() {
  local input=""

  if [[ -p /dev/stdin ]]; then
    input="$(cat -)"

  if [[ -z "${input}" ]]; then
    return 1

  echo "${#input}"

Usage #

It can be used in the following ways:

$ length "hey"
$ echo "hey" | length
$ length <<< echo "hey"

How it Works #

First, check if stdin was given:

[[ -p /dev/stdin ]]

If it was, then read from it:

cat -

If not, then read in all positional arguments:


All of this is assigned to the local variable input. Next, check if input is empty:

[[ -z "${input}" ]]

If it is, then return a non-zero exit code:

return 1

Finally, if input has a value, then get its length:

echo "${#input}"