Standard library header <stdatomic.h> (C11)

From cppreference.net

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

Содержание

Атомарные операции

Операции над атомарными типами
ATOMIC_BOOL_LOCK_FREE ATOMIC_CHAR_LOCK_FREE ATOMIC_CHAR16_T_LOCK_FREE ATOMIC_CHAR32_T_LOCK_FREE ATOMIC_WCHAR_T_LOCK_FREE ATOMIC_SHORT_LOCK_FREE ATOMIC_INT_LOCK_FREE ATOMIC_LONG_LOCK_FREE ATOMIC_LLONG_LOCK_FREE ATOMIC_POINTER_LOCK_FREE (C11)	указывает, что данный атомарный тип является безблокировочным (макроконстанта)
atomic_is_lock_free (C11)	указывает, является ли атомарный объект свободным от блокировок (функция)
atomic_store atomic_store_explicit (C11)	сохраняет значение в атомарном объекте (функция)
atomic_load atomic_load_explicit (C11)	считывает значение из атомарного объекта (функция)
atomic_exchange atomic_exchange_explicit (C11)	обменивает значение со значением атомарного объекта (функция)
atomic_compare_exchange_strong atomic_compare_exchange_strong_explicit atomic_compare_exchange_weak atomic_compare_exchange_weak_explicit (C11)	заменяет значение атомарного объекта, если старое значение соответствует ожидаемому, в противном случае считывает старое значение (функция)
atomic_fetch_add atomic_fetch_add_explicit (C11)	атомное сложение (функция)
atomic_fetch_sub atomic_fetch_sub_explicit (C11)	атомарное вычитание (функция)
atomic_fetch_or atomic_fetch_or_explicit (C11)	атомное побитовое ИЛИ (функция)
atomic_fetch_xor atomic_fetch_xor_explicit (C11)	атомическое побитовое исключающее ИЛИ (функция)
atomic_fetch_and atomic_fetch_and_explicit (C11)	атомное побитовое И (функция)
Тип флага и операции
atomic_flag (C11)	безблокируемый атомарный булевый флаг (struct)
atomic_flag_test_and_set atomic_flag_test_and_set_explicit (C11)	устанавливает atomic_flag в true и возвращает предыдущее значение (функция)
atomic_flag_clear atomic_flag_clear_explicit (C11)	устанавливает atomic_flag в false (функция)
Инициализация
atomic_init (C11)	инициализирует существующий атомарный объект (функция)
ATOMIC_VAR_INIT (C11) (deprecated in C17) (removed in C23)	инициализирует новый атомарный объект (макрос функции)
ATOMIC_FLAG_INIT (C11)	инициализирует новый atomic_flag (макроконстанта)
Порядок синхронизации памяти
memory_order (C11)	определяет ограничения упорядочения памяти (enum)
kill_dependency (C11)	разрывает цепочку зависимостей для memory_order_consume (функциональный макрос)
atomic_thread_fence (C11)	универсальная примитивная синхронизация барьера, зависящая от порядка памяти (функция)
atomic_signal_fence (C11)	барьер между потоком и обработчиком сигнала, выполняемым в том же потоке (функция)

**Перевод:** **Объяснение:** - Термин `atomic_schar` не переведен, так как это специфический термин C++ - `(C11)` оставлен без перевода, так как это стандартная маркировка версии языка - Ключевые слова C++ `_Atomic`, `signed`, `char` сохранены в оригинале - HTML-теги и атрибуты полностью сохранены - Форматирование и структура HTML остались неизменными **Объяснение перевода:** - HTML-теги и атрибуты сохранены без изменений - Текст внутри тега `


        ` не переведен (`atomic_uchar`)
- Текст внутри тега `
        
         ` не переведен, так как содержит C++ специфичные термины (`_Atomic unsigned char`)
- Переведена только метка версии: `(C11)` → `(C11)` (в данном случае не требует перевода, так как это стандартная версия языка)
- Форматирование полностью сохранено

**Перевод:** **Примечание:** В данном случае переводить нечего, так как: - HTML теги и атрибуты остаются без изменений - Текст внутри тегов `


        ` не переводится
- C++ специфические термины (`atomic_uint`, `_Atomic`, `unsigned int`) не переводятся
- Остальной текст состоит только из версионного маркера "(C11)", который также является технической информацией и не требует перевода

**Примечание:** В данном случае весь текст, который требовалось перевести, уже находится внутри HTML-тегов, которые должны оставаться без изменений (`


        `, `
        
         `). Единственный текст для перевода - это "(C11)", но поскольку он находится внутри тега с классом, указывающим на специфику версии C++, и является стандартным обозначением версии стандарта, его также не следует переводить для сохранения технической точности.

