Work the Shell - Conditional Statements and Flow Control

January 2nd, 2006 by Dave Taylor in

IF you need conditions in your scripts, THEN this is the column for you.
Your rating: None Average: 3 (1 vote)

The last of the basic building blocks of shell scripting are conditional statements, allowing you to decide programmatically whether to execute a block of statements based on a logical test, and flow control statements, the great innovation from the earliest days of programming where you could have a block of code execute more than once. We explore both of these in this column and, finally, are done with the proverbial Lego blocks of scripting, allowing us to start exploring how to solve complex scripting problems with novel and unique combinations of simple statements.

The most obvious conditional statement is if-then-else, which in shell scripting looks like:

if condition ; then ; statements ; else ; statements2 ; fi

Of course, you'd usually see this on multiple lines, so it's more likely to look like this:

if condition; then
  statements
else
  statements2
fi

There are some variations on this, including safely omitting any sort of else clause, but more interestingly, you can “chain” conditionals together with an else if structure:

if condition; then
  statements
elif condition2 ; then
  statements2
fi

That's perfectly valid and, worth noting, functionally different from the structure:

if condition
then
  statements
  if condition2; then
      statements2
  fi
fi

The difference will be obvious to anyone who has programmed before. In the first example, statements2 would execute if condition was false and condition2 were true. In the latter example, however, statements2 would be executed only if condition were true and condition2 were true. Subtle, but very important!

Specific logical conditions can take on a wide variety of appearances, because the only requirement for a conditional expression is that it return zero if the evaluated condition is false and nonzero if it should be considered true. Indeed, there are commands in Linux called false and true, so you can use statements like “if true; then....” Most conditions, however, are built around the invaluable test command, with its many different flags and options.

Want to compare two string (text) values? You could use:

if  test $myvar = "exit" ; then

or its shortcut alternative of:

if [ $myvar = "exit" ] ; then

Compare two numeric values with:

if test $numval -lt 10 ; then

There's also a world of file and variable tests available in the test command too, including -r to test if a file is readable, -e to see if it exists at all, -s to see if the file exists and has a nonzero size, and -d to test for a directory and -f to test for a regular file.

So if you want to differentiate whether $filename is a file, directory or other file type, you could use a statement sequence like:

if test -f $filename ; then
  echo "$filename is a regular file"
elif test -d $filename ; then
  echo "$filename is a directory"
else
  echo "$filename is neither a file nor a directory."
fi

Check out the test man page (use man test) to read about all the many different conditionals you can use in a shell script.

Flow Control

There are a number of different looping and flow control structures above and beyond simply the if-then-else conditional, luckily, and here are the big three:

  • for x in y; do; statements; done

  • while x; do; statements; done

  • case x in ; condition1) statements ;; condition2) statements ;; esac

There are more conditional statements, but you'll find that in the vast majority of cases, having for loops, while loops, case statements and if-then-else statements will serve as the building blocks of even the most complex script.

The for loop is particularly useful in its variations. Want to step through the parameters given to the shell script itself? Use something like this:

for value ; do ; statements ; done

Want to step through a set of matching filenames for a given pattern? Here's how to do that in a script:

for filename in *.c ; do
  statements
done

Let's look at how a couple of these can be combined in useful ways, rather than just duplicate the man page, however. Here's a simple script that examines each entry in the current directory, indicating whether it's a file or directory:

for name in *
do
  if [ -f "$name" ] ; then
    echo "$name is a file"
  elif [ -d "$name" ] ; then
    echo "$name is a directory"
  else
    echo "$name is neither a file nor directory"
  fi
done

For illustrative purposes, let's try another version of this script, one that recognizes *.c as C source files, *.h as included header files and *.o as intermediate object files, but this time we'll use the case statement:

for name in *
do
  case "$name" in
    *.c ) echo "$name is a C source file"       ;;
    *.h ) echo "$name is a header file"         ;;
    *.o ) echo "$name is an object file"        ;;
  esac
done

From a readability perspective, the case statement is hard to beat!

Wrapping Up

There are, of course, many different ways to create more-advanced and sophisticated scripts, notably including shell script functions, but we'll delve into those as we proceed. I'm a big fan of just doing rather than talking around the topic forever.

I hope that's enough on the basics of flow control and conditional expression evaluation in this column. If you've some questions, don't forget that man sh produces more information on the power and capabilities of the Bourne Shell.

I don't know about you, but I'm eager to get moving onto some more complex and interesting scripting tasks, and I invite you to let me know via e-mail if there are specific types of scripts that you're interested in seeing featured here.

Dave Taylor is a 25-year veteran of UNIX, creator of The Elm Mail System and most recently author of both the best-selling Wicked Cool Shell Scripts and Teach Yourself Unix in 24 Hours, among his 16 technical books. His main Web site is at www.intuitive.com.

__________________________


Special Magazine Offer -- 2 Free Trial Issues!
Receive 2 free trial issues of Linux Journal as well as instant online access to current and past issues. There's NO RISK and NO OBLIGATION to buy. CLICK HERE for offer

Linux Journal: delivering readers the advice and inspiration they need to get the most out of their Linux systems since 1994.

Sorry, offer available in the US only. International orders, click here.

Featured Videos

Email is one of the least private and least secure forms of communication, although few people realize this. MixMaster is one way to allow secure, anonymous communication even over the very public medium of email. This tutorial will get you started with MixMaster quickly and easily.

In case you were wondering about the fun side of Linux World Expo, we thought we'd give you a peek at our shenanigans. We at Linux Journal love what we do so much, that we can't help but have a ball wherever we go.

From the Magazine

September 2008, #173

Feeling a bit like a Thermian? Never give up, never surrender! Someday, you could go from underdog to top dog. Just take a look at a few of the underdogs we highlight in this issue: Mutt, djbdns, Nginix, Gentoo, Xara and the program voted mostly likely to fail just a few years back—Firefox. If Firefox not radical enough for you, check out Chef Marcel's column for some more alternatives. Having trouble mapping your program data to your relational database? If so, Rueven Lerner shows you some tricks in his At The Forge column.

Need to run GUI applications on your server in the next state? In his Paranoid Penguin column, Mick Bauer shows you how to do it securely. Kyle Rankin keeps hacking and slashing and shows you a few split screen secrets you may not be familiar with. Finally, we all know what happens next February, but only Doc knows what happens afterward.

Read this issue