經過了上篇文件的初步學習，對pthread有了一個簡單的感性認識，但是對pthread的認識還是比較少，在這篇文件當中將要主要學習pthread的一些常用的API。

首先是pthread的執行緒建立API: pthread_create

#include<pthread.h> int pthread_create(pthread_t *thread,//要建立的執行緒 pthread_attr_t *attr,//執行緒的相關屬性 void* (*start_routine)(void*),//執行緒要執行的函式指標 void *arg//傳遞給start_routine的引數 ); 

當建立函式執行成功的時候返回0，並把建立的執行緒tid寫入傳入的執行緒指標中去（第一個引數），否則返回一個非零值並設定errno。

其中，第一個和第三個引數是必須要設定的，其他兩個引數可以根據情況設定，當沒有需求的時候傳入NULL即可。

pthread_exit: 終止當前執行緒

#include<pthread.h> void pthread_exit(void *retval); //該函式用於退出當前執行緒，退出之前將呼叫pthread_cleanup_push //上述函式將在下文中介紹。 //該函式線上程的上層函式中是被隱式呼叫的，可以增加一個retval引數 //顯示呼叫，以供pthread_join函式參考

pthread_join:掛起當前執行緒直到指定的執行緒終止為止（這個函式對於pthread十分重要，正如上一篇文件中所說的，不呼叫該函式可能會造成後續的create失敗的問題）。

#include<pthread.h> int pthread_join(pthread_t thread, void **thread_return); //thread_return為th終止時的引數， //沒有顯式指定則為NULL //需要查閱該引數的使用方法

pthread_cancel: 撤銷一個執行緒

#include<pthread.h> //撤銷執行緒thread int pthread_cancel(pthread_t thread); //用於設定當前執行緒的撤銷狀態 //PTHREAD_CANCEL_ENABLE允許撤銷 //PTHREAD_CANCEL_DISABLE忽略撤銷 //為了避免被另外的執行緒用pthread_cancel撤銷 //oldstate用來儲存之前的狀態，以便恢復 int pthread_setcancelstate(int state, int *oldstate); //設定當前執行緒的撤銷型別，包括： //PTHREAD_CANCEL_ASYNCHRONOUS立即撤銷 //PTHREAD_CANCEL_DEFERRED 延遲至撤銷點 int pthread_setcanceltype(int type, int *oldtype);

執行緒屬性：（上文中create函式的第二個引數，型別為pthread_attr_t，可以使用pthread_attr_XXXX函式族呼叫）

detachstate：分離或者切入狀態，有兩個值PTHREAD_CREATE_JOINABLE（default value）,PHTREAD_CREATE_DETACHED

schedpolicy:  排程策略，取值有： SCHED_OTHER, SCHED_FIFO

schedparam:  排程策略相關

inheritsched: PTHREAD_EXPLICIT_SCHED(default value), PTHREAD_INERIT_SCHED

scope: 時間片，取值有：PTHREAD_SCOPE_SYSTEM(default value每個執行緒 一個系統時間片), PTHREAD_SCOPE_PROGCESS（執行緒共享系統時間片）。

pthread cleanup巨集

pthread cleanup巨集主要用來處理執行緒的推出狀態，pthread_exit和pthread_join等可以作為它的引數

#include<pthread.h> //這些都是巨集定義，相關細節可以檢視/usr/include/pthread.h void pthread_cleanup_push( void(*routine)(void*), void *arg); void pthread_cleanup_pop(int execute); void pthread_cleanup_push_defer_np(void(*routine)(void*), void *arg); void pthread_cleanup_pop_restore_np(int execute); //對這些巨集的理解並不深入，在後續的學習中參考相應的例子 //進一步的學習。 //這些巨集用於執行緒結束時釋放相關資源，用pthread_exit呼叫pthread_cleanup //進行處理時，用完後要用對應的pthread_cleanup_pop從棧中彈出

互斥mutex

由於執行緒是併發執行的，因此有時候需要對一些資料進行保護，例如多執行緒標準輸出如果不加以處理，那麼輸出基本上都會是亂碼，此時就可以使用mutex對輸出流進行控制，一個執行緒執行寫入操作的時候，加一把互斥鎖，以防別的執行緒同時寫入。

互斥物件在pthread中的定義為pthread_mutex_t，以下是它的一些API函式：

#include<pthread.h> //建立互斥物件，用指定的初始化屬性初始化互斥物件 //屬性包括： //PTHREAD_MUTEX_INITIALIZER 快速互斥，簡單加解鎖 //PTHREAD_RECURSIVE_MUTEX_INITIALIZER //遞迴互斥，給加鎖計數，解鎖時需要同樣次數的pthread_mutex_unlock //PTHREAD_ERRORCHECK_MUTEX_INITIALIZER //建立檢錯互斥，這種互斥在被鎖之後會試圖給它加鎖的執行緒返回一個 //EDEADLK錯誤程式碼而不阻塞 int pthread_mutex_init(pthread_mutex_t *mutex, const pthread_mutex_attr_t *mutexattr); //加鎖 int pthread_mutex_lock(pthread_mutex_t *mutex); //解鎖 int pthread_mutex_unlock(pthread_mutex_t *mutex); //加鎖，但是如果物件已經上鎖則返回EBUSY錯誤程式碼而不阻塞 int pthread_mmutex_trylock(pthread_mutex_t *mutex); //析構並釋放mutex相關資源 int pthread_mutex_destroy(pthread_mutex_t *mutex); //以上的函式成功均返回0，和一般的函式一致

條件變數

執行緒使用條件變數物件來阻塞自己以等待某個特定條件的發生。

條件物件的定義為pthread_cond_t

#include<pthread.h> //建立指向條件變數的指標，在linux下可以使用PTHREAD_COND_INITIALIZER pthread_cond_t cond = PTHREAD_COND_INITIALIZER; int pthread_cond_init(pthread_cond_t *cond, pthread_condattr_t *cond_attr); //析構 int pthread_cond_destroy(pthread_cond_t *cond); //兩個訊號函式 int pthread_cond_singal(pthread_cond_t *cond); int pthread_cond_broadcast(pthread_cond_t *cond); //兩個等待條件否則掛起的函式 //當前期望的條件沒有到來的時候掛起執行緒，解鎖mutex //條件成立的時候喚起執行緒，鎖定互斥 int pthread_cond_wait(pthread_cond_t *cond, pthread_mutex_t *mutex); //abstime引數和相容time()返回值的絕對時間， //UNIX紀元時間1970-01-01起至今的秒數 //如果該時間前條件未發生，則結束並返回ETIMEOUT錯誤 int pthread_cond_wimewait(pthread_cond_t *cond, pthread_mutex_t *mutex, const struct timespec *abstime); //上述兩個函式都將被設定為撤銷點（這個撤銷點的意義？）

至此，基本的pthread的API函式就學習到這裡了，在後續的學習當中，將會結合例子更深入的學習。