<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--Rendered using the Haskell Html Library v0.2--> <HTML ><HEAD ><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8" ><TITLE >System.IO.UTF8</TITLE ><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css" ><SCRIPT SRC="haddock-util.js" TYPE="text/javascript" ></SCRIPT ><SCRIPT TYPE="text/javascript" >window.onload = function () {setSynopsis("mini_System-IO-UTF8.html")};</SCRIPT ></HEAD ><BODY ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="topbar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" " ></TD ><TD CLASS="title" >utf8-string-0.3.3: Support for reading and writing UTF8 Strings</TD ><TD CLASS="topbut" ><A HREF="index.html" >Contents</A ></TD ><TD CLASS="topbut" ><A HREF="doc-index.html" >Index</A ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="modulebar" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD ><FONT SIZE="6" >System.IO.UTF8</FONT ></TD ><TD ALIGN="right" ><TABLE CLASS="narrow" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="infohead" >Portability</TD ><TD CLASS="infoval" >portable</TD ></TR ><TR ><TD CLASS="infohead" >Stability</TD ><TD CLASS="infoval" >experimental</TD ></TR ><TR ><TD CLASS="infohead" >Maintainer</TD ><TD CLASS="infoval" >emertens@galois.com</TD ></TR ></TABLE ></TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Description</TD ></TR ><TR ><TD CLASS="doc" >String IO preserving UTF8 encoding. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Synopsis</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="body" ><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0" ><TR ><TD CLASS="decl" ><A HREF="#v%3Aprint" >print</A > :: Show a => a -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AputStr" >putStr</A > :: String -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AputStrLn" >putStrLn</A > :: String -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AgetLine" >getLine</A > :: IO String</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AreadLn" >readLn</A > :: Read a => IO a</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AopenBinaryFile" >openBinaryFile</A > :: FilePath -> IOMode -> IO Handle</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AwithBinaryFile" >withBinaryFile</A > :: FilePath -> IOMode -> (Handle -> IO a) -> IO a</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AreadFile" >readFile</A > :: FilePath -> IO String</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AwriteFile" >writeFile</A > :: FilePath -> String -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AappendFile" >appendFile</A > :: FilePath -> String -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3Ainteract" >interact</A > :: (String -> String) -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AgetContents" >getContents</A > :: IO String</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AhGetLine" >hGetLine</A > :: Handle -> IO String</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AhGetContents" >hGetContents</A > :: Handle -> IO String</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AhPutStr" >hPutStr</A > :: Handle -> String -> IO ()</TD ></TR ><TR ><TD CLASS="s8" ></TD ></TR ><TR ><TD CLASS="decl" ><A HREF="#v%3AhPutStrLn" >hPutStrLn</A > :: Handle -> String -> IO ()</TD ></TR ></TABLE ></TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="section1" >Documentation</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3Aprint" ></A ><B >print</B > :: Show a => a -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >The <TT ><A HREF="System-IO-UTF8.html#v%3Aprint" >print</A ></TT > function outputs a value of any printable type to the standard output device. This function differs from the System.IO.print in that it preserves any UTF8 encoding of the shown value. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AputStr" ></A ><B >putStr</B > :: String -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >Write a UTF8 string to the standard output device </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AputStrLn" ></A ><B >putStrLn</B > :: String -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >The same as <TT ><A HREF="System-IO-UTF8.html#v%3AputStr" >putStr</A ></TT >, but adds a newline character. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AgetLine" ></A ><B >getLine</B > :: IO String</TD ></TR ><TR ><TD CLASS="doc" >Read a UTF8 line from the standard input device </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AreadLn" ></A ><B >readLn</B > :: Read a => IO a</TD ></TR ><TR ><TD CLASS="doc" >The <TT ><A HREF="System-IO-UTF8.html#v%3AreadLn" >readLn</A ></TT > function combines <TT ><A HREF="System-IO-UTF8.html#v%3AgetLine" >getLine</A ></TT > and readIO, preserving UTF8 </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AopenBinaryFile" ></A ><B >openBinaryFile</B > :: FilePath -> IOMode -> IO Handle</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AwithBinaryFile" ></A ><B >withBinaryFile</B > :: FilePath -> IOMode -> (Handle -> IO a) -> IO a</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AreadFile" ></A ><B >readFile</B > :: FilePath -> IO String</TD ></TR ><TR ><TD CLASS="doc" >The <TT ><A HREF="System-IO-UTF8.html#v%3AreadFile" >readFile</A ></TT > function reads a file and returns the contents of the file as a UTF8 string. The file is read lazily, on demand, as with <TT ><A HREF="System-IO-UTF8.html#v%3AgetContents" >getContents</A ></TT >. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AwriteFile" ></A ><B >writeFile</B > :: FilePath -> String -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >The computation <TT ><A HREF="System-IO-UTF8.html#v%3AwriteFile" >writeFile</A ></TT > <TT >file str</TT > function writes the UTF8 string <TT >str</TT >, to the file <TT >file</TT >. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AappendFile" ></A ><B >appendFile</B > :: FilePath -> String -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >The computation <TT ><A HREF="System-IO-UTF8.html#v%3AappendFile" >appendFile</A ></TT > <TT >file str</TT > function appends the UTF8 string <TT >str</TT >, to the file <TT >file</TT >. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3Ainteract" ></A ><B >interact</B > :: (String -> String) -> IO ()</TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AgetContents" ></A ><B >getContents</B > :: IO String</TD ></TR ><TR ><TD CLASS="doc" >Lazily read stdin as a UTF8 string. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AhGetLine" ></A ><B >hGetLine</B > :: Handle -> IO String</TD ></TR ><TR ><TD CLASS="doc" >Read a UTF8 line from a Handle </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AhGetContents" ></A ><B >hGetContents</B > :: Handle -> IO String</TD ></TR ><TR ><TD CLASS="doc" >Lazily read a UTF8 string from a Handle </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AhPutStr" ></A ><B >hPutStr</B > :: Handle -> String -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >Write a UTF8 string to a Handle. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="decl" ><A NAME="v%3AhPutStrLn" ></A ><B >hPutStrLn</B > :: Handle -> String -> IO ()</TD ></TR ><TR ><TD CLASS="doc" >Write a UTF8 string to a Handle, appending a newline. </TD ></TR ><TR ><TD CLASS="s15" ></TD ></TR ><TR ><TD CLASS="botbar" >Produced by <A HREF="http://www.haskell.org/haddock/" >Haddock</A > version 2.4.1</TD ></TR ></TABLE ></BODY ></HTML >