<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head> <!-- Generated by HsColour, http://www.cs.york.ac.uk/fp/darcs/hscolour/ --> <title>src/Data/Binary/Put.hs</title> <link type='text/css' rel='stylesheet' href='hscolour.css' /> </head> <body> <pre><a name="line-1"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-2"></a><span class='hs-comment'>-- |</span> <a name="line-3"></a><span class='hs-comment'>-- Module : Data.Binary.Put</span> <a name="line-4"></a><span class='hs-comment'>-- Copyright : Lennart Kolmodin</span> <a name="line-5"></a><span class='hs-comment'>-- License : BSD3-style (see LICENSE)</span> <a name="line-6"></a><span class='hs-comment'>-- </span> <a name="line-7"></a><span class='hs-comment'>-- Maintainer : Lennart Kolmodin <kolmodin@dtek.chalmers.se></span> <a name="line-8"></a><span class='hs-comment'>-- Stability : stable</span> <a name="line-9"></a><span class='hs-comment'>-- Portability : Portable to Hugs and GHC. Requires MPTCs</span> <a name="line-10"></a><span class='hs-comment'>--</span> <a name="line-11"></a><span class='hs-comment'>-- The Put monad. A monad for efficiently constructing lazy bytestrings.</span> <a name="line-12"></a><span class='hs-comment'>--</span> <a name="line-13"></a><span class='hs-comment'>-----------------------------------------------------------------------------</span> <a name="line-14"></a> <a name="line-15"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Binary</span><span class='hs-varop'>.</span><span class='hs-conid'>Put</span> <span class='hs-layout'>(</span> <a name="line-16"></a> <a name="line-17"></a> <span class='hs-comment'>-- * The Put type</span> <a name="line-18"></a> <span class='hs-conid'>Put</span> <a name="line-19"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>PutM</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <a name="line-20"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>runPut</span> <a name="line-21"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>runPutM</span> <a name="line-22"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putBuilder</span> <a name="line-23"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>execPut</span> <a name="line-24"></a> <a name="line-25"></a> <span class='hs-comment'>-- * Flushing the implicit parse state</span> <a name="line-26"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>flush</span> <a name="line-27"></a> <a name="line-28"></a> <span class='hs-comment'>-- * Primitives</span> <a name="line-29"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord8</span> <a name="line-30"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putByteString</span> <a name="line-31"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putLazyByteString</span> <a name="line-32"></a> <a name="line-33"></a> <span class='hs-comment'>-- * Big-endian primitives</span> <a name="line-34"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord16be</span> <a name="line-35"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord32be</span> <a name="line-36"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord64be</span> <a name="line-37"></a> <a name="line-38"></a> <span class='hs-comment'>-- * Little-endian primitives</span> <a name="line-39"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord16le</span> <a name="line-40"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord32le</span> <a name="line-41"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord64le</span> <a name="line-42"></a> <a name="line-43"></a> <span class='hs-comment'>-- * Host-endian, unaligned writes</span> <a name="line-44"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWordhost</span> <span class='hs-comment'>-- :: Word -> Put</span> <a name="line-45"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord16host</span> <span class='hs-comment'>-- :: Word16 -> Put</span> <a name="line-46"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord32host</span> <span class='hs-comment'>-- :: Word32 -> Put</span> <a name="line-47"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>putWord64host</span> <span class='hs-comment'>-- :: Word64 -> Put</span> <a name="line-48"></a> <a name="line-49"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span> <a name="line-50"></a> <a name="line-51"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Monoid</span> <a name="line-52"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Binary</span><span class='hs-varop'>.</span><span class='hs-conid'>Builder</span> <span class='hs-layout'>(</span><span class='hs-conid'>Builder</span><span class='hs-layout'>,</span> <span class='hs-varid'>toLazyByteString</span><span class='hs-layout'>)</span> <a name="line-53"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Binary</span><span class='hs-varop'>.</span><span class='hs-conid'>Builder</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>B</span> <a name="line-54"></a> <a name="line-55"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Word</span> <a name="line-56"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>S</span> <a name="line-57"></a><span class='hs-keyword'>import</span> <span class='hs-keyword'>qualified</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-varop'>.</span><span class='hs-conid'>Lazy</span> <span class='hs-keyword'>as</span> <span class='hs-conid'>L</span> <a name="line-58"></a> <a name="line-59"></a><span class='hs-cpp'>#ifdef APPLICATIVE_IN_BASE</span> <a name="line-60"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Applicative</span> <a name="line-61"></a><span class='hs-cpp'>#endif</span> <a name="line-62"></a> <a name="line-63"></a> <a name="line-64"></a><span class='hs-comment'>------------------------------------------------------------------------</span> <a name="line-65"></a> <a name="line-66"></a><a name="PairS"></a><span class='hs-comment'>-- XXX Strict in buffer only. </span> <a name="line-67"></a><a name="PairS"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-comment'>{-# UNPACK #-}</span><span class='hs-varop'>!</span><span class='hs-conid'>Builder</span> <a name="line-68"></a> <a name="line-69"></a><a name="sndS"></a><span class='hs-definition'>sndS</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Builder</span> <a name="line-70"></a><span class='hs-definition'>sndS</span> <span class='hs-layout'>(</span><span class='hs-conid'>PairS</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>b</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>b</span> <a name="line-71"></a> <a name="line-72"></a><a name="PutM"></a><span class='hs-comment'>-- | The PutM type. A Writer monad over the efficient Builder monoid.</span> <a name="line-73"></a><a name="PutM"></a><span class='hs-keyword'>newtype</span> <span class='hs-conid'>PutM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-layout'>{</span> <span class='hs-varid'>unPut</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-layout'>}</span> <a name="line-74"></a> <a name="line-75"></a><a name="Put"></a><span class='hs-comment'>-- | Put merely lifts Builder into a Writer monad, applied to ().</span> <a name="line-76"></a><a name="Put"></a><span class='hs-keyword'>type</span> <span class='hs-conid'>Put</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>PutM</span> <span class='hs-conid'>()</span> <a name="line-77"></a> <a name="line-78"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Functor</span> <span class='hs-conid'>PutM</span> <span class='hs-keyword'>where</span> <a name="line-79"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-varid'>m</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>let</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-varid'>m</span> <span class='hs-keyword'>in</span> <span class='hs-conid'>PairS</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>w</span> <a name="line-80"></a> <span class='hs-comment'>{-# INLINE fmap #-}</span> <a name="line-81"></a> <a name="line-82"></a><span class='hs-cpp'>#ifdef APPLICATIVE_IN_BASE</span> <a name="line-83"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Applicative</span> <span class='hs-conid'>PutM</span> <span class='hs-keyword'>where</span> <a name="line-84"></a> <span class='hs-varid'>pure</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <a name="line-85"></a> <span class='hs-varid'>m</span> <span class='hs-varop'><*></span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-varop'>$</span> <a name="line-86"></a> <span class='hs-keyword'>let</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>f</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-varid'>m</span> <a name="line-87"></a> <span class='hs-conid'>PairS</span> <span class='hs-varid'>x</span> <span class='hs-varid'>w'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-varid'>k</span> <a name="line-88"></a> <span class='hs-keyword'>in</span> <span class='hs-conid'>PairS</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>w</span> <span class='hs-varop'>`mappend`</span> <span class='hs-varid'>w'</span><span class='hs-layout'>)</span> <a name="line-89"></a><span class='hs-cpp'>#endif</span> <a name="line-90"></a> <a name="line-91"></a><span class='hs-comment'>-- Standard Writer monad, with aggressive inlining</span> <a name="line-92"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Monad</span> <span class='hs-conid'>PutM</span> <span class='hs-keyword'>where</span> <a name="line-93"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-varop'>$</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-varid'>mempty</span> <a name="line-94"></a> <span class='hs-comment'>{-# INLINE return #-}</span> <a name="line-95"></a> <a name="line-96"></a> <span class='hs-varid'>m</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-varop'>$</span> <a name="line-97"></a> <span class='hs-keyword'>let</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>a</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-varid'>m</span> <a name="line-98"></a> <span class='hs-conid'>PairS</span> <span class='hs-varid'>b</span> <span class='hs-varid'>w'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-layout'>(</span><span class='hs-varid'>k</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <a name="line-99"></a> <span class='hs-keyword'>in</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>b</span> <span class='hs-layout'>(</span><span class='hs-varid'>w</span> <span class='hs-varop'>`mappend`</span> <span class='hs-varid'>w'</span><span class='hs-layout'>)</span> <a name="line-100"></a> <span class='hs-comment'>{-# INLINE (>>=) #-}</span> <a name="line-101"></a> <a name="line-102"></a> <span class='hs-varid'>m</span> <span class='hs-varop'>>></span> <span class='hs-varid'>k</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-varop'>$</span> <a name="line-103"></a> <span class='hs-keyword'>let</span> <span class='hs-conid'>PairS</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>w</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-varid'>m</span> <a name="line-104"></a> <span class='hs-conid'>PairS</span> <span class='hs-varid'>b</span> <span class='hs-varid'>w'</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unPut</span> <span class='hs-varid'>k</span> <a name="line-105"></a> <span class='hs-keyword'>in</span> <span class='hs-conid'>PairS</span> <span class='hs-varid'>b</span> <span class='hs-layout'>(</span><span class='hs-varid'>w</span> <span class='hs-varop'>`mappend`</span> <span class='hs-varid'>w'</span><span class='hs-layout'>)</span> <a name="line-106"></a> <span class='hs-comment'>{-# INLINE (>>) #-}</span> <a name="line-107"></a> <a name="line-108"></a><a name="tell"></a><span class='hs-definition'>tell</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Builder</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-109"></a><span class='hs-definition'>tell</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Put</span> <span class='hs-varop'>$</span> <span class='hs-conid'>PairS</span> <span class='hs-conid'>()</span> <span class='hs-varid'>b</span> <a name="line-110"></a><span class='hs-comment'>{-# INLINE tell #-}</span> <a name="line-111"></a> <a name="line-112"></a><a name="putBuilder"></a><span class='hs-definition'>putBuilder</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Builder</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-113"></a><span class='hs-definition'>putBuilder</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <a name="line-114"></a><span class='hs-comment'>{-# INLINE putBuilder #-}</span> <a name="line-115"></a> <a name="line-116"></a><a name="execPut"></a><span class='hs-comment'>-- | Run the 'Put' monad</span> <a name="line-117"></a><span class='hs-definition'>execPut</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>PutM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Builder</span> <a name="line-118"></a><span class='hs-definition'>execPut</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>sndS</span> <span class='hs-varop'>.</span> <span class='hs-varid'>unPut</span> <a name="line-119"></a><span class='hs-comment'>{-# INLINE execPut #-}</span> <a name="line-120"></a> <a name="line-121"></a><a name="runPut"></a><span class='hs-comment'>-- | Run the 'Put' monad with a serialiser</span> <a name="line-122"></a><span class='hs-definition'>runPut</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Put</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <a name="line-123"></a><span class='hs-definition'>runPut</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>toLazyByteString</span> <span class='hs-varop'>.</span> <span class='hs-varid'>sndS</span> <span class='hs-varop'>.</span> <span class='hs-varid'>unPut</span> <a name="line-124"></a><span class='hs-comment'>{-# INLINE runPut #-}</span> <a name="line-125"></a> <a name="line-126"></a><a name="runPutM"></a><span class='hs-comment'>-- | Run the 'Put' monad with a serialiser and get its result</span> <a name="line-127"></a><span class='hs-definition'>runPutM</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>PutM</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span><span class='hs-layout'>)</span> <a name="line-128"></a><span class='hs-definition'>runPutM</span> <span class='hs-layout'>(</span><span class='hs-conid'>Put</span> <span class='hs-layout'>(</span><span class='hs-conid'>PairS</span> <span class='hs-varid'>f</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span><span class='hs-layout'>,</span> <span class='hs-varid'>toLazyByteString</span> <span class='hs-varid'>s</span><span class='hs-layout'>)</span> <a name="line-129"></a><span class='hs-comment'>{-# INLINE runPutM #-}</span> <a name="line-130"></a> <a name="line-131"></a><span class='hs-comment'>------------------------------------------------------------------------</span> <a name="line-132"></a> <a name="line-133"></a><a name="flush"></a><span class='hs-comment'>-- | Pop the ByteString we have constructed so far, if any, yielding a</span> <a name="line-134"></a><span class='hs-comment'>-- new chunk in the result ByteString.</span> <a name="line-135"></a><span class='hs-definition'>flush</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Put</span> <a name="line-136"></a><span class='hs-definition'>flush</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>flush</span> <a name="line-137"></a><span class='hs-comment'>{-# INLINE flush #-}</span> <a name="line-138"></a> <a name="line-139"></a><a name="putWord8"></a><span class='hs-comment'>-- | Efficiently write a byte into the output buffer</span> <a name="line-140"></a><span class='hs-definition'>putWord8</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word8</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-141"></a><span class='hs-definition'>putWord8</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>singleton</span> <a name="line-142"></a><span class='hs-comment'>{-# INLINE putWord8 #-}</span> <a name="line-143"></a> <a name="line-144"></a><a name="putByteString"></a><span class='hs-comment'>-- | An efficient primitive to write a strict ByteString into the output buffer.</span> <a name="line-145"></a><span class='hs-comment'>-- It flushes the current buffer, and writes the argument into a new chunk.</span> <a name="line-146"></a><span class='hs-definition'>putByteString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>S</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-147"></a><span class='hs-definition'>putByteString</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>fromByteString</span> <a name="line-148"></a><span class='hs-comment'>{-# INLINE putByteString #-}</span> <a name="line-149"></a> <a name="line-150"></a><a name="putLazyByteString"></a><span class='hs-comment'>-- | Write a lazy ByteString efficiently, simply appending the lazy</span> <a name="line-151"></a><span class='hs-comment'>-- ByteString chunks to the output buffer</span> <a name="line-152"></a><span class='hs-definition'>putLazyByteString</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>L</span><span class='hs-varop'>.</span><span class='hs-conid'>ByteString</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-153"></a><span class='hs-definition'>putLazyByteString</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>fromLazyByteString</span> <a name="line-154"></a><span class='hs-comment'>{-# INLINE putLazyByteString #-}</span> <a name="line-155"></a> <a name="line-156"></a><a name="putWord16be"></a><span class='hs-comment'>-- | Write a Word16 in big endian format</span> <a name="line-157"></a><span class='hs-definition'>putWord16be</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word16</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-158"></a><span class='hs-definition'>putWord16be</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord16be</span> <a name="line-159"></a><span class='hs-comment'>{-# INLINE putWord16be #-}</span> <a name="line-160"></a> <a name="line-161"></a><a name="putWord16le"></a><span class='hs-comment'>-- | Write a Word16 in little endian format</span> <a name="line-162"></a><span class='hs-definition'>putWord16le</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word16</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-163"></a><span class='hs-definition'>putWord16le</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord16le</span> <a name="line-164"></a><span class='hs-comment'>{-# INLINE putWord16le #-}</span> <a name="line-165"></a> <a name="line-166"></a><a name="putWord32be"></a><span class='hs-comment'>-- | Write a Word32 in big endian format</span> <a name="line-167"></a><span class='hs-definition'>putWord32be</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word32</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-168"></a><span class='hs-definition'>putWord32be</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord32be</span> <a name="line-169"></a><span class='hs-comment'>{-# INLINE putWord32be #-}</span> <a name="line-170"></a> <a name="line-171"></a><a name="putWord32le"></a><span class='hs-comment'>-- | Write a Word32 in little endian format</span> <a name="line-172"></a><span class='hs-definition'>putWord32le</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word32</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-173"></a><span class='hs-definition'>putWord32le</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord32le</span> <a name="line-174"></a><span class='hs-comment'>{-# INLINE putWord32le #-}</span> <a name="line-175"></a> <a name="line-176"></a><a name="putWord64be"></a><span class='hs-comment'>-- | Write a Word64 in big endian format</span> <a name="line-177"></a><span class='hs-definition'>putWord64be</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-178"></a><span class='hs-definition'>putWord64be</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord64be</span> <a name="line-179"></a><span class='hs-comment'>{-# INLINE putWord64be #-}</span> <a name="line-180"></a> <a name="line-181"></a><a name="putWord64le"></a><span class='hs-comment'>-- | Write a Word64 in little endian format</span> <a name="line-182"></a><span class='hs-definition'>putWord64le</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-183"></a><span class='hs-definition'>putWord64le</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord64le</span> <a name="line-184"></a><span class='hs-comment'>{-# INLINE putWord64le #-}</span> <a name="line-185"></a> <a name="line-186"></a><span class='hs-comment'>------------------------------------------------------------------------</span> <a name="line-187"></a> <a name="line-188"></a><a name="putWordhost"></a><span class='hs-comment'>-- | /O(1)./ Write a single native machine word. The word is</span> <a name="line-189"></a><span class='hs-comment'>-- written in host order, host endian form, for the machine you're on.</span> <a name="line-190"></a><span class='hs-comment'>-- On a 64 bit machine the Word is an 8 byte value, on a 32 bit machine,</span> <a name="line-191"></a><span class='hs-comment'>-- 4 bytes. Values written this way are not portable to</span> <a name="line-192"></a><span class='hs-comment'>-- different endian or word sized machines, without conversion.</span> <a name="line-193"></a><span class='hs-comment'>--</span> <a name="line-194"></a><span class='hs-definition'>putWordhost</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-195"></a><span class='hs-definition'>putWordhost</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWordhost</span> <a name="line-196"></a><span class='hs-comment'>{-# INLINE putWordhost #-}</span> <a name="line-197"></a> <a name="line-198"></a><a name="putWord16host"></a><span class='hs-comment'>-- | /O(1)./ Write a Word16 in native host order and host endianness.</span> <a name="line-199"></a><span class='hs-comment'>-- For portability issues see @putWordhost@.</span> <a name="line-200"></a><span class='hs-definition'>putWord16host</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word16</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-201"></a><span class='hs-definition'>putWord16host</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord16host</span> <a name="line-202"></a><span class='hs-comment'>{-# INLINE putWord16host #-}</span> <a name="line-203"></a> <a name="line-204"></a><a name="putWord32host"></a><span class='hs-comment'>-- | /O(1)./ Write a Word32 in native host order and host endianness.</span> <a name="line-205"></a><span class='hs-comment'>-- For portability issues see @putWordhost@.</span> <a name="line-206"></a><span class='hs-definition'>putWord32host</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word32</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-207"></a><span class='hs-definition'>putWord32host</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord32host</span> <a name="line-208"></a><span class='hs-comment'>{-# INLINE putWord32host #-}</span> <a name="line-209"></a> <a name="line-210"></a><a name="putWord64host"></a><span class='hs-comment'>-- | /O(1)./ Write a Word64 in native host order</span> <a name="line-211"></a><span class='hs-comment'>-- On a 32 bit machine we write two host order Word32s, in big endian form.</span> <a name="line-212"></a><span class='hs-comment'>-- For portability issues see @putWordhost@.</span> <a name="line-213"></a><span class='hs-definition'>putWord64host</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Word64</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Put</span> <a name="line-214"></a><span class='hs-definition'>putWord64host</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>tell</span> <span class='hs-varop'>.</span> <span class='hs-conid'>B</span><span class='hs-varop'>.</span><span class='hs-varid'>putWord64host</span> <a name="line-215"></a><span class='hs-comment'>{-# INLINE putWord64host #-}</span> </pre></body> </html>