try-lock (0.2.5)

Published 2026-03-26 11:04:46 +00:00 by siennathesane

Set up this registry in the Cargo configuration file (for example ~/.cargo/config.toml):

[registry]
default = "gitea"

[registries.gitea]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true

To install the package using Cargo, run the following command:

cargo add try-lock@0.2.5

For more information on the Cargo registry, see the documentation.

A lightweight atomic lock.

TryLock

A light-weight lock guarded by an atomic boolean.

Most efficient when contention is low, acquiring the lock is a single atomic swap, and releasing it just 1 more atomic swap.

Example

use std::sync::Arc;
use try_lock::TryLock;

// a thing we want to share
struct Widget {
    name: String,
}

// lock it up!
let widget1 = Arc::new(TryLock::new(Widget {
    name: "Spanner".into(),
}));

let widget2 = widget1.clone();


// mutate the widget
let mut locked = widget1.try_lock().expect("example isn't locked yet");
locked.name.push_str(" Bundle");

// hands off, buddy
let not_locked = widget2.try_lock();
assert!(not_locked.is_none(), "widget1 has the lock");

// ok, you can have it
drop(locked);

let locked2 = widget2.try_lock().expect("widget1 lock is released");

assert_eq!(locked2.name, "Spanner Bundle");

lock atomic

Details

Cargo

2026-03-26 11:04:46 +00:00

1

Sean McArthur <sean@seanmonstar.com>

Project Site

Repository Site

Documentation Site

MIT

4.0 KiB

Assets (1)

try-lock-0.2.5.crate 4.0 KiB

Versions (1) View all

0.2.5

2026-03-26

try-lock (0.2.5)

Installation

About this package

TryLock

Example

Keywords