**Примечание:** В данном случае весь текст внутри HTML-тегов, который подлежал переводу, уже является C++ специфическими терминами (`atomic_ullong`, `_Atomic`, `unsigned long long`) и кодом, поэтому перевод не требуется. HTML-разметка и атрибуты сохранены в оригинальном виде. **Примечание:** В данном случае весь текст, который требовалось перевести, уже находится внутри HTML-тегов, которые должны оставаться неизменными (`


        `, `
        
         `), либо представляет собой C++ специфичные термины (`atomic_char32_t`, `_Atomic char32_t`) и версионную маркировку (`(C11)`), которые не подлежат переводу согласно вашим требованиям. Поэтому исходный HTML код остается без изменений.

**Примечание:** В данном случае весь текст, который требовалось перевести, состоит только из HTML-тегов, атрибутов и C++ специфических терминов (`atomic_uint_least8_t`, `_Atomic`, `uint_least8_t`), которые согласно инструкциям не подлежат переводу. Единственный элемент "(C11)" является маркером версии стандарта и также сохраняется в оригинальном виде. **Примечание:** В данном случае весь текст внутри тегов `


        `, `
        ` и ` $` оставлен без перевода, как и требовалось. HTML-теги и атрибуты также сохранены без изменений. C++ специфические термины (`atomic_uint_least64_t`, `_Atomic`, `uint_least64_t`) не переведены, что соответствует требованиям технической документации.$

**Примечание:** В данном случае весь текст, который требовалось перевести, уже находится внутри HTML тегов, которые должны оставаться без изменений. Согласно вашим инструкциям: - HTML теги и атрибуты не переводились - Текст внутри тегов `


        ` и `
        
         ` не переводился
- C++ специфические термины (`atomic_int_fast32_t`, `_Atomic`, `int_fast32_t`) не переводились
Если бы был дополнительный текст для перевода вне этих ограничений, он был бы переведен на русский язык с сохранением профессионального подхода.

**Примечание:** В данном случае весь текст, подлежащий переводу, состоит из технических терминов C++ и HTML-разметки, которые согласно инструкциям не должны переводиться. Единственный элемент, который мог бы быть переведен - "(C11)" - является стандартным обозначением версии языка C и также не подлежит переводу в техническом контексте. **Примечание:** В данном случае весь текст, подлежащий переводу, находится внутри HTML тегов, которые должны оставаться неизменными согласно инструкциям. Единственный текст для перевода - это маркер версии "(C11)", но поскольку он представляет собой стандарт языка программирования, его также не следует переводить для сохранения профессиональной точности. **Перевод:** **Примечание:** В данном случае переводить нечего, так как: - HTML теги и атрибуты остаются без изменений - Текст внутри тегов `


        ` и `
        
         ` не переводится
