clib/doc.md

[TOC]

函数列表

注意事项

具体函数请点击链接或打开doc文件夹直接查找

套接字函数 ssocket.h

socket套接字相关

static inline int sock_accpet(SOCKET sock,SOCKET* client, char** accept_ip, unsigned short* port);

将有效的套接字绑定并监听网络以提供套接字服务,返回0表示成功

static inline int make_server_sock(SOCKET* sock, const char* server_ip, unsigned short port);

static inline int make_client_sock(SOCKET* sock, const char* connect_ip, unsigned short port);

static inline void close_sock(SOCKET sock);

static inline int make_server_sock_ex(SOCKET* sock, const char* server_ip, unsigned short port, struct addrinfo** resaddr);

static inline int make_client_sock_ex(SOCKET* sock, const char* connect_ip, unsigned short port, struct addrinfo** resaddr);

错误处理(暂时未启用)

static inline void out_sock_err(FILE* output, int errcode);

static inline void get_sock_err(char* buff_128, size_t buff_len, int errcode);

内置函数

static inline int _getaddrinfo(struct addrinfo* inf, struct addrinfo** resaddr, const char* ip, const char* port);

static inline int _socket(SOCKET* sock, struct addrinfo* resaddr);

static inline int _connect(SOCKET sock, struct addrinfo* resaddr);

static inline int _bind(SOCKET sock, struct addrinfo* resaddr);

static inline int _bindlisten(SOCKET sock, struct addrinfo* resaddr);

static inline int _accept(SOCKET sock, SOCKET* client, struct addrinfo* inf);

static inline int _sock(SOCKET* sock, int af, int type);

手动创建socket

static inline int make_sock_tcp4(SOCKET* sock);

static inline int make_sock_tcp6(SOCKET* sock);

static inline int make_sock_udp4(SOCKET* sock);

static inline int make_sock_udp6(SOCKET* sock);

static inline int make_sock(SOCKET* sock);

初始化套接字接口,返回0表示成功

不推荐,仅用于测试,将在未来版本删除

static inline int sock_connect(SOCKET sock, const char* connect_ip, unsigned short port);

将有效的套接字连接到相应的套接字服务,返回0表示成功

static inline int sock_bindlisten(SOCKET sock, const char* server_ip, unsigned short port);

将有效的套接字绑定并监听网络以提供套接字服务,返回0表示成功

线程函数 tthread.h

thread线程相关

static inline int thread_create(TID* tid, void(*start_routine)(void*), void* arg);

static inline void thread_exit(void);

static inline int thread_join(TID tid);

static inline TID thread_self(void);

mutex互斥锁相关

static inline int thread_mutex_init(MUTEX* mutex);

static inline int thread_mutex_destroy(MUTEX* mutex);

static inline int thread_mutex_lock(MUTEX* mutex);

static inline int thread_mutex_unlock(MUTEX* mutex);

cond信号量相关

static inline int thread_cond_init(COND* cond);

static inline int thread_cond_destroy(COND* cond);

static inline int thread_cond_singal(COND* cond);

static inline int thread_cond_broadcast(COND* cond);

static inline int thread_cond_wait(COND* cond, MUTEX* mutex);

static inline int thread_cond_timedwait(COND* cond, MUTEX* mutex, int ms);

stdio标准函数的线程安全

static inline int tprintf(MUTEX* mutex, const char* format, ...);

static inline int tfprintf(MUTEX* mutex, FILE* const stream, const char* format, ...);

static inline int tsprintf(MUTEX* mutex, char* const buffer, const char* format, ...);

static inline int tsnprintf(MUTEX* mutex, char* const buffer, const size_t buffer_count, const char* format, ...);

static inline int tvprintf(MUTEX* mutex, const char* format, va_list arglist);

static inline int tvfprintf(MUTEX* mutex, FILE* const stream, const char* format, va_list arglist);

static inline int tvsprintf(MUTEX* mutex, char* const buffer, const char* format, va_list arglist);

static inline int tvsnprintf(MUTEX* mutex, char* const buffer, const size_t buffer_count, const char* format, va_list arglist);