commit

wangzhengquan

2020-07-14 8b4ddf10e71e1c8fabd33c72b282f7da65ff682f

 queue/include/shm_queue_wrapper.h

@@ -22,6 +22,10 @@
 */
void shm_destroy();

 

//移除不包含在keys中的队列
void shm_remove_queues_exclue(void *keys, int length);
/**
 * 创建队列
 * @ shmqueue 
@@ -31,58 +35,76 @@
void* shmqueue_create( int * key, int queue_size);

/**
 * 绑定key到队列，但是并不会创建队列。如果没有对应指定key的队列提示错误并返回空值
 * 绑定key到队列，但是并不会创建队列。如果没有对应指定key的队列提示错误并退出
 */
void* shmqueue_attach(int key);
void* shmqueue_attach(int key) ;

/**
 * 销毁
*/
void shmqueue_drop(void * _shmqueue) ;
void shmqueue_drop(void * _shmqueue);

/**
 * 队列元素的个数
 */
int shmqueue_size(void * _shmqueue);
int shmqueue_size(void * _shmqueue) ;

/**
 * 是否已满
 * @return 1是， 0否
 */
int shmqueue_full(void * _shmqueue);

/**
 * 是否为空
 * @return 1是， 0否
 */
int shmqueue_empty(void * _shmqueue) ;

/**
 * 入队, 队列满时等待
 * 入队, 队列满时等待.
 * @return 1 入队成功, 0 入队失败
 */
int shmqueue_push(void * _shmqueue, void *src_ele, int ele_size);
int shmqueue_push(void * _shmqueue, void *src, int size);

/**
 * 入队, 队列满时立即返回
 * 入队, 队列满时立即返回.
 * @return 1 入队成功, 0 入队失败
 */
int shmqueue_push_nowait(void * _shmqueue, void *src_ele, int ele_size) ;
int shmqueue_push_nowait(void * _shmqueue, void *src, int size) ;

/**
 * 入队, 指定时间内入队不成功就返回
 * timespec {sec秒, nsec纳秒}
 * @sec 秒
 * @nsec 纳秒
 * @return 1 入队成功, 0 入队失败
 */
int shmqueue_push_timeout(void * _shmqueue, void *src_ele, int ele_size, void * _timeout);
int shmqueue_push_timeout(void * _shmqueue, void *src, int size,  int sec, int nsec) ;

/**
 * 出队, 队列空时等待
 * @return 1 出队成功， 0出队失败
 */
int shmqueue_pop(void * _shmqueue, void *dest_ele);
int shmqueue_pop(void * _shmqueue, void **dest, int *size);

/**
 * 出队, 队列空时立即返回
 * @return 1 出队成功， 0出队失败
 */
int shmqueue_pop_nowait(void * _shmqueue, void *dest_ele) ;
int shmqueue_pop_nowait(void * _shmqueue, void **dest, int *size) ;

/**
 * 出队, 指定时间内出队不成功就返回
 * @sec秒
 * @nsec纳秒
 * @return 1 出队成功， 0出队失败
 */
int shmqueue_pop_timeout(void * _shmqueue, void *dest_ele, void * _timeout);
int shmqueue_pop_timeout(void * _shmqueue, void **dest, int *size, int sec, int nsec);

/**
 * 释放出队分配的内存
 */
void shmqueue_free(void *ptr);

#ifdef __cplusplus
}