Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

atomic_fetch_and — función genérica atómica de C23

`atomic_fetch_and(object, operand)` de `<stdatomic.h>` realiza atómicamente `*object &= operand` sobre un tipo entero atómico y devuelve el valor anterior. Es una única operación read-modify-write.

Versión: C23

Sintaxis

C atomic_fetch_and(volatile A *object, M operand);

atomic_fetch_and(object, operand) de <stdatomic.h> realiza atómicamente *object &= operand sobre un tipo entero atómico y devuelve el valor anterior. Es una única operación read-modify-write.

Sirve para borrar bits seleccionados de forma concurrente sin sobrescribir banderas que otros hilos hayan activado mientras tanto. El ejemplo parte de 0x7, borra atómicamente el bit 0x2 con ~0x2u, devuelve el antiguo 7 y deja 5.

No acepta punteros atómicos; object debe apuntar a un entero atómico compatible e inicializado. La forma sin _explicit usa memory_order_seq_cst y no tiene que ser lock-free. La máscara debe tener ancho y signo previstos; una operación de máscara no crea una invariante sobre otros objetos atómicos. Los tipos enteros atómicos admitidos excluyen explícitamente _Atomic bool; esta operación no tiene forma para punteros.

El nombre de esta función genérica puede ser una macro o un identificador externo; suprimir la macro para llamar a una función real o definir un identificador externo con ese nombre tiene comportamiento indefinido.

Ejemplos

#include <stdatomic.h>
#include <stdio.h>

int main(void) {
    atomic_uint flags = 0x7u;
    unsigned previous = atomic_fetch_and(&flags, ~0x2u);
    printf("%u %u\n", previous, atomic_load(&flags));
    return 0;
}

Resultado

7 5

Sirve para borrar bits seleccionados de forma concurrente sin sobrescribir banderas que otros hilos hayan activado mientras tanto. El ejemplo parte de `0x7`, borra atómicamente el bit `0x2` con `~0x2u`, devuelve el antiguo `7` y deja `5`.

Fuentes