Rust: What is the difference between Mutex::lock and Mutex::try_lock?

lock — blocking lock. try_lock — immediate lock attempt.

lock:

• Blocks until acquired.
• Always succeeds.
• For blocking code.

try_lock:

• Returns immediately.
• May fail.
• For non-blocking.

1use std::sync::Mutex;
2
3let m = Mutex::new(5);
4
5// Blocking
6let mut data = m.lock().unwrap();
7*data = 10;
8drop(data);
9
10// Non-blocking
11if let Ok(mut data) = m.try_lock() {
12    *data = 20;
13}

Key: lock for blocking, try_lock for non-blocking.