System.Posix.IO

Copyright	(c) The University of Glasgow 2002
License	BSD-style (see the file libraries/base/LICENSE)
Maintainer	libraries@haskell.org
Stability	provisional
Portability	non-portable (requires POSIX)
Safe Haskell	Safe
Language	Haskell2010

Ввод/вывод

Стандартные дескрипторы файлов

stdInput :: Fd Source

stdOutput :: Fd Source

stdError :: Fd Source

Открытие и закрытие файлов

data OpenMode Source

data OpenFileFlags Source

Соответствуют некоторым целочисленным флагам из C's fcntl.h.

defaultFileFlags :: OpenFileFlags Source

Значения по умолчанию для типа OpenFileFlags. False для каждого из append, exclusive, noctty, nonBlock и trunc.

openFd Source

Открыть и, при необходимости, создать этот файл. См. Files для информации о том, как использовать тип FileMode.

createFile :: FilePath -> FileMode -> IO Fd Source

Создать и открыть этот файл в режиме WriteOnly. Специальный случай openFd. См. Files для информации о том, как использовать тип FileMode.

closeFd :: Fd -> IO () Source

Закрыть этот дескриптор файла. Может выбросить исключение, если это неверный дескриптор.

Чтение/запись данных

Программисты, использующие API fdRead и fdWrite, должны знать, что исключения EAGAIN могут возникать для неблокирующего IO!

fdRead Source

Прочитать данные из Fd и преобразовать их в String с использованием кодировки локали. Выбрасывает исключение, если это неверный дескриптор или достигнут конец файла.

fdWrite :: Fd -> String -> IO ByteCount Source

Записать String в Fd с использованием кодировки локали.

fdReadBuf Source

Прочитать данные из Fd в память. Это точно эквивалентно функции POSIX read.

fdWriteBuf Source

Записать данные из памяти в Fd. Это точно эквивалентно функции POSIX write.

Поиск

fdSeek :: Fd -> SeekMode -> FileOffset -> IO FileOffset Source

Может выбросить исключение, если это неверный дескриптор.

Параметры файлов

data FdOption Source

queryFdOption :: Fd -> FdOption -> IO Bool Source

Может выбросить исключение, если это недействительный дескриптор.

setFdOption :: Fd -> FdOption -> Bool -> IO () Source

Может выбросить исключение, если это недействительный дескриптор.

Блокировка

type FileLock = (LockRequest, SeekMode, FileOffset, FileOffset) Source

data LockRequest Source

getLock :: Fd -> FileLock -> IO (Maybe (ProcessID, FileLock)) Source

Может выбросить исключение, если это недействительный дескриптор.

setLock :: Fd -> FileLock -> IO () Source

Может выбросить исключение, если это недействительный дескриптор.

waitToSetLock :: Fd -> FileLock -> IO () Source

Может выбросить исключение, если это недействительный дескриптор.

Каналы

createPipe :: IO (Fd, Fd) Source

Функция createPipe создаёт пару соединённых дескрипторов файлов. Первый компонент — fd для чтения, второй — для записи. Хотя каналы могут быть двунаправленными, такое поведение не является переносимым, и программисты должны использовать два отдельных канала для этой цели. Может выбросить исключение, если это недействительный дескриптор.

Дублирование дескрипторов файлов

dup :: Fd -> IO Fd Source

Может выбросить исключение, если это недействительный дескриптор.

dupTo :: Fd -> Fd -> IO Fd Source

Может выбросить исключение, если это недействительный дескриптор.

Преобразование дескрипторов файлов в/из дескрипторов ручек

handleToFd :: Handle -> IO Fd Source

Извлекает Fd из Handle. Эта функция имеет побочный эффект закрытия Handle и сброса его буфера записи, если необходимо.

fdToHandle :: Fd -> IO Handle Source

Преобразует Fd в Handle, который можно использовать с стандартной библиотекой Haskell IO (см. System.IO).