Std.IO.StdStream

This module provides stdin/stderr/stdout reading and writings. Usually you don't have to use stderr or stderrBuf directly, Logger provides more logging utilities through stderr. While stdinBuf and stdoutBuf is useful when you write interactive programs, Buffered module provide many reading and writing operations. Example:

import Std.IO.LowResTimer
import Std.IO.Buffered
import Std.IO.StdStream

main = do
    -- read by '\n'
    b1 <- readLineStd
    -- read whatever user input in 3s, otherwise get Nothing
    b2 <- timeoutLowRes 30 $ readBuffered stdinBuf
    ...
    putStd "hello world!"

Standard input & output streams

data StdStream

Standard input and output streams

We support both regular file and TTY based streams, when initialized uv_guess_handle is called to decide which type of devices are connected to standard streams.

Note StdStream is not thread safe, you shouldn't use them without lock. For the same reason you shouldn't use stderr directly, use Logger module instead.

Instances

Output StdStream

Defined in Std.IO.StdStream

Methods

writeOutput :: StdStream -> Ptr Word8 -> Int -> IO ()

Input StdStream

Defined in Std.IO.StdStream

Methods

readInput :: StdStream -> Ptr Word8 -> Int -> IO Int

isStdStreamTTY :: StdStream -> Bool

data UVTTYMode where

Terminal mode.

When in UV_TTY_MODE_RAW mode, input is always available character-by-character, not including modifiers. Additionally, all special processing of characters by the terminal is disabled, including echoing input characters. Note that CTRL+C will no longer cause a SIGINT when in this mode.

Bundled Patterns

pattern UV_TTY_MODE_NORMAL :: UVTTYMode

pattern UV_TTY_MODE_RAW :: UVTTYMode

Instances

Eq UVTTYMode

Defined in Std.IO.UV.FFI

Methods

(==) :: UVTTYMode -> UVTTYMode -> Bool

(/=) :: UVTTYMode -> UVTTYMode -> Bool

Num UVTTYMode

Defined in Std.IO.UV.FFI

Methods

(+) :: UVTTYMode -> UVTTYMode -> UVTTYMode

(-) :: UVTTYMode -> UVTTYMode -> UVTTYMode

(*) :: UVTTYMode -> UVTTYMode -> UVTTYMode

negate :: UVTTYMode -> UVTTYMode

abs :: UVTTYMode -> UVTTYMode

signum :: UVTTYMode -> UVTTYMode

fromInteger :: Integer -> UVTTYMode

Ord UVTTYMode

Defined in Std.IO.UV.FFI

Methods

compare :: UVTTYMode -> UVTTYMode -> Ordering

(<) :: UVTTYMode -> UVTTYMode -> Bool

(<=) :: UVTTYMode -> UVTTYMode -> Bool

(>) :: UVTTYMode -> UVTTYMode -> Bool

(>=) :: UVTTYMode -> UVTTYMode -> Bool

max :: UVTTYMode -> UVTTYMode -> UVTTYMode

min :: UVTTYMode -> UVTTYMode -> UVTTYMode

Read UVTTYMode

Defined in Std.IO.UV.FFI

Methods

readsPrec :: Int -> ReadS UVTTYMode

readList :: ReadS [UVTTYMode]

readPrec :: ReadPrec UVTTYMode

readListPrec :: ReadPrec [UVTTYMode]

Show UVTTYMode

Defined in Std.IO.UV.FFI

Methods

showsPrec :: Int -> UVTTYMode -> ShowS

show :: UVTTYMode -> String

showList :: [UVTTYMode] -> ShowS

Storable UVTTYMode

Defined in Std.IO.UV.FFI

Methods

sizeOf :: UVTTYMode -> Int

alignment :: UVTTYMode -> Int

peekElemOff :: Ptr UVTTYMode -> Int -> IO UVTTYMode

pokeElemOff :: Ptr UVTTYMode -> Int -> UVTTYMode -> IO ()

peekByteOff :: Ptr b -> Int -> IO UVTTYMode

pokeByteOff :: Ptr b -> Int -> UVTTYMode -> IO ()

peek :: Ptr UVTTYMode -> IO UVTTYMode

poke :: Ptr UVTTYMode -> UVTTYMode -> IO ()

Bits UVTTYMode

Defined in Std.IO.UV.FFI

Methods

(.&.) :: UVTTYMode -> UVTTYMode -> UVTTYMode

(.|.) :: UVTTYMode -> UVTTYMode -> UVTTYMode

xor :: UVTTYMode -> UVTTYMode -> UVTTYMode

complement :: UVTTYMode -> UVTTYMode

shift :: UVTTYMode -> Int -> UVTTYMode

rotate :: UVTTYMode -> Int -> UVTTYMode

zeroBits :: UVTTYMode

bit :: Int -> UVTTYMode

setBit :: UVTTYMode -> Int -> UVTTYMode

clearBit :: UVTTYMode -> Int -> UVTTYMode

complementBit :: UVTTYMode -> Int -> UVTTYMode

testBit :: UVTTYMode -> Int -> Bool

bitSizeMaybe :: UVTTYMode -> Maybe Int

bitSize :: UVTTYMode -> Int

isSigned :: UVTTYMode -> Bool

shiftL :: UVTTYMode -> Int -> UVTTYMode

unsafeShiftL :: UVTTYMode -> Int -> UVTTYMode

shiftR :: UVTTYMode -> Int -> UVTTYMode

unsafeShiftR :: UVTTYMode -> Int -> UVTTYMode

rotateL :: UVTTYMode -> Int -> UVTTYMode

rotateR :: UVTTYMode -> Int -> UVTTYMode

popCount :: UVTTYMode -> Int

FiniteBits UVTTYMode

Defined in Std.IO.UV.FFI

Methods

finiteBitSize :: UVTTYMode -> Int

countLeadingZeros :: UVTTYMode -> Int

countTrailingZeros :: UVTTYMode -> Int

setStdinTTYMode :: UVTTYMode -> IO ()

Change terminal's mode if stdin is connected to a terminal.

stdin :: StdStream

stdout :: StdStream

stderr :: StdStream

Don't use stderr directly, use Logger instead.

stdinBuf :: BufferedInput StdStream

stdoutBuf :: BufferedOutput StdStream

stderrBuf :: BufferedOutput StdStream

utils

printStd :: ToText a => a -> IO ()

print a ToText to stdout

readLineStd :: IO Bytes

read a line from stdin

putStd :: Builder a -> IO ()

print a Builder and flush to stdout.

putLineStd :: Builder a -> IO ()

print a Builder and flush to stdout stdout, with a linefeed.