Copyright | (c) The University of Glasgow 1994-2008 |
---|---|
License | see libraries/base/LICENSE |
Maintainer | libraries@haskell.org |
Stability | internal |
Portability | non-portable |
Safe Haskell | Trustworthy |
Language | Haskell2010 |
Type classes for I/O providers.
Synopsis
- class RawIO a where
- class IODevice a where
- ready :: a -> Bool -> Int -> IO Bool
- close :: a -> IO ()
- isTerminal :: a -> IO Bool
- isSeekable :: a -> IO Bool
- seek :: a -> SeekMode -> Integer -> IO Integer
- tell :: a -> IO Integer
- getSize :: a -> IO Integer
- setSize :: a -> Integer -> IO ()
- setEcho :: a -> Bool -> IO ()
- getEcho :: a -> IO Bool
- setRaw :: a -> Bool -> IO ()
- devType :: a -> IO IODeviceType
- dup :: a -> IO a
- dup2 :: a -> a -> IO a
- data IODeviceType
- data SeekMode
Documentation
A low-level I/O provider where the data is bytes in memory. The Word64 offsets currently have no effect on POSIX system or consoles where the implicit behaviour of the C runtime is assume to move the file pointer on every read/write without needing an explicit seek.
read :: a -> Ptr Word8 -> Word64 -> Int -> IO Int Source #
Read up to the specified number of bytes starting from a specified offset, 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 -> Ptr Word8 -> Word64 -> Int -> IO (Maybe Int) Source #
Read up to the specified number of bytes starting from a specified
offset, returning the number of bytes actually read, or Nothing
if
the end of the stream has been reached.
write :: a -> Ptr Word8 -> Word64 -> Int -> IO () Source #
Write the specified number of bytes starting at a given offset.
writeNonBlocking :: a -> Ptr Word8 -> Word64 -> Int -> IO Int Source #
Write up to the specified number of bytes without blocking starting at a given offset. Returns the actual number of bytes written.
class IODevice a where Source #
I/O operations required for implementing a Handle
.
ready :: a -> Bool -> Int -> IO Bool Source #
ready dev write msecs
returns True
if the device has data
to read (if write
is False
) or space to write new data (if
write
is True
). msecs
specifies how long to wait, in
milliseconds.
closes the device. Further operations on the device should produce exceptions.
isTerminal :: a -> IO Bool Source #
returns True
if the device is a terminal or console.
isSeekable :: a -> IO Bool Source #
seek :: a -> SeekMode -> Integer -> IO Integer Source #
seek to the specified position in the data.
tell :: a -> IO Integer Source #
return the current position in the data.
getSize :: a -> IO Integer Source #
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 -> IO Bool Source #
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 -> IO IODeviceType Source #
returns the IODeviceType
corresponding to this device.
duplicates the device, if possible. The new device is expected
to share a file pointer with the original device (like Unix dup
).
dup2 :: a -> a -> IO a Source #
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 Unix dup2
).
Instances
IODevice FD Source # | Since: base-4.1.0.0 |
Defined in GHC.IO.FD ready :: FD -> Bool -> Int -> IO Bool Source # isTerminal :: FD -> IO Bool Source # isSeekable :: FD -> IO Bool Source # seek :: FD -> SeekMode -> Integer -> IO Integer Source # tell :: FD -> IO Integer Source # getSize :: FD -> IO Integer Source # setSize :: FD -> Integer -> IO () Source # setEcho :: FD -> Bool -> IO () Source # getEcho :: FD -> IO Bool Source # setRaw :: FD -> Bool -> IO () Source # |
data IODeviceType Source #
Type of a device that can be used to back a
Handle
(see also mkFileHandle
). The
standard libraries provide creation of Handle
s via
Posix file operations with file descriptors (see
mkHandleFromFD
) with FD being the underlying
IODevice
instance.
Users may provide custom instances of IODevice
which are expected to conform the following rules:
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 |
Stream | A duplex communications channel (results in
creation of a duplex |
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
Eq IODeviceType Source # | Since: base-4.2.0.0 |
Defined in GHC.IO.Device (==) :: IODeviceType -> IODeviceType -> Bool Source # (/=) :: IODeviceType -> IODeviceType -> Bool Source # |
A mode that determines the effect of hSeek
hdl mode i
.
AbsoluteSeek | the position of |
RelativeSeek | the position of |
SeekFromEnd | the position of |
Instances
Enum SeekMode Source # | Since: base-4.2.0.0 |
Defined in GHC.IO.Device succ :: SeekMode -> SeekMode Source # pred :: SeekMode -> SeekMode Source # toEnum :: Int -> SeekMode Source # fromEnum :: SeekMode -> Int Source # enumFrom :: SeekMode -> [SeekMode] Source # enumFromThen :: SeekMode -> SeekMode -> [SeekMode] Source # enumFromTo :: SeekMode -> SeekMode -> [SeekMode] Source # enumFromThenTo :: SeekMode -> SeekMode -> SeekMode -> [SeekMode] Source # | |
Ix SeekMode Source # | Since: base-4.2.0.0 |
Defined in GHC.IO.Device | |
Read SeekMode Source # | Since: base-4.2.0.0 |
Show SeekMode Source # | Since: base-4.2.0.0 |
Eq SeekMode Source # | Since: base-4.2.0.0 |
Ord SeekMode Source # | Since: base-4.2.0.0 |
Defined in GHC.IO.Device |