_fileno

Artigo
02/25/2013

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

int _fileno( 
   FILE *stream 
);

Parâmetros

stream
Ponteiro para o FILE estrutura.

Valor de retorno

_filenoRetorna o descritor de arquivo.Não há nenhum retorno de erro.O resultado é indefinido se stream não especifica um arquivo aberto.Se o fluxo é NULL, _fileno chama o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, esta função retornará -1 e conjuntos de errno para EINVAL.

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

Observação
Se stdout ou stderr não está associado com um fluxo de saída (por exemplo, em um aplicativo do Windows sem uma janela de console), o descritor de arquivo retornado é -2.Nas versões anteriores, o descritor de arquivo retornado era -1.Essa alteração permite que os aplicativos diferenciar esta condição de erro.

Comentários

O _fileno rotina retorna o descritor de arquivo associado no momento stream.Esta rotina é implementada como uma função e uma macro.Para obter informações sobre como escolher qualquer implementação, consulte Escolhendo entre funções e Macros.

Requisitos

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

Para obter mais informações de 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 ) );
}