WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

tss_delete — einen Thread-spezifischen Speicherschlüssel löschen

tss_delete gibt Ressourcen für einen Thread-spezifischen Speicherschlüssel frei, ruft aber keine Destruktoren auf und gibt die referenzierten Daten nicht automatisch frei.

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

Syntax

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

tss_delete(key) aus <threads.h> gibt Ressourcen für den durch key bezeichneten Thread-spezifischen Speicher frei. Die Funktion gibt void zurück. Verwende einen Schlüssel, der erfolgreich mit tss_create erstellt wurde, bevor der aufrufende Thread mit der Ausführung von Destruktoren beginnt.

Beim Löschen des Schlüssels werden keine Destruktoren aufgerufen: Mit malloc reservierter Speicher muss separat freigegeben werden. Stimme dich mit allen Threads ab, damit sie die Verwendung des Schlüssels beenden, bevor du ihn löschst. Wenn ein anderer Thread gerade Destruktoren ausführt, ist die Auswirkung des Löschens auf die Anzahl der Aufrufe des Destruktors für diesen Schlüssel in jenem Thread nicht festgelegt.

Das Beispiel behält den Zeiger, löscht den Schlüssel und gibt das Objekt selbst frei. Der Zähler zeigt, dass der Destruktor nicht aufgerufen wurde.

Beispiele

#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;
}

Ergebnis

destructor calls: 0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen