Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

tss_delete — brisanje ključa za shranjevanje, specifičnega za nit

tss_delete sprosti vire ključa za shranjevanje, specifičnega za nit, vendar ne pokliče destruktorjev in samodejno ne sprosti podatkov, na katere kaže ključ.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

tss_delete(key) iz <threads.h> sprosti vire shranjevanja, specifičnega za nit, ki ga določa key. Vrne void. Uporabi ključ, ki ga je uspešno ustvaril tss_create, preden kličoča nit začne izvajati destruktorje.

Brisanje ključa ne pokliče nobenega destruktorja: pomnilnik, dodeljen z malloc, je treba sprostiti posebej. Z vsemi nitmi se uskladi, da prenehajo uporabljati ključ, preden ga izbrišeš. Če druga nit izvaja destruktorje, vpliv brisanja na število klicev destruktorja za ta ključ v tej niti ni določen.

Primer ohrani kazalec, izbriše ključ in sam sprosti objekt. Števec pokaže, da destruktor ni bil poklican.

Primeri

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

Rezultat

destructor calls: 0

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri