</> Rotina sqlite3_mutex_alloc()
Aloca em memória um novo mutex e retorna o ponteiro para sua posição, caso retorne NULL o mutex não pode ser alocado. Os argumentos são apresentados a seguir como constantes inteiras definidas no código fonte sendo elas:
SQLITE_MUTEX_FAST e SQLITE_MUTEX_RECURSIVE quando passadas por parâmetro criam um novo mutex podendo ser do tipo FAST ou RECURSIVE. O SQLite apenas utiliza o modo RECURSIVE caso seja realmente necessário caso contrário ele preferivelmente utiliza o mutex do tipo FAST.
Os outro argumentos quando passados para o sqlite3_mutex_alloc() retornam um ponteiro para um mutex do tipo STATIC pré-existente. Um mutex estático pode ser manipulado apenas internamente pelo SQLite, para as aplicações que utilizam o SQLite apenas os mutex dinâmicos, retornados utilizando SQLITE_MUTEX_FAST e SQLITE_MUTEX_RECURSIVE, devem ser utilizados.
Código sqlite3_mutex *sqlite3_mutex_alloc()
SQLITE_API sqlite3_mutex *sqlite3_mutex_alloc(int id){
ifndef SQLITE_OMIT_AUTOINIT
if( id<=SQLITE_MUTEX_RECURSIVE && sqlite3_initialize() ) return 0;
if( id>SQLITE_MUTEX_RECURSIVE && sqlite3MutexInit() ) return 0;
#endif
assert( sqlite3GlobalConfig.mutex.xMutexAlloc );
return sqlite3GlobalConfig.mutex.xMutexAlloc(id);
}
</> Procedimento sqlite3_mutex_free()
Desaloca um mutex alocado dinamicamente, caso houver uma tentativa de desalocar um mutex estático pode resultar em um comportamento indefinido.
Código sqlite3_mutex_free()
SQLITE_API void sqlite3_mutex_free(sqlite3_mutex *p){
if( p ){
assert( sqlite3GlobalConfig.mutex.xMutexFree );
sqlite3GlobalConfig.mutex.xMutexFree(p);
}
}
</> Rotinas sqlite3_mutex_enter() e sqlite3_mutex_try()
Procedimentos que tentam acessar um mutex. Caso outra thread já esteja dentro do mutex o procedimento sqlite3_mutex_enter() irá bloquear e a função sqlite3_mutex_try() irá retornar SQLITE_BUSY. O sqlite3_mutex_try() retorna SQLITE_OK caso a entrada seja permitida.
Para o caso de mutex recursivo, SQLITE_MUTEX_RECURSIVE, uma única thread pode tentar acessar o mutex várias vezes, o mutex deve ser fechado esse mesmo número de vezes para que outra thread possa acessá-lo.
Código sqlite3_mutex_enter()
SQLITE_API void sqlite3_mutex_enter(sqlite3_mutex *p){
if( p ){
assert( sqlite3GlobalConfig.mutex.xMutexEnter );
sqlite3GlobalConfig.mutex.xMutexEnter(p);
}
}
Código sqlite3_mutex_try()
SQLITE_API int sqlite3_mutex_try(sqlite3_mutex *p){
int rc = SQLITE_OK;
if( p ){
assert( sqlite3GlobalConfig.mutex.xMutexTry );
return sqlite3GlobalConfig.mutex.xMutexTry(p);
}
return rc;
}
</> Procedimento sqlite3_mutex_leave()
Procedimento faz com que a thread saia do mutex que foi previamente inserida.
Código sqlite3_mutex_leave()
SQLITE_API void sqlite3_mutex_leave(sqlite3_mutex *p){
if( p ){
assert( sqlite3GlobalConfig.mutex.xMutexLeave );
sqlite3GlobalConfig.mutex.xMutexLeave(p);
}
}
