Daylight v4.9
Release Date: 1 February 2008

Name

dt_mp_trylock - lock an object family

Generic Prototype

dt_mp_trylock(dt_Handle) => dt_Boolean

C Prototype

#include "dt_smiles.h"

dt_Boolean dt_mp_trylock(dt_Handle object)

FORTRAN Prototype

include 'dt_f_smiles.inc'

logical dt_f_mp_trylock(object)

integer*4 object

Description

Locks an object family within the toolkit. Unlike dt_mp_lock(3), this function will not block if the lock is not available. The function can be used in a multi-threading program with global access of objects across threads to coordinate object access.

Return Value

Returns TRUE when the lock is acquired or FALSE if the lock is not available.

Related Topics

dt_ancestor(3) dt_mp_initialize(3) dt_mp_lock(3) dt_mp_unlock(3)