@@ -4,7 +4,6 @@
5-- Module : Data.Binary.Bits.Get
5-- Module : Data.Binary.Bits.Get
6-- Copyright : (c) Lennart Kolmodin 2010-2011
6-- Copyright : (c) Lennart Kolmodin 2010-2011
7−-- (c) Sylvain Henry 2015
8-- License : BSD3-style (see LICENSE)
7-- License : BSD3-style (see LICENSE)
10-- Maintainer : kolmodin@gmail.com
9-- Maintainer : kolmodin@gmail.com
@@ -60,19 +59,11 @@ module Data.Binary.Bits.Get
61 -- ** Get bytes
60 -- ** Get bytes
64 , getWord8
62 , getWord8
68 , getWord16be
63 , getWord16be
69 , getWord32be
64 , getWord32be
70 , getWord64be
65 , getWord64be
76 -- * Blocks
67 -- * Blocks
78 -- $blocks
69 -- $blocks
@@ -82,9 +73,6 @@ module Data.Binary.Bits.Get
82 -- ** Read in Blocks
73 -- ** Read in Blocks
88 , word16be
76 , word16be
89 , word32be
77 , word32be
90 , word64be
78 , word64be
@@ -95,28 +83,24 @@ module Data.Binary.Bits.Get
98−import Data.Binary.Get as B ( Get, getLazyByteString, isEmpty )
86+import Data.Binary.Get as B ( runGet, Get, getByteString, getLazyByteString, isEmpty )
99import Data.Binary.Get.Internal as B ( get, put, ensureN )
87import Data.Binary.Get.Internal as B ( get, put, ensureN )
100−import Data.Binary.Bits.BitOrder
101−import Data.Binary.Bits.Internal
102−import Data.Binary.Bits.Alignment
104import Data.ByteString as B
89import Data.ByteString as B
105import qualified Data.ByteString.Lazy as L
90import qualified Data.ByteString.Lazy as L
106import Data.ByteString.Unsafe
91import Data.ByteString.Unsafe
107−import Foreign.Marshal.Alloc (mallocBytes)
109−import Foreign.Storable (poke)
110−import System.IO.Unsafe (unsafePerformIO)
112import Data.Bits
93import Data.Bits
113import Data.Word
94import Data.Word
114import Control.Applicative
95import Control.Applicative
115−import Control.Monad (when,foldM_)
117import Prelude as P
97import Prelude as P
99+#if defined(__GLASGOW_HASKELL__) && !defined(__HADDOCK__)
118import GHC.Word
101import GHC.Word
119−import GHC.Base (uncheckedShiftLWord8#, wordToWord8#, Int (..), andWord8#, Word8#, (-#), Int#, xorI#, eqWord8#, TYPE)
102+#endif
121-- $bitget
105-- $bitget
122-- Parse bits using a monad.
106-- Parse bits using a monad.
@@ -165,120 +149,191 @@ import GHC.Base (uncheckedShiftLWord8#, wordToWord8#, Int (..), andWord8#, Word8
167data S = S {-# UNPACK #-} !ByteString -- Input
151data S = S {-# UNPACK #-} !ByteString -- Input
168− {-# UNPACK #-} !Int -- Bit offset (0-7)
152+ {-# UNPACK #-} !Int -- Bit offset (0-7)
169− !BitOrder -- Bit order
170 deriving (Show)
153 deriving (Show)
172−-- | Increment the current bit offset
155+-- | A block that will be read with only one boundry check. Needs to know the
156+-- number of bits in advance.
157+data Block a = Block Int (S -> a)
159+instance Functor Block where
160+ fmap f (Block i p) = Block i (\s -> f (p s))
162+instance Applicative Block where
163+ pure a = Block 0 (\_ -> a)
164+ (Block i p) <*> (Block j q) = Block (i+j) (\s -> p s $ q (incS i s))
165+ (Block i _) *> (Block j q) = Block (i+j) (q . incS i)
166+ (Block i p) <* (Block j _) = Block (i+j) p
168+-- | Get a block. Will be read with one single boundry check, and
169+-- therefore requires a statically known number of bits.
170+-- Build blocks using 'bool', 'word8', 'word16be', 'word32be', 'word64be',
171+-- 'byteString' and 'Applicative'.
172+block :: Block a -> BitGet a
173+block (Block i p) = do
176+ putState $! (incS i s)
173incS :: Int -> S -> S
179incS :: Int -> S -> S
183+ !n' = o' .&. make_mask 3
174−incS o (S bs n bo) = S (unsafeDrop d bs) n' bo
184+ in S (unsafeDrop d bs) n'
176− !o' = (n+o)
186+-- | make_mask 3 = 00000111
187+make_mask :: (Bits a, Num a) => Int -> a
188+make_mask n = (1 `shiftL` fromIntegral n) - 1
189+{-# SPECIALIZE make_mask :: Int -> Int #-}
190+{-# SPECIALIZE make_mask :: Int -> Word #-}
191+{-# SPECIALIZE make_mask :: Int -> Word8 #-}
192+{-# SPECIALIZE make_mask :: Int -> Word16 #-}
193+{-# SPECIALIZE make_mask :: Int -> Word32 #-}
194+{-# SPECIALIZE make_mask :: Int -> Word64 #-}
196+bit_offset :: Int -> Int
197+bit_offset n = make_mask 3 .&. n
177− !d = byte_offset o'
199+byte_offset :: Int -> Int
178− !n' = bit_offset o'
200+byte_offset n = n `shiftR` 3
180−-- | Read a single bit
181readBool :: S -> Bool
202readBool :: S -> Bool
182−readBool (S bs o bo) = case bo of
203+readBool (S bs n) = testBit (unsafeHead bs) (7-n)
183− BB -> testBit (unsafeHead bs) (7-o)
204+
184− BL -> testBit (unsafeHead bs) (7-o)
205+{-# INLINE readWord8 #-}
185− LL -> testBit (unsafeHead bs) o
206+readWord8 :: Int -> S -> Word8
186− LB -> testBit (unsafeHead bs) o
207+readWord8 n (S bs o)
187−
208+ -- no bits at all, return 0
188−-- | Read a single bit
209+ | n == 0 = 0
189−readBool# :: S -> Int
210+
190−readBool# (S bs (I# o) bo) = case bo of
211+ -- all bits are in the same byte
191− BB -> testBit# (7# -# o)
212+ -- we just need to shift and mask them right
192− BL -> testBit# (7# -# o)
213+ | n <= 8 - o = let w = unsafeHead bs
193− LL -> testBit# o
214+ m = make_mask n
194− LB -> testBit# o
215+ w' = (w `shiftr_w8` (8 - o - n)) .&. m
196− !(W8# w) = unsafeHead bs
217+
197− testBit# n = I# (((w `andWord8#` (wordToWord8# 1## `uncheckedShiftLWord8#` n)) `eqWord8#` wordToWord8# 0##) `xorI#` 1#)
218+ -- the bits are in two different bytes
198−
219+ -- make a word16 using both bytes, and then shift and mask
199−
220+ | n <= 8 = let w = (fromIntegral (unsafeHead bs) `shiftl_w16` 8) .|.
200−-- | Extract a range of bits from (ws :: ByteString)
221+ (fromIntegral (unsafeIndex bs 1))
201−--
222+ m = make_mask n
202−-- Constraint: 8 * (length ws -1 ) < o+n <= 8 * length ws
223+ w' = (w `shiftr_w16` (16 - o - n)) .&. m
203−extract :: (Num a, FastBits a) => BitOrder -> ByteString -> Int -> Int -> a
224+ in fromIntegral w'
204−extract bo bs o n
225+
205− | n == 0 = 0
226+{-# INLINE readWord16be #-}
206− | B.length bs == 0 = error "Empty ByteString"
227+readWord16be :: Int -> S -> Word16
207− | otherwise = rev . mask n . foldlWithIndex' f 0 $ bs
228+readWord16be n s@(S bs o)
209− -- B.foldl' with index
230+ -- 8 or fewer bits, use readWord8
210− foldlWithIndex' op b = fst . B.foldl' g (b,0)
231+ | n <= 8 = fromIntegral (readWord8 n s)
211− where g (b',i) w = (op b' w i, (i+1))
232+
212−
233+ -- handle 9 or more bits, stored in two bytes
213− -- 'or' correctly shifted words
234+
214− f b w i = b .|. (fromIntegral w `fastShift` off i)
235+ -- no offset, plain and simple 16 bytes
215−
236+ | o == 0 && n == 16 = let msb = fromIntegral (unsafeHead bs)
216− -- co-offset
237+ lsb = fromIntegral (unsafeIndex bs 1)
217− r = B.length bs * 8 - (o + n)
238+ w = (msb `shiftl_w16` 8) .|. lsb
219− -- shift offset depending on the byte position (0..B.length-1)
240+
220− off i = case bo of
241+ -- no offset, but not full 16 bytes
221− LL -> 8*i - o
242+ | o == 0 = let msb = fromIntegral (unsafeHead bs)
222− LB -> 8*i - o
243+ lsb = fromIntegral (unsafeIndex bs 1)
223− BB -> (B.length bs -1 - i) * 8 - r
244+ w = (msb `shiftl_w16` (n-8)) .|. (lsb `shiftr_w16` (16-n))
224− BL -> (B.length bs -1 - i) * 8 - r
245+ in w
226− -- reverse bits if necessary
247+ -- with offset, and n=9-16
227− rev = case bo of
248+ | n <= 16 = readWithOffset s shiftl_w16 shiftr_w16 n
228− LB -> reverseBits n
249+
229− BL -> reverseBits n
250+ | otherwise = error "readWord16be: tried to read more than 16 bits"
231− LL -> id
252+{-# INLINE readWord32be #-}
232−
253+readWord32be :: Int -> S -> Word32
233−
254+readWord32be n s@(S _ o)
234−-- | Generic readWord
255+ -- 8 or fewer bits, use readWord8
235−readWord :: (Num a, FastBits a) => Int -> S -> a
256+ | n <= 8 = fromIntegral (readWord8 n s)
236−readWord n (S bs o bo)
257+
237− | n == 0 = 0
258+ -- 16 or fewer bits, use readWord16be
238− | otherwise = extract bo (unsafeTake nbytes bs) o n
259+ | n <= 16 = fromIntegral (readWord16be n s)
239− where nbytes = byte_offset (o+n+7)
260+
240−
261+ | o == 0 = readWithoutOffset s shiftl_w32 shiftr_w32 n
241−-- | Check that the number of bits to read is not greater than the first parameter
262+
242−{-# INLINE readWordChecked #-}
263+ | n <= 32 = readWithOffset s shiftl_w32 shiftr_w32 n
243−readWordChecked :: (Num a, FastBits a) => Int -> Int -> S -> a
264+
244−readWordChecked m n s
265+ | otherwise = error "readWord32be: tried to read more than 32 bits"
245− | n > m = error $ "Tried to read more than " ++ show m ++ " bits (" ++ show n ++")"
266+
246− | otherwise = readWord n s
267+
247−
268+{-# INLINE readWord64be #-}
248−-- | Read the given number of bytes and return them in Big-Endian order
269+readWord64be :: Int -> S -> Word64
249−--
270+readWord64be n s@(S _ o)
250−-- Examples:
271+ -- 8 or fewer bits, use readWord8
251−-- BB: xxxABCDE FGHIJKLM NOPxxxxx -> ABCDEFGH IJKLMNOP
272+ | n <= 8 = fromIntegral (readWord8 n s)
252−-- LL: LMNOPxxx DEFGHIJK xxxxxABC -> ABCDEFGH IJKLMNOP
273+
253−-- BL: xxxPONML KJIHGFED CBAxxxxx -> ABCDEFGH IJKLMNOP
274+ -- 16 or fewer bits, use readWord16be
254−-- LB: EDCBAxxx MLKJIHGF xxxxxPON -> ABCDEFGH IJKLMNOP
275+ | n <= 16 = fromIntegral (readWord16be n s)
277+ | o == 0 = readWithoutOffset s shiftl_w64 shiftr_w64 n
279+ | n <= 64 = readWithOffset s shiftl_w64 shiftr_w64 n
281+ | otherwise = error "readWord64be: tried to read more than 64 bits"
255readByteString :: Int -> S -> ByteString
284readByteString :: Int -> S -> ByteString
256−readByteString n (S bs o bo) =
285+readByteString n s@(S bs o)
257− let
286+ -- no offset, easy.
258− bs' = unsafeTake (n+1) bs
287+ | o == 0 = unsafeTake n bs
259− bs'' = unsafeTake n bs
288+ -- offset. ugg. this is really naive and slow. but also pretty easy :)
260− rev = B.map (reverseBits 8)
289+ | otherwise = B.pack (P.map (readWord8 8) (P.take n (iterate (incS 8) s)))
261− in case (o,bo) of
290+
262− (0,BB) -> bs''
291+readWithoutOffset :: (Bits a, Num a)
263− (0,LL) -> B.reverse bs''
292+ => S -> (a -> Int -> a) -> (a -> Int -> a) -> Int -> a
264− (0,LB) -> rev bs''
293+readWithoutOffset (S bs o) shifterL shifterR n
265− (0,BL) -> rev . B.reverse $ bs''
294+ | o /= 0 = error "readWithoutOffset: there is an offset"
266− (_,LL) -> readByteString n (S (B.reverse bs') (8-o) BB)
295+
267− (_,BL) -> rev . B.reverse $ readByteString n (S bs' o BB)
296+ | bit_offset n == 0 && byte_offset n <= 4 =
268− (_,LB) -> rev . B.reverse $ readByteString n (S bs' o LL)
297+ let segs = byte_offset n
269− (_,BB) -> unsafePerformIO $ do
298+ bn 0 = fromIntegral (unsafeHead bs)
270− let len = n+1
299+ bn n = (bn (n-1) `shifterL` 8) .|. fromIntegral (unsafeIndex bs n)
271− ptr <- mallocBytes len
300+
272− let f r i = do
301+ in bn (segs-1)
274− w = unsafeIndex bs (len-i)
303+ | n <= 64 = let segs = byte_offset n
275− w' = (w `fastShiftL` o) .|. r
304+ o' = bit_offset (n - 8 + o)
276− r' = w `fastShiftR` (8-o)
305+
277− poke (ptr `plusPtr` (len-i)) w'
306+ bn 0 = fromIntegral (unsafeHead bs)
278− return r'
307+ bn n = (bn (n-1) `shifterL` 8) .|. fromIntegral (unsafeIndex bs n)
279− foldM_ f 0 [1..len]
308+
280− unsafeInit <$> unsafePackMallocCStringLen (ptr,len)
309+ msegs = bn (segs-1) `shifterL` o'
311+ last = (fromIntegral (unsafeIndex bs segs)) `shifterR` (8 - o')
316+readWithOffset :: (Bits a, Num a)
317+ => S -> (a -> Int -> a) -> (a -> Int -> a) -> Int -> a
318+readWithOffset (S bs o) shifterL shifterR n
319+ | n <= 64 = let bits_in_msb = 8 - o
320+ (n',top) = (n - bits_in_msb
321+ , (fromIntegral (unsafeHead bs) .&. make_mask bits_in_msb) `shifterL` n')
323+ segs = byte_offset n'
326+ bn n = (bn (n-1) `shifterL` 8) .|. fromIntegral (unsafeIndex bs n)
330+ mseg = bn segs `shifterL` o'
332+ last | o' > 0 = (fromIntegral (unsafeIndex bs (segs + 1))) `shifterR` (8 - o')
335+ w = top .|. mseg .|. last
283------------------------------------------------------------------------
338------------------------------------------------------------------------
284-- | 'BitGet' is a monad, applicative and a functor. See 'runBitGet'
339-- | 'BitGet' is a monad, applicative and a functor. See 'runBitGet'
@@ -287,6 +342,7 @@ newtype BitGet a = B { runState :: S -> Get (S,a) }
288instance Monad BitGet where
343instance Monad BitGet where
289 return x = B $ \s -> return (s,x)
344 return x = B $ \s -> return (s,x)
345+ fail str = B $ \(S inp n) -> putBackState inp n >> fail str
290 (B f) >>= g = B $ \s -> do (s',a) <- f s
346 (B f) >>= g = B $ \s -> do (s',a) <- f s
291 runState (g a) s'
347 runState (g a) s'
@@ -297,51 +353,25 @@ instance Applicative BitGet where
297 pure x = return x
353 pure x = return x
298 fm <*> m = fm >>= \f -> m >>= \v -> return (f v)
354 fm <*> m = fm >>= \f -> m >>= \v -> return (f v)
300−instance BitOrderable BitGet where
302− (S bs o _) <- getState
303− putState (S bs o bo)
306− (S _ _ bo) <- getState
309−instance Alignable BitGet where
310− -- | Skip the given number of bits
315− -- | Skip bits if necessary to align to the next byte
317− (S _ o _) <- getState
323-- | Run a 'BitGet' within the Binary packages 'Get' monad. If a byte has
356-- | Run a 'BitGet' within the Binary packages 'Get' monad. If a byte has
324-- been partially consumed it will be discarded once 'runBitGet' is finished.
357-- been partially consumed it will be discarded once 'runBitGet' is finished.
325runBitGet :: BitGet a -> Get a
358runBitGet :: BitGet a -> Get a
326runBitGet bg = do
359runBitGet bg = do
327 s <- mkInitState
360 s <- mkInitState
328− (s',a) <- runState bg s
361+ ((S str' n),a) <- runState bg s
329− putBackState s'
362+ putBackState str' n
332mkInitState :: Get S
365mkInitState :: Get S
333mkInitState = do
366mkInitState = do
334− bs <- get
367+ str <- get
335 put B.empty
368 put B.empty
336− return (S bs 0 BB)
369+ return (S str 0)
338−putBackState :: S -> Get ()
371+putBackState :: B.ByteString -> Int -> Get ()
339−putBackState (S bs o _) = do
372+putBackState bs n = do
340 remaining <- get
373 remaining <- get
343− _ -> unsafeDrop 1 bs
344− put (bs' `B.append` remaining)
374+ put (B.drop (if n==0 then 0 else 1) bs `B.append` remaining)
346getState :: BitGet S
376getState :: BitGet S
347getState = B $ \s -> return (s,s)
377getState = B $ \s -> return (s,s)
@@ -349,66 +379,38 @@ getState = B $ \s -> return (s,s)
349putState :: S -> BitGet ()
379putState :: S -> BitGet ()
350putState s = B $ \_ -> return (s,())
380putState s = B $ \_ -> return (s,())
352−withState :: (S -> S) -> BitGet ()
357-- | Make sure there are at least @n@ bits.
382-- | Make sure there are at least @n@ bits.
358ensureBits :: Int -> BitGet ()
383ensureBits :: Int -> BitGet ()
359ensureBits n = do
384ensureBits n = do
360− (S bs o bo) <- getState
385+ (S bs o) <- getState
361 if n <= (B.length bs * 8 - o)
386 if n <= (B.length bs * 8 - o)
362 then return ()
387 then return ()
363 else do let currentBits = B.length bs * 8 - o
388 else do let currentBits = B.length bs * 8 - o
364− let byteCount = byte_offset (n - currentBits + 7)
389+ let byteCount = (n - currentBits + 7) `div` 8
365 B $ \_ -> do B.ensureN byteCount
390 B $ \_ -> do B.ensureN byteCount
366 bs' <- B.get
391 bs' <- B.get
367 put B.empty
392 put B.empty
368− return (S (bs`append`bs') o bo, ())
393+ return (S (bs`append`bs') o, ())
370−-- | Test whether all input has been consumed, i.e. there are no remaining
372−isEmpty :: BitGet Bool
373−isEmpty = B $ \ (S bs o bo) -> if B.null bs
374− then B.isEmpty >>= \e -> return (S bs o bo, e)
375− else return (S bs o bo, False)
377-- | Get 1 bit as a 'Bool'.
395-- | Get 1 bit as a 'Bool'.
378getBool :: BitGet Bool
396getBool :: BitGet Bool
379getBool = block bool
397getBool = block bool
381−-- | Get 1 bit as a 'Bool'.
382−getBool# :: BitGet Int
383−getBool# = block bool#
385-- | Get @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
399-- | Get @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
386getWord8 :: Int -> BitGet Word8
400getWord8 :: Int -> BitGet Word8
387getWord8 n = block (word8 n)
401getWord8 n = block (word8 n)
389-- | Get @n@ bits as a 'Word16'. @n@ must be within @[0..16]@.
403-- | Get @n@ bits as a 'Word16'. @n@ must be within @[0..16]@.
390−getWord16 :: Int -> BitGet Word16
391−getWord16 n = block (word16 n)
393getWord16be :: Int -> BitGet Word16
404getWord16be :: Int -> BitGet Word16
394−getWord16be = getWord16
405+getWord16be n = block (word16be n)
395−{-# DEPRECATED getWord16be "Use 'getWord16' instead" #-}
397-- | Get @n@ bits as a 'Word32'. @n@ must be within @[0..32]@.
407-- | Get @n@ bits as a 'Word32'. @n@ must be within @[0..32]@.
398−getWord32 :: Int -> BitGet Word32
399−getWord32 n = block (word32 n)
401getWord32be :: Int -> BitGet Word32
408getWord32be :: Int -> BitGet Word32
402−getWord32be = getWord32
409+getWord32be n = block (word32be n)
403−{-# DEPRECATED getWord32be "Use 'getWord32' instead" #-}
405-- | Get @n@ bits as a 'Word64'. @n@ must be within @[0..64]@.
411-- | Get @n@ bits as a 'Word64'. @n@ must be within @[0..64]@.
406−getWord64 :: Int -> BitGet Word64
407−getWord64 n = block (word64 n)
409getWord64be :: Int -> BitGet Word64
412getWord64be :: Int -> BitGet Word64
410−getWord64be = getWord64
413+getWord64be n = block (word64be n)
411−{-# DEPRECATED getWord64be "Use 'getWord64' instead" #-}
413-- | Get @n@ bytes as a 'ByteString'.
415-- | Get @n@ bytes as a 'ByteString'.
414getByteString :: Int -> BitGet ByteString
416getByteString :: Int -> BitGet ByteString
@@ -417,80 +419,88 @@ getByteString n = block (byteString n)
417-- | Get @n@ bytes as a lazy ByteString.
419-- | Get @n@ bytes as a lazy ByteString.
418getLazyByteString :: Int -> BitGet L.ByteString
420getLazyByteString :: Int -> BitGet L.ByteString
419getLazyByteString n = do
421getLazyByteString n = do
420− (S _ o bo) <- getState
422+ (S _ o) <- getState
421 case o of
423 case o of
422− 0 -> B $ \s -> do
424+ 0 -> B $ \ (S bs o') -> do
423− putBackState s
425+ putBackState bs o'
424 lbs <- B.getLazyByteString (fromIntegral n)
426 lbs <- B.getLazyByteString (fromIntegral n)
425− return (S B.empty 0 bo, lbs)
427+ return (S B.empty 0, lbs)
426 _ -> L.fromChunks . (:[]) <$> Data.Binary.Bits.Get.getByteString n
428 _ -> L.fromChunks . (:[]) <$> Data.Binary.Bits.Get.getByteString n
428−
430+-- | Test whether all input has been consumed, i.e. there are no remaining
429−
431+-- undecoded bytes.
430−
432+isEmpty :: BitGet Bool
431−
433+isEmpty = B $ \ (S bs o) -> if B.null bs
432−-- | A block that will be read with only one boundary check. Needs to know the
434+ then B.isEmpty >>= \e -> return (S bs o, e)
433−-- number of bits in advance.
434−data Block a = Block Int (S -> a)
436−instance Functor Block where
437− fmap f (Block i p) = Block i (\s -> f (p s))
439−instance Applicative Block where
440− pure a = Block 0 (\_ -> a)
441− (Block i p) <*> (Block j q) = Block (i+j) (\s -> p s $ q (incS i s))
442− (Block i _) *> (Block j q) = Block (i+j) (q . incS i)
443− (Block i p) <* (Block j _) = Block (i+j) p
445−-- | Get a block. Will be read with one single boundry check, and
446−-- therefore requires a statically known number of bits.
447−-- Build blocks using 'bool', 'word8', 'word16be', 'word32be', 'word64be',
448−-- 'byteString' and 'Applicative'.
449−block :: Block a -> BitGet a
450−block (Block i p) = do
453− putState $! (incS i s)
454− return $! p s
435+ else return (S bs o, False)
456-- | Read a 1 bit 'Bool'.
437-- | Read a 1 bit 'Bool'.
457bool :: Block Bool
438bool :: Block Bool
458bool = Block 1 readBool
439bool = Block 1 readBool
460−-- | Read a 1 bit 'Bool'.
462−bool# = Block 1 readBool#
464-- | Read @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
441-- | Read @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
465word8 :: Int -> Block Word8
442word8 :: Int -> Block Word8
466−word8 n = Block n (readWordChecked 8 n)
443+word8 n = Block n (readWord8 n)
468-- | Read @n@ bits as a 'Word16'. @n@ must be within @[0..16]@.
445-- | Read @n@ bits as a 'Word16'. @n@ must be within @[0..16]@.
469−word16 :: Int -> Block Word16
470−word16 n = Block n (readWordChecked 16 n)
472word16be :: Int -> Block Word16
446word16be :: Int -> Block Word16
473−word16be = word16
447+word16be n = Block n (readWord16be n)
474−{-# DEPRECATED word16be "Use 'word16' instead" #-}
476-- | Read @n@ bits as a 'Word32'. @n@ must be within @[0..32]@.
449-- | Read @n@ bits as a 'Word32'. @n@ must be within @[0..32]@.
477−word32 :: Int -> Block Word32
478−word32 n = Block n (readWordChecked 32 n)
480word32be :: Int -> Block Word32
450word32be :: Int -> Block Word32
481−word32be = word32
451+word32be n = Block n (readWord32be n)
482−{-# DEPRECATED word32be "Use 'word32' instead" #-}
484-- | Read @n@ bits as a 'Word64'. @n@ must be within @[0..64]@.
453-- | Read @n@ bits as a 'Word64'. @n@ must be within @[0..64]@.
485−word64 :: Int -> Block Word64
486−word64 n = Block n (readWordChecked 64 n)
488word64be :: Int -> Block Word64
454word64be :: Int -> Block Word64
489−word64be = word64
455+word64be n = Block n (readWord64be n)
490−{-# DEPRECATED word64be "Use 'word64' instead" #-}
492-- | Read @n@ bytes as a 'ByteString'.
457-- | Read @n@ bytes as a 'ByteString'.
493byteString :: Int -> Block ByteString
458byteString :: Int -> Block ByteString
494byteString n | n > 0 = Block (n*8) (readByteString n)
459byteString n | n > 0 = Block (n*8) (readByteString n)
495 | otherwise = Block 0 (\_ -> B.empty)
460 | otherwise = Block 0 (\_ -> B.empty)
462+------------------------------------------------------------------------
463+-- Unchecked shifts, from the package binary
465+shiftl_w16 :: Word16 -> Int -> Word16
466+shiftl_w32 :: Word32 -> Int -> Word32
467+shiftl_w64 :: Word64 -> Int -> Word64
469+#if defined(__GLASGOW_HASKELL__) && !defined(__HADDOCK__)
470+shiftl_w8 (W8# w) (I# i) = W8# (w `uncheckedShiftL#` i)
471+shiftl_w16 (W16# w) (I# i) = W16# (w `uncheckedShiftL#` i)
472+shiftl_w32 (W32# w) (I# i) = W32# (w `uncheckedShiftL#` i)
474+shiftr_w8 (W8# w) (I# i) = W8# (w `uncheckedShiftRL#` i)
475+shiftr_w16 (W16# w) (I# i) = W16# (w `uncheckedShiftRL#` i)
476+shiftr_w32 (W32# w) (I# i) = W32# (w `uncheckedShiftRL#` i)
479+#if WORD_SIZE_IN_BITS < 64
480+shiftl_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftL64#` i)
481+shiftr_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftRL64#` i)
483+#if __GLASGOW_HASKELL__ <= 606
484+-- Exported by GHC.Word in GHC 6.8 and higher
485+foreign import ccall unsafe "stg_uncheckedShiftL64"
486+ uncheckedShiftL64# :: Word64# -> Int# -> Word64#
487+foreign import ccall unsafe "stg_uncheckedShiftRL64"
488+ uncheckedShiftRL64# :: Word64# -> Int# -> Word64#
492+shiftl_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftL#` i)
493+shiftr_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftRL#` i)