Table of Contents
#What are WaitGroups?
How to use WaitGroups
Why use WaitGroups instead of channels?
One thing to note
Summary
Home Backend Development Golang What are WaitGroups in go language? how to use?

What are WaitGroups in go language? how to use?

Mar 17, 2023 pm 08:09 PM
go golang go language waitgroups

What are WaitGroups? The following article will take you to understand WaitGroups in the go language and introduce how to use WaitGroups. I hope it will be helpful to you!

What are WaitGroups in go language? how to use?

#What are WaitGroups?

WaitGroups is an efficient way to synchronize your goroutines. Imagine you are traveling by car with your family. Your dad stops at a strip mall or fast food restaurant to buy some food and use the bathroom. You'd better want to wait until everyone gets back before driving to Horizon. WaitGroups helps you do this.

WaitGroups is defined by calling the sync package in the standard library.

var wg sync.WaitGroup
Copy after login

So, what is WaitGroup? WaitGroup is a structure that contains certain information about how many goroutine the program needs to wait for. It is a group containing the number of goroutines you need to wait for.

WaitGroups has three most important methods: Add, Done and Wait.

  • Add: Add to the total number of goroutines you need to wait for.
  • Done: Subtract one from the total number of goroutines you need to wait for.
  • Wait: Blocks the code from continuing until there are no more goroutines to wait for.

How to use WaitGroups

Let’s take a look at a piece of code:

package main

import (
    "fmt"
    "sync"
    "time"
)

func main() {
    var wg sync.WaitGroup
    wg.Add(1)

    go func() {
        defer wg.Done()

        fmt.Println(time.Now(), "start")
        time.Sleep(time.Second)
        fmt.Println(time.Now(), "done")
    }()

    wg.Wait()
    fmt.Println(time.Now(), "exiting...")
}
Copy after login
2022-08-21 17:01:54.184744229 +0900 KST m=+0.000021800 start
2022-08-21 17:01:55.184932851 +0900 KST m=+1.000210473 done
2022-08-21 17:01:55.18507731 +0900 KST m=+1.000354912 exiting...
Copy after login
  • We first initialize a WaitGroup Instance of wg.
  • Then we add 1 to wg because we want to wait for a goroutine to complete.
  • Then we run this goroutine. Inside the goroutine, we make a delayed call to wg.Done() to ensure that we decrement the number of goroutine to wait for. If we don't do this, then the code will wait forever for the goroutine to complete and will cause a deadlock.
  • After the goroutine call, we want to make sure to block the code until WaitGroup is empty. We do this by calling wg.Wait().

Why use WaitGroups instead of channels?

Now that we know how to use WaitGroups, a natural thought leads us to this question: Why use WaitGroups instead of channels?

Based on my experience, there are several reasons.

  • WaitGroups tends to be more intuitive. When you read a piece of code, when you see a WaitGroup, you immediately know what the code is doing. The method names are clear and get to the point. However, with channels, sometimes it's not so clear. Using channels is smart, but when you read a complex piece of code, it can be cumbersome to understand.
  • Sometimes, you don't need to use channels. For example, let's take a look at this code:
 var wg sync.WaitGroup

  for i := 0; i < 5; i++ {
      wg.Add(1)
      go func() {
          defer wg.Done()

          fmt.Println(time.Now(), "start")
          time.Sleep(time.Second)
          fmt.Println(time.Now(), "done")
      }()
  }

  wg.Wait()
  fmt.Println(time.Now(), "exiting...")
Copy after login

You can see that this goroutine does not communicate data with other goroutine. If your goroutine is a one-time job and you don't need to know the result, using WaitGroup is preferable. Now look at this code:

  ch := make(chan int)

  for i := 0; i < 5; i++ {
      go func() {
          randomInt := rand.Intn(10)
          ch <- randomInt
      }()
  }

  for i := 0; i < 5; i++ {
      fmt.Println(<-ch)
  }
Copy after login

Here, goroutine is sending data to channel. In these cases we don't need to use WaitGroup as that would be redundant. If the receive has already done enough blocking, why wait for the goroutine to complete?

WaitGroups is specially used to handle waiting for goroutines. I think the main purpose of channels is to communicate data. You can't use WaitGroup to send and receive data, but you can use a channel to synchronize your goroutines.

Finally, there is no right answer. I know this can be annoying, but it depends on you and the team you work for. Whatever method is best, no answer is wrong. I personally prefer to use WaitGroups for synchronization, but your situation may be different. Choose what feels most intuitive to you.

One thing to note

Sometimes, you may need to pass a WaitGroup instance to a goroutine. There may be several WaitGroup to handle different goroutine, or it may be a design choice. Whatever the reason, make sure to pass a pointer to WaitGroup, like this:

var wg sync.WaitGroup

