prg_mt_mutex_create()
摘要
创建一个 mutex 对象,用于在并行环境中对共享资源的访问进行串行化。
语法
prg_mt_mutex_create (options, rank, description, result_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
options |
int |
取以下值之一: • PRGC_MT_MUTEX_NO_OPTIONS:基本 mutex• PRGC_MT_MUTEX_RECURSIVE:递归 mutex• PRGC_MT_MUTEX_READER_WRITER:读/写 mutex,可与 PRGC_MT_MUTEX_RANK_CHECK 按位或(C 语言的 |)组合:利用等级信息在加锁顺序不当时阻止加锁;与 PRGC_MT_MUTEX_LOCK_ID_TRACK 按位或组合:记录进程 ID 用于错误报告 |
rank |
int |
mutex 的等级;除非 options 中包含 PRGC_MT_MUTEX_RANK_CHECK,否则被忽略 |
description |
const char * |
人类可读的描述,用于 prg_mt 包生成的错误消息 |
result_ptr |
PrtT_Mutex_Result |
用于存放结果值的可选存储空间(若设置为 PRGC_NIL,则不提供该值) |
返回类型
PrgT_Mutex *
生成的 mutex 对象;若创建失败则返回 PRGC_NIL。
头文件
prg_mt.h
详情
此函数允许你创建包概述中所述的某一种 mutex 形式。生成的对象应与 prg_mt_mutex_lock() 和 prg_mt_mutex_unlock() 配合使用,以正确访问共享资源。
如果可能,每个共享资源都应有自己的 mutex。