fileno()

Return the file descriptor for a stream

Synopsis:

#include <stdio.h>

int fileno( FILE * stream );

Arguments:

stream
The stream whose file descriptor you want to find.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fileno() function returns the file descriptor for the specified file stream. This file descriptor can be used in POSIX input/output calls anywhere the value returned by open() can be used.

To associate a stream with a file descriptor, call fdopen() .

In BlackBerry 10 OS, the file descriptor is also the connection ID (coid) used by various BlackBerry 10 OS-specific functions.

The following symbolic values in <unistd.h> define the file descriptors associated with the C language stdin , stdout , and stderr streams:

STDIN_FILENO
Standard input file number, stdin (0)
STDOUT_FILENO
Standard output file number, stdout (1)
STDERR_FILENO
Standard error file number, stderr (2)

Returns:

A file descriptor, or -1 if an error occurs ( errno is set).

Examples:

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
    FILE *stream;

    stream = fopen( "file", "r" );
    if( stream != NULL ) {
        printf( "File number is %d.\n", fileno( stream ) );
        fclose( stream );
        
        return EXIT_SUCCESS;
    }
    
    return EXIT_FAILURE;
}

Produces output similar to:

File number is 7.

Classification:

POSIX 1003.1

Safety:  
Cancellation point No
Interrupt handler No
Signal handler Yes
Thread Yes

Last modified: 2013-12-23

comments powered by Disqus