Rust: What is the difference between notify and notify_waiters?

notify — wake one waiter. notify_waiters — wake all waiters.

notify:

• Wake one.
• May not wake waiters.
• For single wakeup.

notify_waiters:

• Wake all.
• Always wakes waiters.
• For broadcast.

1use tokio::sync::Notify;
2
3let notify = Notify::new();
4
5// notify: wake one
6notify.notify_one();
7
8// notify_waiters: wake all
9notify.notify_waiters();

Key: notify for single, notify_waiters for all.