void funlockfile(FILE *file);
The funlockfile() function provides explicit
application-level locking of stdio (FILE *) objects.
This function can be used by a thread to delineate a sequence of I/O
statements that are to be executed as unit.
The funlockfile() function is used to
relinquish the ownership of file. Behavior is undefined if
a thread other than the owner calls funlockfile().
Logically, there is a lock count associated with each (FILE *)
This count is implicitly initialized to zero when the object is created.
The object is unlocked when the count is zero. When the count is positive,
a single thread owns the object.
When flockfile() is called, if the count is zero or if
the count is positive and the caller owns the object, the count
is incremented. Otherwise, the calling thread is suspended, waiting for the
count to return to zero.
Each call to funlockfile() decrements the count.
This allows matching calls to flockfile() and
funlockfile() to be nested.
All functions that reference (FILE *) objects behave as if
they use flockfile() and funlockfile()
internally to obtain ownership of these objects, unless the documentation for
the function explicitly indicates that the function operates on an unlocked
Is the file object to be unlocked.
PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition
- fclose(), fdopen(), flockfile(), fopen(), ftrylockfile(), getc_unlocked(), getchar_unlocked(), putc_unlocked(), putchar_unlocked()
PTC MKS Toolkit 10.2 Documentation Build 28.