get-fmode.md

description	Learn more about: _get_fmode
title	_get_fmode
ms.date	4/2/2020
api_name	_get_fmode _o__get_fmode
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	get_fmode _get_fmode
helpviewer_keywords	_get_fmode function file translation [C++], default mode get_fmode function
ms.assetid	22ea70e2-b9b5-422d-b514-64f4beaea45c

_get_fmode

Gets the default file translation mode for file I/O operations.

Syntax

errno_t _get_fmode(
   int * pmode
);

Parameters

pmode
A pointer to an integer to be filled with the current default mode: _O_TEXT or _O_BINARY.

Return value

Returns zero if successful; an error code on failure. If pmode is NULL, the invalid parameter handler is invoked as described in Parameter validation. If execution is allowed to continue, errno is set to EINVAL and the function returns EINVAL.

Remarks

The function gets the value of the _fmode global variable. This variable specifies the default file translation mode for both low-level and stream file I/O operations, such as _open, _pipe, fopen, and freopen.

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

Requirements

Routine	Required header	Optional header
_get_fmode	<stdlib.h>	<fcntl.h>

For more compatibility information, see Compatibility.

Example

See the example in _set_fmode.

See also

_fmode
_set_fmode
_setmode
Text and binary mode file I/O