Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Avoid checking if error is nil repetition?

Tags:

go

I'm currently learning go and some of my code looks like this:

a, err := doA()
if err != nil {
  return nil, err
}
b, err := doB(a)
if err != nil {
  return nil, err
}
c, err := doC(b)
if err != nil {
  return nil, err
}
... and so on ...

This looks kinda wrong to me because the error checking takes most of the lines. Is there a better way to do error handling? Can I maybe avoid this with some refactoring?

UPDATE: Thank you for all the answers. Please note that in my example doB depends on a, doC depends on b and so on. Therefore most suggested refactorings don't work in this case. Any other suggestion?

like image 307
Baju Avatar asked Sep 12 '13 18:09

Baju


People also ask

What is if err != Nil?

if err := doStuff(); err != nil { // handle the error here } The first bit of the if is known as an initialization statement, and it can be used to setup local variables. For functions that only return an error, the initialization statement is an incredibly useful tool.

How should you log an error err in Go?

Errors can be returned as nil , and in fact, it's the default, or “zero”, value of on error in Go. This is important since checking if err != nil is the idiomatic way to determine if an error was encountered (replacing the try / catch statements you may be familiar with in other programming languages).

How do you handle errors in Golang?

The idiomatic way of handling errors in Go is to compare the returned error to nil . A nil value indicates that no error has occurred and a non-nil value indicates the presence of an error. In our case, we check whether the error is not nil in line no. 10.

Does Golang support exception handling?

Go doesn't have exceptions, so it doesn't have try… catch or anything similar.


3 Answers

This is a common complaint, and there are several answers to it.

Here are a few common ones:

1 - It's not so bad

This is a very common reaction to these complaints. The fact you have a few extra lines of code in your code is not in fact so bad. It's just a bit of cheap typing, and very easy to handle when on the reading side.

2 - It's actually a good thing

This is based on the fact that typing and reading these extra lines is a very good reminder that in fact your logic might escape at that point, and you have to undo any resource management that you've put in place in the lines preceding it. This is usually brought up in comparison with exceptions, which can break the flow of logic in an implicit way, forcing the developer to always have the hidden error path in mind instead. Some time ago I wrote a more in-depth rant about this here.

3 - Use panic/recover

In some specific circumstances, you may avoid some of that work by using panic with a known type, and then using recover right before your package code goes out into the world, transforming it into a proper error and returning that instead. This technique is seen most commonly to unroll recursive logic such as (un)marshalers.

I personally try hard to not abuse this too much, because I correlate more closely with points 1 and 2.

4 - Reorganize the code a bit

In some circumstances, you can reorganize the logic slightly to avoid the repetition.

As a trivial example, this:

err := doA() if err != nil {     return err } err := doB() if err != nil {     return err } return nil 

can also be organized as:

err := doA() if err != nil {     return err } return doB() 

5 - Use named results

Some people use named results to strip out the err variable from the return statement. I'd recommend against doing that, though, because it saves very little, reduces the clarity of the code, and makes the logic prone to subtle issues when one or more results get defined before the bail-out return statement.

6 - Use the statement before the if condition

As Tom Wilde well reminded in the comment below, if statements in Go accept a simple statement before the condition. So you can do this:

if err := doA(); err != nil {     return err } 

This is a fine Go idiom, and used often.

In some specific cases, I prefer to avoid embedding the statement in this fashion just to make it stand on its own for clarity purposes, but this is a subtle and personal thing.

like image 113
Gustavo Niemeyer Avatar answered Sep 26 '22 00:09

Gustavo Niemeyer


You could use named return parameters to shorten things a bit

Playground link

func doStuff() (result string, err error) {     a, err := doA()     if err != nil {         return     }     b, err := doB(a)     if err != nil {         return     }     result, err = doC(b)     if err != nil {         return     }     return } 

After you've been programming in Go a while you'll appreciate that having to check the error for every function makes you think about what it actually means if that function goes wrong and how you should be dealing with it.

like image 37
Nick Craig-Wood Avatar answered Sep 22 '22 00:09

Nick Craig-Wood


If you have many of such re-occurring situations where you have several of these error checks you may define yourself a utility function like the following:

func validError(errs ...error) error {
    for i, _ := range errs {
        if errs[i] != nil {
            return errs[i]
        }
    }
    return nil
}

This enables you to select one of the errors and return if there is one which is non-nil.

Example usage (full version on play):

x, err1 := doSomething(2)
y, err2 := doSomething(3)

if e := validError(err1, err2); e != nil {
    return e
}

Of course, this can be only applied if the functions do not depend on each other but this is a general precondition of summarizing error handling.

like image 21
nemo Avatar answered Sep 26 '22 00:09

nemo