HTL_thread_key_delete

Interface Definition

int HTL_thread_key_delete(HTL_thread_key_t *thread_key);

Description

HTL_thread_key_delete() is used to release the thread private variable specified by thread_key and set thread_key to HTL_THREAD_KEY_NULL.

Users need to clean up the memory of the value associated with the thread private variable.

Besides, users can delete a thread private variable before terminating all threads that have non-NULL values associated with the thread private variable. The value of a deleted thread private variable cannot be referenced, but can be used in the destructor triggered by thread termination.

Parameters

Return Value

• HTL_THREAD_SUCCESS: success.
• Other values: failure. For details, see the error code descriptions.

Example

    /* Detete keys */
    for (i = 0; i < NUM_TLS; i++) {
        ret = HTL_thread_key_delete(&tls[i]);
    }