fclose-nolock.md

title	_fclose_nolock
description	Learn more about: _fclose_nolock
ms.date	4/2/2020
api_name	_fclose_nolock _o__fclose_nolock
api_location	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-stdio-l1-1-0.dll
api_type	DLLExport
topic_type	apiref
f1_keywords	fclose_nolock _fclose_nolock
helpviewer_keywords	streams, closing fclose_nolock function _fclose_nolock function

_fclose_nolock

Closes a stream without locking.

Syntax

int _fclose_nolock(
   FILE *stream
);

Parameters

stream
Pointer to the FILE structure.

Return value

_fclose_nolock returns 0 if the stream is successfully closed. Returns EOF to indicate an error.

Remarks

This function is a non-locking version of fclose. It's identical except that it isn't protected from interference by other threads. It might be faster because it doesn't incur the overhead of locking out other threads. Use this function only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Function	Required header
_fclose_nolock	<stdio.h>

For more compatibility information, see Compatibility.

See also

Stream I/O
_close
_fdopen, _wfdopen
fflush
fopen, _wfopen
freopen, _wfreopen