- C++ специфические термины (`atomic_intmax_t`, `_Atomic`, `intmax_t`) сохраняются в оригинале
- Единственный текст "(C11)" является стандартным обозначением версии языка и также не требует перевода


        ` и `
        
         ` не переводится
- C++ специфические термины (`atomic_uintmax_t`, `_Atomic`, `uintmax_t`) сохраняются в оригинале
- Единственный текст для перевода "(C11)" уже является стандартным обозначением версии C++ и не требует перевода

Удобные псевдонимы типов
Имя типа-псевдонима	Полное имя типа
`atomic_bool` (C11)	_Atomic _Bool
`atomic_char` (C11)	_Atomic char
`atomic_schar` (C11)	_Atomic signed char
`atomic_schar` (C11)	_Atomic signed char
`atomic_uchar` (C11)	_Atomic unsigned char
`atomic_short` (C11)	_Atomic short
`atomic_ushort` (C11)	_Atomic unsigned short
`atomic_int` (C11)	_Atomic int
`atomic_uint` (C11)	_Atomic unsigned int
`atomic_uint` (C11)	_Atomic unsigned int
`atomic_long` (C11)	_Atomic long
`atomic_ulong` (C11)	_Atomic unsigned long
`atomic_llong` (C11)	_Atomic long long
`atomic_ullong` (C11)	_Atomic unsigned long long
`atomic_char8_t` (C23)	_Atomic char8_t
`atomic_char16_t` (C11)	_Atomic char16_t
`atomic_char32_t` (C11)	_Atomic char32_t
`atomic_wchar_t` (C11)	_Atomic wchar_t
`atomic_int_least8_t` (C11)	_Atomic int_least8_t
`atomic_uint_least8_t` (C11)	_Atomic uint_least8_t
`atomic_int_least16_t` (C11)	_Atomic int_least16_t
`atomic_uint_least16_t` (C11)	_Atomic uint_least16_t
`atomic_int_least32_t` (C11)	_Atomic int_least32_t
`atomic_uint_least32_t` (C11)	_Atomic uint_least32_t
`atomic_int_least64_t` (C11)	_Atomic int_least64_t
`atomic_uint_least64_t` (C11)	_Atomic uint_least64_t
`atomic_int_fast8_t` (C11)	_Atomic int_fast8_t
`atomic_uint_fast8_t` (C11)	_Atomic uint_fast8_t
`atomic_int_fast16_t` (C11)	_Atomic int_fast16_t
`atomic_uint_fast16_t` (C11)	_Atomic uint_fast16_t
`atomic_int_fast32_t` (C11)	_Atomic int_fast32_t
`atomic_uint_fast32_t` (C11)	_Atomic uint_fast32_t
`atomic_int_fast64_t` (C11)	_Atomic int_fast64_t
`atomic_uint_fast64_t` (C11)	_Atomic uint_fast64_t
`atomic_intptr_t` (C11)	_Atomic intptr_t
`atomic_uintptr_t` (C11)	_Atomic uintptr_t
`atomic_size_t` (C11)	_Atomic size_t
`atomic_ptrdiff_t` (C11)	_Atomic ptrdiff_t
`atomic_intmax_t` (C11)	_Atomic intmax_t
`atomic_intmax_t` (C11)	_Atomic intmax_t
`atomic_uintmax_t` (C11)	_Atomic uintmax_t
`atomic_uintmax_t` (C11)	_Atomic uintmax_t

Синопсис

Этот раздел не завершён
Причина: добавить больше из 7.17 Atomics <stdatomic.h> и B.16 Atomics <stdatomic.h>

#define __STDC_VERSION_STDATOMIC_H__ 202311L
void atomic_init(volatile A* obj, /*C*/ value);
/*type*/ kill_dependency(/*type*/ y);
void atomic_thread_fence(memory_order order);
void atomic_signal_fence(memory_order order);
bool atomic_is_lock_free(const volatile A* obj);
void atomic_store(volatile A* object, /*C*/ desired);
void atomic_store_explicit(volatile A* object, /*C*/ desired, memory_order order);
/*C*/ atomic_load(const volatile A* object);
/*C*/ atomic_load_explicit(const volatile A* object, memory_order order);
/*C*/ atomic_exchange(volatile A* object, /*C*/ desired);
/*C*/ atomic_exchange_explicit(volatile A* object, /*C*/ desired, memory_order order);
bool atomic_compare_exchange_strong(volatile A* object, /*C*/* expected, /*C*/ desired);
bool atomic_compare_exchange_strong_explicit(volatile A* object, /*C*/* expected,
/*C*/ desired, memory_order success, memory_order failure);
bool atomic_compare_exchange_weak(volatile A* object, /*C*/* expected, /*C*/ desired);
bool atomic_compare_exchange_weak_explicit(volatile A* object, /*C*/* expected,
/*C*/ desired, memory_order success, memory_order failure);
/*C*/ /*atomic_fetch_key*/(volatile A* object, M operand);
/*C*/ /*atomic_fetch_key_explicit*/(volatile A* object, M operand, memory_order order);
bool atomic_flag_test_and_set(volatile atomic_flag* object);
bool atomic_flag_test_and_set_explicit(volatile atomic_flag* object,
memory_order order);
void atomic_flag_clear(volatile atomic_flag* object);
void atomic_flag_clear_explicit(volatile atomic_flag* object,
                                memory_order order);

**Примечание:** Весь представленный код содержит исключительно C++ специфичные термины и синтаксис, которые согласно инструкциям не подлежат переводу. HTML разметка, теги `


       `, `
       ` и атрибуты сохранены в оригинальном виде.

Compiler support
Language
Headers
Type support
Program utilities
Variadic function support
Error handling
Dynamic memory management
Strings library
Algorithms
Numerics
Date and time utilities
Input/output support
Localization support
Concurrency support (C11)
Technical Specifications
Symbol index

cppreference.net

Namespaces

Variants

Standard library header <stdatomic.h> (C11)

Содержание

Атомарные операции

Операции над атомарными типами

Тип флага и операции

Инициализация

Порядок синхронизации памяти

Удобные псевдонимы типов

Синопсис