KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

tss_delete — een thread-specifieke opslagsleutel verwijderen

tss_delete geeft resources van een thread-specifieke opslagsleutel vrij, maar roept geen destructors aan en maakt de gegevens waarnaar de sleutel verwijst niet automatisch vrij.

Versie: C23; repository compiler flag, production runtime not attested

Syntax

#include <threads.h>
void tss_delete(tss_t key);

tss_delete(key) uit <threads.h> geeft resources vrij van de thread-specifieke opslag die met key wordt aangeduid. De functie retourneert void. Gebruik een sleutel die met succes is aangemaakt door tss_create, voordat de aanroepende thread destructors begint uit te voeren.

Bij het verwijderen van de sleutel worden geen destructors aangeroepen: geheugen dat met malloc is toegewezen, moet afzonderlijk worden vrijgegeven. Zorg ervoor dat alle threads stoppen met het gebruiken van de sleutel voordat je deze verwijdert. Als een andere thread destructors uitvoert, is het effect van de verwijdering op het aantal aanroepen van de destructor voor deze sleutel in die thread niet gespecificeerd.

Het voorbeeld bewaart de pointer, verwijdert de sleutel en maakt het object zelf vrij. De teller laat zien dat de destructor niet is aangeroepen.

Voorbeelden

#include <stdio.h>
#include <stdlib.h>
#include <threads.h>

static int destructor_calls;

static void destroy(void *ptr)
{
    ++destructor_calls;
    free(ptr);
}

int main(void)
{
    tss_t key;
    if (tss_create(&key, destroy) != thrd_success) {
        return EXIT_FAILURE;
    }

    int *value = malloc(sizeof *value);
    if (value == NULL) {
        tss_delete(key);
        return EXIT_FAILURE;
    }
    *value = 42;

    if (tss_set(key, value) != thrd_success) {
        free(value);
        tss_delete(key);
        return EXIT_FAILURE;
    }

    tss_delete(key);
    printf("destructor calls: %d\n", destructor_calls);
    free(value);
    return EXIT_SUCCESS;
}

Resultaat

destructor calls: 0

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen