_fileno

Artigo
06/09/2015

Obtém o descritor de arquivo associado com um fluxo.

int _fileno( 
   FILE *stream 
);

Parâmetros

stream
Ponteiro para a estrutura FILE.

Valor de retorno

_fileno retorna o descritor de arquivo. Não há nenhum retorno de erro. O resultado é indefinido se stream não especificar um arquivo aberto. Se o fluxo é NULL, _fileno invoca o manipulador inválido do parâmetro, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, os essa função retornará -1 e definirá errno a EINVAL.

Para obter mais informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.

Dica

Se stdout ou stderr não são associados com um fluxo de saída (por exemplo, em um aplicativo do Windows sem uma janela do console), o descritor de arquivo retornado será -2.Em versões anteriores, o descritor de arquivo retornado foi -1.Essa alteração permite que aplicativos distinguir essa condição de erro.

Comentários

A rotina de _fileno retorna o descritor de arquivo associado atualmente com stream. Esta rotina é implementada como uma função e como uma macro. Para obter informações sobre como escolher qualquer implementação, consulte Escolha entre funções e macros.

Requisitos

Função	Cabeçalho necessário
_fileno	<stdio.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.

Exemplo

// crt_fileno.c
// This program uses _fileno to obtain
// the file descriptor for some standard C streams.
//

#include <stdio.h>

int main( void )
{
   printf( "The file descriptor for stdin is %d\n", _fileno( stdin ) );
   printf( "The file descriptor for stdout is %d\n", _fileno( stdout ) );
   printf( "The file descriptor for stderr is %d\n", _fileno( stderr ) );
}