omp_test_lock (GNU libgomp)

#### 3.8.9 `omp_test_lock` – Test and set simple lock if available ¶

Description:

  Before setting a simple lock, the lock variable must be initialized by `omp_init_lock`. Contrary to `omp_set_lock`, `omp_test_lock` does not block if the lock is not available. This function returns `true` upon success, `false` otherwise. Here, `true` and `false` represent their language-specific counterparts.

C/C++:

  Prototype: | `int omp_test_lock(omp_lock_t *lock);`

Fortran:

  Interface: | `logical function omp_test_lock(svar)`
  | `integer(omp_lock_kind), intent(inout) :: svar`

See also:

  `omp_init_lock` – Initialize simple lock, `omp_set_lock` – Wait for and set simple lock, `omp_set_lock` – Wait for and set simple lock

Reference:

  OpenMP specification v4.5, Section 3.3.6.