PTHREAD_KEY_DELETE(3)

명칭
pthread_key_delete - thread 고유의 데이터 키의 삭제

프로그램 라이브러리
libc_r

서식
<pthread.h> int pthread_key_delete(pthread_key_t key)

해설
pthread_key_delete() 함수는, 이전에 pthread_key_create() 에 의해 돌려주어진 thread 고유의 데이터 키를 삭제합니다. key 에 관련지을 수 있었던 thread 고유의 데이터치는, pthread_key_delete() 하지만 불려 가는 시점에서 NULL 일 필요는 없습니다. 모든 어플리케이션 기억 area의 해방, 또는 삭제된 키에 관련했다 데이터 구조나 모든 thread안의 thread 고유의 데이터의 모든 클린 업 동작의 실행은, 어플리케이션의 책무입니다. 이 클린 업은 pthread_key_delete() 하지만 불려 가는 전후로 실행되는 것이 가능합니다. pthread_key_delete() 의 호출의 후에, key (을)를 사용하려고 하는 모든 시도의 결과는, 부정 동작이 됩니다.

pthread_key_delete() 함수는, 소멸자 함수중에서 호출하는 것이 가능합니다. 소멸자 함수는, pthread_key_delete() (으)로부터는 불려 가지 않습니다. key 에 관련지을 수 있고 있을지도 모르는 모든 소멸자 함수는, thread의 종료시에는 이미 불려 가지 않습니다.

반환값
문제가 없는 경우는, pthread_key_delete() 함수는 0 을 돌려줍니다. 문제가 있는 경우는, 그 에러를 나타내기 위해서(때문에) 에러 번호가 돌려주어집니다.

에러
pthread_key_delete() (은)는 이하의 경우에 실패합니다.

[EINVAL]
    key 의 값이 무효입니다.

관련 항목
pthread_getspecific(3), pthread_key_create(3), pthread_setspecific(3)

표준
pthread_key_delete() 하 p1003.1-96 에 적합하고 있습니다.