Movatterモバイル変換


[0]ホーム

URL:


base-4.12.0.0: Basic libraries

Copyright(c) The University of Glasgow 1994-2008
Licensesee libraries/base/LICENSE
Maintainerlibraries@haskell.org
Stabilityinternal
Portabilitynon-portable
Safe HaskellTrustworthy
LanguageHaskell2010

GHC.IO.Device

Description

Type classes for I/O providers.

Synopsis

Documentation

classRawIO awhereSource#

A low-level I/O provider where the data is bytes in memory.

Methods

read :: a ->PtrWord8 ->Int ->IOIntSource#

Read up to the specified number of bytes, returning the number of bytes actually read. This function should only block if there is no data available. If there is not enough data available, then the function should just return the available data. A return value of zero indicates that the end of the data stream (e.g. end of file) has been reached.

readNonBlocking :: a ->PtrWord8 ->Int ->IO (MaybeInt)Source#

Read up to the specified number of bytes, returning the number of bytes actually read, orNothing if the end of the stream has been reached.

write :: a ->PtrWord8 ->Int ->IO ()Source#

Write the specified number of bytes.

writeNonBlocking :: a ->PtrWord8 ->Int ->IOIntSource#

Write up to the specified number of bytes without blocking. Returns the actual number of bytes written.

classIODevice awhereSource#

I/O operations required for implementing aHandle.

Minimal complete definition

ready,close,devType

Methods

ready :: a ->Bool ->Int ->IOBoolSource#

ready dev write msecs returnsTrue if the device has data to read (ifwrite isFalse) or space to write new data (ifwrite isTrue).msecs specifies how long to wait, in milliseconds.

close :: a ->IO ()Source#

closes the device. Further operations on the device should produce exceptions.

isTerminal :: a ->IOBoolSource#

returnsTrue if the device is a terminal or console.

isSeekable :: a ->IOBoolSource#

returnsTrue if the device supportsseek operations.

seek :: a ->SeekMode ->Integer ->IO ()Source#

seek to the specified position in the data.

tell :: a ->IOIntegerSource#

return the current position in the data.

getSize :: a ->IOIntegerSource#

return the size of the data.

setSize :: a ->Integer ->IO ()Source#

change the size of the data.

setEcho :: a ->Bool ->IO ()Source#

for terminal devices, changes whether characters are echoed on the device.

getEcho :: a ->IOBoolSource#

returns the current echoing status.

setRaw :: a ->Bool ->IO ()Source#

some devices (e.g. terminals) support a "raw" mode where characters entered are immediately made available to the program. If available, this operations enables raw mode.

devType :: a ->IOIODeviceTypeSource#

returns theIODeviceType corresponding to this device.

dup :: a ->IO aSource#

duplicates the device, if possible. The new device is expected to share a file pointer with the original device (like Unixdup).

dup2 :: a -> a ->IO aSource#

dup2 source target replaces the target device with the source device. The target device is closed first, if necessary, and then it is made into a duplicate of the first device (like Unixdup2).

dataIODeviceTypeSource#

Type of a device that can be used to back aHandle (see alsomkFileHandle). The standard libraries provide creation ofHandles via Posix file operations with file descriptors (seemkHandleFromFD) with FD being the underlyingIODevice instance.

Users may provide custom instances ofIODevice which are expected to conform the following rules:

Constructors

Directory

The standard libraries do not have direct support for this device type, but a user implementation is expected to provide a list of file names in the directory, in any order, separated by'\0' characters, excluding the"." and".." names. See alsogetDirectoryContents. Seek operations are not supported on directories (other than to the zero position).

Stream

A duplex communications channel (results in creation of a duplexHandle). The standard libraries use this device type when creatingHandles for open sockets.

RegularFile

A file that may be read or written, and also may be seekable.

RawDevice

A "raw" (disk) device which supports block binary read and write operations and may be seekable only to positions of certain granularity (block- aligned).

Instances
EqIODeviceTypeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

dataSeekModeSource#

A mode that determines the effect ofhSeekhdl mode i.

Constructors

AbsoluteSeek

the position ofhdl is set toi.

RelativeSeek

the position ofhdl is set to offseti from the current position.

SeekFromEnd

the position ofhdl is set to offseti from the end of the file.

Instances
EnumSeekModeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

EqSeekModeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

OrdSeekModeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

ReadSeekModeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

ShowSeekModeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

IxSeekModeSource#

Since: 4.2.0.0

Instance details

Defined inGHC.IO.Device

Produced byHaddock version 2.20.0


[8]ページ先頭

©2009-2025 Movatter.jp