_fileno

Articolo
06/09/2015

Ottiene il descrittore del file associato a un flusso.

int _fileno( 
   FILE *stream 
);

Parametri

stream
Puntatore alla struttura FILE.

Valore restituito

_fileno restituisce il descrittore del file. Nessun ritorno di errore. Il risultato è indefinito se stream non specifica un file aperto. Se il flusso è NULL, _fileno invoca il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, questa funzione restituisce -1 ed imposta errno a EINVAL.

Per ulteriori informazioni su questi e altri codici, vedere _doserrno, errno, _sys_errlist, e _sys_nerr.

Nota

Se stdout o stderr non è associato a un flusso di output (ad esempio, in un'applicazione Windows senza una finestra della console), il descrittore del file restituito è -2.Nelle versioni precedenti, il descrittore del file restituito era -1.Questa modifica consente alle applicazioni di distinguere questa condizione da un errore.

Note

La routine _fileno restituisce il descrittore del file attualmente associato a stream. Questa procedura è implementata sia come funzione che come macro. Per informazioni sulla scelta di un'implementazione, vedere Scelta tra le funzioni e le macro .

Requisiti

Funzione	Intestazione obbligatoria
_fileno	<stdio.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

// 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 ) );
}