for i := 0; i < 5; i++ {
    wg.Add(1)
    go func(wg *sync.WaitGroup) {
        defer wg.Done()

        fmt.Println(time.Now(), "start")
        time.Sleep(time.Second)
        fmt.Println(time.Now(), "done")
    }(&wg)
}

wg.Wait()
fmt.Println(time.Now(), "exiting...")
Copy after login

The reason is that Go is a pass-by-value language. This means that whenever you pass an argument to a function, Go copies the argument and passes it instead of the original object. What happens in this case is that the entire WaitGroup object will be copied, which means that the goroutine will handle a completely different WaitGroup. wg.Done() does not subtract from the original wg, but subtracts a copy of it, which only exists in goroutine.

Summary

By using WaitGroups, we can easily synchronize goroutines, ensuring that our code is executed at the correct time. Although channels can also be used for synchronization, WaitGroups are generally more intuitive and easier to read. When using WaitGroup, be sure to pass the pointer to WaitGroup correctly to prevent copy issues. No matter which method you choose, choose the one that's most intuitive and works best for you and your team.

Recommended learning: Golang tutorial

The above is the detailed content of What are WaitGroups in go language? how to use?. For more information, please follow other related articles on the PHP Chinese website!

Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Hot AI Tools

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Undress AI Tool

Undress AI Tool

Undress images for free

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Roblox: Bubble Gum Simulator Infinity - How To Get And Use Royal Keys
4 weeks ago By 尊渡假赌尊渡假赌尊渡假赌
Nordhold: Fusion System, Explained
4 weeks ago By 尊渡假赌尊渡假赌尊渡假赌
Mandragora: Whispers Of The Witch Tree - How To Unlock The Grappling Hook
3 weeks ago By 尊渡假赌尊渡假赌尊渡假赌

Hot Tools

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use

Zend Studio 13.0.1

Zend Studio 13.0.1

Powerful PHP integrated development environment

Dreamweaver CS6

Dreamweaver CS6

Visual web development tools

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

Hot Topics

Java Tutorial
1670
14
PHP Tutorial
1276
29
C# Tutorial
1256
24
How to solve the user_id type conversion problem when using Redis Stream to implement message queues in Go language? How to solve the user_id type conversion problem when using Redis Stream to implement message queues in Go language? Apr 02, 2025 pm 04:54 PM

The problem of using RedisStream to implement message queues in Go language is using Go language and Redis...

What should I do if the custom structure labels in GoLand are not displayed? What should I do if the custom structure labels in GoLand are not displayed? Apr 02, 2025 pm 05:09 PM

What should I do if the custom structure labels in GoLand are not displayed? When using GoLand for Go language development, many developers will encounter custom structure tags...

Golang's Purpose: Building Efficient and Scalable Systems Golang's Purpose: Building Efficient and Scalable Systems Apr 09, 2025 pm 05:17 PM

Go language performs well in building efficient and scalable systems. Its advantages include: 1. High performance: compiled into machine code, fast running speed; 2. Concurrent programming: simplify multitasking through goroutines and channels; 3. Simplicity: concise syntax, reducing learning and maintenance costs; 4. Cross-platform: supports cross-platform compilation, easy deployment.

Which libraries in Go are developed by large companies or provided by well-known open source projects? Which libraries in Go are developed by large companies or provided by well-known open source projects? Apr 02, 2025 pm 04:12 PM

Which libraries in Go are developed by large companies or well-known open source projects? When programming in Go, developers often encounter some common needs, ...

In Go programming, how to correctly manage the connection and release resources between Mysql and Redis? In Go programming, how to correctly manage the connection and release resources between Mysql and Redis? Apr 02, 2025 pm 05:03 PM

Resource management in Go programming: Mysql and Redis connect and release in learning how to correctly manage resources, especially with databases and caches...

Golang vs. Python: Performance and Scalability Golang vs. Python: Performance and Scalability Apr 19, 2025 am 12:18 AM

Golang is better than Python in terms of performance and scalability. 1) Golang's compilation-type characteristics and efficient concurrency model make it perform well in high concurrency scenarios. 2) Python, as an interpreted language, executes slowly, but can optimize performance through tools such as Cython.

Do I need to install an Oracle client when connecting to an Oracle database using Go? Do I need to install an Oracle client when connecting to an Oracle database using Go? Apr 02, 2025 pm 03:48 PM

Do I need to install an Oracle client when connecting to an Oracle database using Go? When developing in Go, connecting to Oracle databases is a common requirement...

How to ensure concurrency is safe and efficient when writing multi-process logs? How to ensure concurrency is safe and efficient when writing multi-process logs? Apr 02, 2025 pm 03:51 PM

Efficiently handle concurrency security issues in multi-process log writing. Multiple processes write the same log file at the same time. How to ensure concurrency is safe and efficient? This is a...

See all articles