Learn the coding skills for your next job

How to Make Pure Functions in Golang

Pure functions are often hyped up in the JavaScript world, probably because of the abundance of stateful front end applications. While pure functions have their downsides (i.e. inconvenience, potentially large argument lists), they should be used as much as reasonably possible.

Learn the Go the right way

Go is the language of cloud-native technologies. If you’re interested in modern web systems then our Go Mastery track of courses and projects will give you all the skills you need to have a successful switch.

What is a Pure Function?

According to Wikipedia, a Pure function has the following properties:

  1. Its return value is the always same for the same arguments
  2. Its evaluation has no side effects (no mutation of data outside the function)

Which means that as a developer I know two important things:

  1. When I call a pure function I will get the same result every time
  2. After calling a pure function the rest of my program will be in the same state it was before calling it

Because of these properties, pure functions keep applications simple. As we know, simple applications tend to be faster, are easier to test and debug, and are less error prone in general.

Example in Go

Let’s take a look at an example function. Using Go, we’ll write a countNamesInText function that splits a given string into words delimited by whitespace, then, counts all the words that match a name pulled from the database.

totalCounted := map[string]int{} func countNamesInText(text string) { total := 0 name := getNameFromDatabase() for _, word := range strings.Split(text, " ") { if word == name { total++ } } totalCounted[name] = total }
Code language: Go (go)

This function is impure for a couple reasons. Let’s examine each one.

1. Program state is mutated by calling countNamesInText()

Instead of mutating a global variable as a means of “returning” data to the caller, we should return the data via a return statement:

func countNamesInText(text string) int { totalCounted := 0 name := getNameFromDatabase() for _, word := range strings.Split(text, " ") { if word == name { totalCounted++ } } return totalCounted }
Code language: Go (go)

Now countNamesInText is more “pure” because it will not change the application’s state, though you may have noticed that we still have another problem.

2. Database Argument

countNamesInText is still impure because the “name” value, which affects the result of the function call, is retrieved from a database. In order for our function to be self-contained, that value should instead be passed as a parameter.

Currently, if we wrote the test:

func TestCountNamesInText(t *testing.T) { actual := countNamesInText("this word here") if actual != 2{ t.Errorf("want 2 got %v", actual) } }
Code language: Go (go)

It wouldn’t work consistently. If the database isn’t set up, or if the database was tampered with, our tests will fail. That makes this a bad test, and we wrote the bad test because we have an impure function.

Let’s purify a bit more:

func countNamesInText(text, name string) int { totalCounted := 0 for _, word := range strings.Split(text, " ") { if word == name { totalCounted++ } } return totalCounted }
Code language: Go (go)

Our function is pure, so we can write a good test:

func TestCountNamesInText(t *testing.T) { actual := countNamesInText("this word here", "this") if actual != 1{ t.Errorf("want 1 got %v", actual) } }
Code language: Go (go)

This is what a call to the function in the application might look like:

totalCounted := map[string]int{} name := getNameFromDatabase() totalCounted[name] = countNamesInText("some name in here", name)
Code language: Go (go)

Related Articles

Trying to find your next programming job?

If you are a self-taught developer having trouble finding your first programming job, we've got your back! We have the learning resources and tight-knit dev community that you need to land the coding job you've been looking for. To get started, create a free account and join our Discord community.

Have questions or feedback?

If we've made a mistake in the article, please let us know so we can get it corrected!