st_usleep函数介绍—StateThreads基础函数介绍

作者：罗上文，微信：Loken1，公众号：FFmpeg弦外之音

由于 StateThreads 库是单线程程序，如果使用了 C 标准库的 sleep() 或者 usleep() 函数，就会阻塞所有协程的运行。但是有时候，某个协程确实要 sleep 休眠一些时间，那怎么办呢？

StateThreads 库提供了 st_usleep() 函数，使用这个函数，就可以让某个协程休眠一段时间，但是又不会阻塞其他的协程函数的执行。下面就用一个小示例 sleep.c 演示一下 st_usleep() 的用法。

sleep.c 文件的代码如下：

#include <stdio.h>
#include "st.h"

void *print_a(void *arg) {
    st_usleep(2 * 1000000LL);
    st_utime_t time_now = st_utime();
    printf("I am a , %lld\r\n", time_now);
    return NULL;
}

void *print_b(void *arg) {
    st_utime_t time_now = st_utime();
    printf("I am b , %lld\r\n", time_now);
    return NULL;
}

int main(int argc, char *argv[]) {
    st_init();

    st_thread_create(print_a, NULL, 0, 0);
    st_thread_create(print_b, NULL, 0, 0);

    st_thread_exit(NULL);

    /* NOTREACHED */
    return 1;
}

请把 sleep.c 放到 example 目录下。

然后我们修改一下 makefile 的编译规则，修改的地方如下：

EXAMPLES    = $(OBJDIR)/lookupdns $(OBJDIR)/proxy $(OBJDIR)/server
改为
EXAMPLES    = $(OBJDIR)/lookupdns $(OBJDIR)/proxy $(OBJDIR)/server $(OBJDIR)/sleep

$(OBJDIR)/server: server.c $(OBJDIR)/error.o $(LIBST) $(HEADER)
    $(CC) $(CFLAGS) -I$(INCDIR) server.c $(OBJDIR)/error.o $(LIBST) $(EXTRALIBS) -o $@

加上下面这句

$(OBJDIR)/sleep: sleep.c $(LIBST) $(HEADER)
    $(CC) $(CFLAGS) -I$(INCDIR) sleep.c $(LIBST) $(EXTRALIBS) -o $@

运行效果如下：

可以看到，协程 print_a 的休眠并不会阻塞 print_b 协程的运行。

关于 st_usleep() 的内部实现分析，请阅读《st_usleep源码分析》