輕鬆掌握Linux的csleep函數

一、什麼是csleep函數

csleep函數是Linux下的一個系統調用函數，用於使線程進入阻塞狀態，並釋放CPU，直到指定時間之後再喚醒線程。這個函數是通過調用系統內核的定時器實現的。

二、csleep函數的語法

#include <unistd.h>
int csleep(const struct timespec *req, struct timespec *rem);

其中，參數req表示線程需要休眠的時間，以秒和納秒為單位。參數rem表示如果線程在休眠過程中被喚醒，剩下的休眠時間就會保存在這裡。

三、csleep函數的用法

下面是一個使用csleep函數的示例代碼：

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <time.h>

int main()
{
    struct timespec req, rem;
    req.tv_sec = 5;
    req.tv_nsec = 0;
    int ret = csleep(&req, &rem);
    
    if(ret == -1)
    {
        perror("csleep error");
        exit(EXIT_FAILURE);
    }
    
    printf("csleep returned %d\n", ret);
    printf("rem.tv_sec = %ld, rem.tv_nsec = %ld\n", rem.tv_sec, rem.tv_nsec);

    return 0;
}

上面的代碼中，我們設定線程休眠5秒，如果線程在休眠中被喚醒，剩餘的休眠時間就會保存在rem中。如果csleep函數調用成功，函數的返回值為0，否則返回-1。

四、csleep函數的注意事項

1、如果參數req中的秒和納秒值之和超過了約4.3億，那麼可能會產生錯誤。

2、如果線程在休眠過程中被信號喚醒，那麼函數會返回-1，並設置errno為EINTR。

3、在使用csleep函數時，要注意結構體timespec的成員變數的單位，tv_sec表示秒，tv_nsec表示納秒。

五、完整代碼示例

下面是一個完整的csleep函數使用示例：

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <time.h>

int main()
{
    printf("Start sleeping\n");
    struct timespec req, rem;
    req.tv_sec = 5;
    req.tv_nsec = 0;
    int ret = csleep(&req, &rem);
    
    if(ret == -1)
    {
        perror("csleep error");
        exit(EXIT_FAILURE);
    }
    
    printf("csleep returned %d\n", ret);
    printf("rem.tv_sec = %ld, rem.tv_nsec = %ld\n", rem.tv_sec, rem.tv_nsec);
    printf("Finish sleeping\n");

    return 0;
}

輸出結果為：

Start sleeping
Finish sleeping
csleep 返回 0
rem.tv_sec = 0，rem.tv_nsec = 0

可以看到，線程在休眠5秒之後被喚醒，參數rem中的值為0。