Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

ftrylockfile()

Acquire ownership of a file, without blocking

Synopsis:

#include <stdio.h>

int ftrylockfile( FILE* file );

Arguments:

file
A pointer to the FILE object for the file you want to lock.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The ftrylockfile() function is used by a thread to acquire ownership of a FILE if the object is available; ftrylockfile() is a nonblocking version of flockfile().

Returns:

0
Success.
Nonzero
The lock can't be acquired.

Classification:

POSIX 1003.1 TSF

Safety:
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

flockfile(), getc_unlocked(), getchar_unlocked(), putc_unlocked(), putchar_unlocked()