Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



   fileno    ( 3 )

получить файловый дескриптор потока stdio (obtain file descriptor of a stdio stream)

Имя (Name)

fileno - obtain file descriptor of a stdio stream


Синопсис (Synopsis)

#include <stdio.h>

int fileno(FILE *stream);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

fileno(): _POSIX_C_SOURCE


Описание (Description)

The function fileno() examines the argument stream and returns the integer file descriptor used to implement this stream. The file descriptor is still owned by stream and will be closed when fclose(3) is called. Duplicate the file descriptor with dup(2) before passing it to code that might close it.

For the nonlocking counterpart, see unlocked_stdio(3).


Возвращаемое значение (Return value)

On success, fileno() returns the file descriptor associated with stream. On failure, -1 is returned and errno is set to indicate the error.


Ошибки (Error)

EBADF stream is not associated with a file.


Атрибуты (Attributes)

For an explanation of the terms used in this section, see attributes(7).

┌──────────────────────────────────────┬───────────────┬─────────┐ │Interface Attribute Value │ ├──────────────────────────────────────┼───────────────┼─────────┤ │fileno() │ Thread safety │ MT-Safe │ └──────────────────────────────────────┴───────────────┴─────────┘


Стандарты (Conforming to)

The function fileno() conforms to POSIX.1-2001 and POSIX.1-2008.


Смотри также (See also)

open(2), fdopen(3), stdio(3), unlocked_stdio(3)