Структура OnceCell

Создает новый пустой экземпляр OnceCell.

Создает новый пустой экземпляр OnceCell.

Эквивалентно OnceCell::new, за исключением того, что его можно использовать в статических переменных.

При использовании нестабильной функции tracing экземпляр OnceCell, созданный с помощью const_new, не будет инструментирован. Поэтому он не будет виден в tokio-console. Если требуется создать инструментированный объект, следует использовать OnceCell::new.

Пример

use tokio::sync::OnceCell;

static ONCE: OnceCell<u32> = OnceCell::const_new();

async fn get_global_integer() -> &'static u32 {
    ONCE.get_or_init(|| async {
        1 + 1
    }).await
}

let result = get_global_integer().await;
assert_eq!(*result, 2);

Создает новый OnceCell, содержащий заданное значение, если оно указано.

Если Option — это None, данный вызов эквивалентен OnceCell::new.

Создает новый OnceCell, содержащий заданное значение.

Пример

При использовании нестабильной функции tracing экземпляр OnceCell, созданный с помощью const_new_with, не будет инструментирован. Поэтому он не будет виден в tokio-console. Если требуется создать инструментированный объект, следует использовать OnceCell::new_with.

use tokio::sync::OnceCell;

static ONCE: OnceCell<u32> = OnceCell::const_new_with(1);

async fn get_global_integer() -> &'static u32 {
    ONCE.get_or_init(|| async {
        1 + 1
    }).await
}

let result = get_global_integer().await;
assert_eq!(*result, 1);

Возвращает true, если OnceCell в данный момент содержит значение, и false в противном случае.

Возвращает ссылку на значение, хранящееся в данный момент в OnceCell, или None, если OnceCell пуст.

Возвращает изменяемую ссылку на значение, хранящееся в данный момент в OnceCell, или None, если OnceCell пуст.

Поскольку этот вызов получает изменяемое заимствование OnceCell, значение внутри OnceCell можно безопасно изменять — изменяемое заимствование статически гарантирует отсутствие других ссылок.

Устанавливает для OnceCell заданное значение, если OnceCell пуст.

Если OnceCell уже содержит значение, этот вызов завершится ошибкой SetError::AlreadyInitializedError.

Если OnceCell пуст, но другая задача в данный момент пытается установить значение, этот вызов завершится ошибкой SetError::InitializingError.

Возвращает текущее значение из OnceCell или инициализирует его с помощью заданной асинхронной операции.

Если другая задача в данный момент инициализирует OnceCell, этот вызов дождется ее завершения, а затем вернет полученное ею значение.

Если предоставленная операция отменяется или вызывает панику, попытка инициализации отменяется. Если другие задачи ожидают инициализации значения, одна из них начнет новую попытку инициализации.

Это приведет к взаимной блокировке, если f попытается рекурсивно инициализировать ячейку.

Возвращает текущее значение в OnceCell или инициализирует его с помощью указанной асинхронной операции.

Если другая задача в данный момент инициализирует OnceCell, этот вызов дождётся завершения другой задачи, а затем вернёт значение, полученное в результате её работы.

Если указанная операция возвращает ошибку, отменяется или вызывает панику, попытка инициализации отменяется. Если другие задачи ожидают инициализации значения, одна из них начнёт новую попытку его инициализации.

Это приведёт к взаимной блокировке, если f попытается рекурсивно инициализировать ячейку.

Извлекает значение из ячейки, уничтожая её в процессе. Возвращает None, если ячейка пуста.

Забирает во владение текущее значение, оставляя ячейку пустой. Возвращает None, если ячейка пуста.

Возвращает аргумент без изменений.

Вызывает U::from(self).

То есть это преобразование выполняет то, что выберет реализация From<T> for U.