/*********************************************
* @brief 尝试锁定互斥量
* @param mutex 要加锁的互斥量 ID
* @return 是否成功
********************************************/
int mtx_trylock(mtx_t* mutex);
!subtitle:说明
尝试锁定互斥量,立即返回而不产生阻塞。
这个函数可能会虚假的失败,即互斥量并没有被加锁,却失败返回 thrd_busy;这是由于内存(缓存)可见性延迟、硬件优化、内存屏障等原因导致的正常现象。
!subtitle:参数
mutex - 要加锁的互斥量 ID
!subtitle:返回值
成功时返回 thrd_success
互斥量已被锁定(或虚假的失败)时返回 thrd_busy
其它失败返回 thrd_error
#include <stdio.h>
#include <threads.h>
#include <time.h>
// 线程函数
int func(void* data)
{
mtx_t* mutex = (mtx_t*)data; // 通过参数传递互斥量
printf("开始时间: %s", ctime(&(time_t){time(NULL)}));
// 加锁
if (mtx_trylock(mutex) == thrd_success)
{
printf("加锁成功\n");
}
else
{
printf("加锁失败\n");
}
printf("结束时间: %s", ctime(&(time_t){time(NULL)}));
return 0;
}
int main(void)
{
// 创建支持超时的互斥量
mtx_t mutex;
mtx_init(&mutex, mtx_timed);
// 加锁
mtx_lock(&mutex);
// 创建线程
thrd_t th;
thrd_create(&th, func, &mutex); // 通过参数传递数据和互斥量
// 等待线程结束
thrd_join(th, NULL);
// 加锁
mtx_unlock(&mutex);
// 清除互斥量
mtx_destroy(&mutex);
return 0;
}
!subtitle:运行结果
开始时间: Sun Aug 24 14:17:13 2025
加锁失败
结束时间: Sun Aug 24 14:17:13 2025
!subtitle:说明
示例中,子线程函数调用 mtx_trylock 尝试加锁。
主线程在创建子线程前已经对互斥量加锁,并且始终没有解锁,因此子线程无法成功加锁,立即返回失败。
C17 standard (ISO/IEC 9899:2018):
7.26.4.5 The mtx_trylock function (p: 278-279)
C11 standard (ISO/IEC 9899:2011):
7.26.4.5 The mtx_trylock function (p: 382)