@@ -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,11 +59,7 @@ 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
@@ -82,9 +77,6 @@ module Data.Binary.Bits.Get
82 -- ** Read in Blocks
77 -- ** Read in Blocks
88 , word16be
80 , word16be
89 , word32be
81 , word32be
90 , word64be
82 , word64be
@@ -97,9 +89,6 @@ module Data.Binary.Bits.Get
98import Data.Binary.Get as B ( Get, getLazyByteString, isEmpty )
90import Data.Binary.Get as B ( Get, getLazyByteString, isEmpty )
99import Data.Binary.Get.Internal as B ( get, put, ensureN )
91import 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
93import Data.ByteString as B
105import qualified Data.ByteString.Lazy as L
94import qualified Data.ByteString.Lazy as L
@@ -115,8 +104,12 @@ import Control.Applicative
115import Control.Monad (when,foldM_)
104import Control.Monad (when,foldM_)
117import Prelude as P
106import Prelude as P
108+#if defined(__GLASGOW_HASKELL__) && !defined(__HADDOCK__)
118import GHC.Word
110import GHC.Word
119−import GHC.Base (uncheckedShiftLWord8#, wordToWord8#, Int (..), andWord8#, Word8#, (-#), Int#, xorI#, eqWord8#, TYPE)
111+#endif
121-- $bitget
114-- $bitget
122-- Parse bits using a monad.
115-- Parse bits using a monad.
@@ -165,120 +158,197 @@ import GHC.Base (uncheckedShiftLWord8#, wordToWord8#, Int (..), andWord8#, Word8
167data S = S {-# UNPACK #-} !ByteString -- Input
160data S = S {-# UNPACK #-} !ByteString -- Input
168− {-# UNPACK #-} !Int -- Bit offset (0-7)
161+ {-# UNPACK #-} !Int -- Bit offset (0-7)
169− !BitOrder -- Bit order
170 deriving (Show)
162 deriving (Show)
164+-- | A block that will be read with only one boundary check. Needs to know the
165+-- number of bits in advance.
166+data Block a = Block Int (S -> a)
168+instance Functor Block where
169+ fmap f (Block i p) = Block i (\s -> f (p s))
171+instance Applicative Block where
172+ pure a = Block 0 (\_ -> a)
173+ (Block i p) <*> (Block j q) = Block (i+j) (\s -> p s $ q (incS i s))
174+ (Block i _) *> (Block j q) = Block (i+j) (q . incS i)
175+ (Block i p) <* (Block j _) = Block (i+j) p
177+-- | Get a block. Will be read with one single boundry check, and
178+-- therefore requires a statically known number of bits.
179+-- Build blocks using 'bool', 'word8', 'word16be', 'word32be', 'word64be',
180+-- 'byteString' and 'Applicative'.
181+block :: Block a -> BitGet a
182+block (Block i p) = do
185+ putState $! (incS i s)
188+-- | Compute bit offset (equivalent to x `mod` 8 but faster)
189+bit_offset :: Int -> Int
190+bit_offset n = make_mask 3 .&. n
191+{-# INLINE bit_offset #-}
193+-- | Compute byte offset (equivalent to x `div` 8 but faster)
194+byte_offset :: Int -> Int
195+byte_offset n = n `shiftR` 3
196+{-# INLINE byte_offset #-}
172-- | Increment the current bit offset
198-- | Increment the current bit offset
173incS :: Int -> S -> S
199incS :: Int -> S -> S
174−incS o (S bs n bo) = S (unsafeDrop d bs) n' bo
200+incS o (S bs n) = S (unsafeDrop d bs) n'
176 !o' = (n+o)
202 !o' = (n+o)
177 !d = byte_offset o'
203 !d = byte_offset o'
178 !n' = bit_offset o'
204 !n' = bit_offset o'
180−-- | Read a single bit
206+-- | make_mask 3 = 00000111
181−readBool :: S -> Bool
207+make_mask :: (Bits a, Num a) => Int -> a
182−readBool (S bs o bo) = case bo of
208+make_mask n = (1 `shiftL` fromIntegral n) - 1
183− BB -> testBit (unsafeHead bs) (7-o)
209+{-# SPECIALIZE make_mask :: Int -> Int #-}
184− BL -> testBit (unsafeHead bs) (7-o)
210+{-# SPECIALIZE make_mask :: Int -> Word #-}
185− LL -> testBit (unsafeHead bs) o
211+{-# SPECIALIZE make_mask :: Int -> Word8 #-}
186− LB -> testBit (unsafeHead bs) o
212+{-# SPECIALIZE make_mask :: Int -> Word16 #-}
213+{-# SPECIALIZE make_mask :: Int -> Word32 #-}
214+{-# SPECIALIZE make_mask :: Int -> Word64 #-}
216+-- | Keep only the n least-significant bits of the given value
217+mask :: (Bits a, Num a) => Int -> a -> a
218+mask n v = v .&. make_mask n
221+class FastBits a where
222+ fastShiftR :: a -> Int -> a
223+ fastShiftL :: a -> Int -> a
225+ {-# INLINE fastShift #-}
226+ fastShift :: a -> Int -> a
228+ | n > 0 = fastShiftL x n
229+ | n < 0 = fastShiftR x (negate n)
232+instance FastBits Word8 where
233+ fastShiftR = shiftr_w8
234+ fastShiftL = shiftl_w8
236+instance FastBits Word16 where
237+ fastShiftR = shiftr_w16
238+ fastShiftL = shiftl_w16
240+instance FastBits Word32 where
241+ fastShiftR = shiftr_w32
242+ fastShiftL = shiftl_w32
244+instance FastBits Word64 where
245+ fastShiftR = shiftr_w64
246+ fastShiftL = shiftl_w64
250+-- E.g. two words of 5 bits: ABCDE, VWXYZ
251+-- - BB: ABCDEVWX YZxxxxxx
252+-- - LB: XYZABCDE xxxxxxVW
253+-- - BL: EDCBAZYX WVxxxxxx -- not implemented
254+-- - LL: XWVEDCBA xxxxxxZY -- not implemented
255+data BitOrder = BB | LB
188−-- | Read a single bit
189−readBool# :: S -> Int
190−readBool# (S bs (I# o) bo) = case bo of
191− BB -> testBit# (7# -# o)
192− BL -> testBit# (7# -# o)
196− !(W8# w) = unsafeHead bs
197− testBit# n = I# (((w `andWord8#` (wordToWord8# 1## `uncheckedShiftLWord8#` n)) `eqWord8#` wordToWord8# 0##) `xorI#` 1#)
258+-- | Read a single bit
259+readBool :: BitOrder -> S -> Bool
260+readBool BB (S bs n) = testBit (unsafeHead bs) (7-n)
261+readBool LB (S bs n) = testBit (unsafeHead bs) n
200-- | Extract a range of bits from (ws :: ByteString)
263-- | Extract a range of bits from (ws :: ByteString)
202-- Constraint: 8 * (length ws -1 ) < o+n <= 8 * length ws
265-- Constraint: 8 * (length ws -1 ) < o+n <= 8 * length ws
203−extract :: (Num a, FastBits a) => BitOrder -> ByteString -> Int -> Int -> a
266+extract :: (Num a, Bits a, FastBits a) => BitOrder -> ByteString -> Int -> Int -> a
204extract bo bs o n
267extract bo bs o n
205 | n == 0 = 0
268 | n == 0 = 0
206 | B.length bs == 0 = error "Empty ByteString"
269 | B.length bs == 0 = error "Empty ByteString"
207− | otherwise = rev . mask n . foldlWithIndex' f 0 $ bs
270+ | otherwise = mask n (foldlWithIndex' f 0 bs)
209− -- B.foldl' with index
272+ -- foldl' with index
210− foldlWithIndex' op b = fst . B.foldl' g (b,0)
273+ foldlWithIndex' f b = fst . B.foldl' g (b,0)
211− where g (b',i) w = (op b' w i, (i+1))
274+ where g (b,i) w = (f b w i, (i+1))
213 -- 'or' correctly shifted words
276 -- 'or' correctly shifted words
214− f b w i = b .|. (fromIntegral w `fastShift` off i)
277+ f b w i = b .|. (fromIntegral w `fastShift` off i)
216 -- co-offset
279 -- co-offset
217− r = B.length bs * 8 - (o + n)
280+ r = B.length bs * 8 - (o + n)
219 -- shift offset depending on the byte position (0..B.length-1)
282 -- shift offset depending on the byte position (0..B.length-1)
220− off i = case bo of
283+ off i = case bo of
222 LB -> 8*i - o
284 LB -> 8*i - o
223 BB -> (B.length bs -1 - i) * 8 - r
285 BB -> (B.length bs -1 - i) * 8 - r
224− BL -> (B.length bs -1 - i) * 8 - r
226− -- reverse bits if necessary
234-- | Generic readWord
288-- | Generic readWord
235−readWord :: (Num a, FastBits a) => Int -> S -> a
289+readWord :: (Num a, Bits a, FastBits a) => BitOrder -> Int -> S -> a
236−readWord n (S bs o bo)
290+readWord bo n (S bs o)
237 | n == 0 = 0
291 | n == 0 = 0
292+ | o+n <= 8 = extract bo (unsafeTake 1 bs) o n
293+ | o+n <= 16 = extract bo (unsafeTake 2 bs) o n
294+ | o+n <= 24 = extract bo (unsafeTake 3 bs) o n
295+ | o+n <= 32 = extract bo (unsafeTake 4 bs) o n
296+ | o+n <= 40 = extract bo (unsafeTake 5 bs) o n
297+ | o+n <= 48 = extract bo (unsafeTake 6 bs) o n
298+ | o+n <= 56 = extract bo (unsafeTake 7 bs) o n
299+ | o+n <= 64 = extract bo (unsafeTake 8 bs) o n
238− | otherwise = extract bo (unsafeTake nbytes bs) o n
300+ | otherwise = extract bo (unsafeTake ((o+n+7) `div` 8) bs) o n
239− where nbytes = byte_offset (o+n+7)
301+
241−-- | Check that the number of bits to read is not greater than the first parameter
242−{-# INLINE readWordChecked #-}
243−readWordChecked :: (Num a, FastBits a) => Int -> Int -> S -> a
302+readWordChecked :: (Num a, Bits a, FastBits a) => Int -> BitOrder -> Int -> S -> a
244−readWordChecked m n s
303+readWordChecked m bo n s
245 | n > m = error $ "Tried to read more than " ++ show m ++ " bits (" ++ show n ++")"
304 | n > m = error $ "Tried to read more than " ++ show m ++ " bits (" ++ show n ++")"
246− | otherwise = readWord n s
305+ | otherwise = readWord bo n s
248−-- | Read the given number of bytes and return them in Big-Endian order
307+{-# INLINE readWord8 #-}
249−--
308+readWord8 :: BitOrder -> Int -> S -> Word8
250−-- Examples:
309+readWord8 = readWordChecked 8
251−-- BB: xxxABCDE FGHIJKLM NOPxxxxx -> ABCDEFGH IJKLMNOP
310+
252−-- LL: LMNOPxxx DEFGHIJK xxxxxABC -> ABCDEFGH IJKLMNOP
311+{-# INLINE readWord16 #-}
253−-- BL: xxxPONML KJIHGFED CBAxxxxx -> ABCDEFGH IJKLMNOP
312+readWord16 :: BitOrder -> Int -> S -> Word16
254−-- LB: EDCBAxxx MLKJIHGF xxxxxPON -> ABCDEFGH IJKLMNOP
313+readWord16 = readWordChecked 16
255−readByteString :: Int -> S -> ByteString
314+
256−readByteString n (S bs o bo) =
315+{-# INLINE readWord32 #-}
257− let
316+readWord32 :: BitOrder -> Int -> S -> Word32
258− bs' = unsafeTake (n+1) bs
317+readWord32 = readWordChecked 32
259− bs'' = unsafeTake n bs
260− rev = B.map (reverseBits 8)
263− (0,LL) -> B.reverse bs''
265− (0,BL) -> rev . B.reverse $ bs''
266− (_,LL) -> readByteString n (S (B.reverse bs') (8-o) BB)
267− (_,BL) -> rev . B.reverse $ readByteString n (S bs' o BB)
268− (_,LB) -> rev . B.reverse $ readByteString n (S bs' o LL)
269− (_,BB) -> unsafePerformIO $ do
271− ptr <- mallocBytes len
274− w = unsafeIndex bs (len-i)
275− w' = (w `fastShiftL` o) .|. r
276− r' = w `fastShiftR` (8-o)
277− poke (ptr `plusPtr` (len-i)) w'
280− unsafeInit <$> unsafePackMallocCStringLen (ptr,len)
319+{-# INLINE readWord64 #-}
320+readWord64 :: BitOrder -> Int -> S -> Word64
321+readWord64 = readWordChecked 64
323+-- | Read the given number of bytes and return them in Big-Endian order
324+readByteString :: BitOrder -> Int -> S -> ByteString
325+readByteString bo n (S bs o)
326+ | o == 0 = unsafeTake n bs
327+ | otherwise = unsafePerformIO $ do
329+ ptr <- mallocBytes len
334+ w = unsafeIndex bs (len-i)
335+ w' = (w `fastShiftL` o) .|. r
336+ r' = w `fastShiftR` (8-o)
337+ poke (ptr `plusPtr` (len-i)) w'
340+ unsafeInit <$> unsafePackMallocCStringLen (ptr,len)
345+ w = unsafeIndex bs (i-1)
346+ w' = (w `fastShiftL` (8-o)) .|. r
347+ r' = w `fastShiftR` o
348+ poke (ptr `plusPtr` (len-i)) w'
351+ unsafeTail <$> unsafePackMallocCStringLen (ptr,len)
283------------------------------------------------------------------------
353------------------------------------------------------------------------
284-- | 'BitGet' is a monad, applicative and a functor. See 'runBitGet'
354-- | 'BitGet' is a monad, applicative and a functor. See 'runBitGet'
@@ -287,6 +357,7 @@ newtype BitGet a = B { runState :: S -> Get (S,a) }
288instance Monad BitGet where
358instance Monad BitGet where
289 return x = B $ \s -> return (s,x)
359 return x = B $ \s -> return (s,x)
360+ fail str = B $ \(S inp n) -> putBackState inp n >> fail str
290 (B f) >>= g = B $ \s -> do (s',a) <- f s
361 (B f) >>= g = B $ \s -> do (s',a) <- f s
291 runState (g a) s'
362 runState (g a) s'
@@ -297,51 +368,25 @@ instance Applicative BitGet where
297 pure x = return x
368 pure x = return x
298 fm <*> m = fm >>= \f -> m >>= \v -> return (f v)
369 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
371-- | 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.
372-- been partially consumed it will be discarded once 'runBitGet' is finished.
325runBitGet :: BitGet a -> Get a
373runBitGet :: BitGet a -> Get a
326runBitGet bg = do
374runBitGet bg = do
327 s <- mkInitState
375 s <- mkInitState
328− (s',a) <- runState bg s
376+ ((S str' n),a) <- runState bg s
329− putBackState s'
377+ putBackState str' n
332mkInitState :: Get S
380mkInitState :: Get S
333mkInitState = do
381mkInitState = do
334− bs <- get
382+ str <- get
335 put B.empty
383 put B.empty
336− return (S bs 0 BB)
384+ return (S str 0)
338−putBackState :: S -> Get ()
386+putBackState :: B.ByteString -> Int -> Get ()
339−putBackState (S bs o _) = do
387+putBackState bs n = do
340 remaining <- get
388 remaining <- get
343− _ -> unsafeDrop 1 bs
344− put (bs' `B.append` remaining)
389+ put (B.drop (if n==0 then 0 else 1) bs `B.append` remaining)
346getState :: BitGet S
391getState :: BitGet S
347getState = B $ \s -> return (s,s)
392getState = B $ \s -> return (s,s)
@@ -349,66 +394,52 @@ getState = B $ \s -> return (s,s)
349putState :: S -> BitGet ()
394putState :: S -> BitGet ()
350putState s = B $ \_ -> return (s,())
395putState s = B $ \_ -> return (s,())
352−withState :: (S -> S) -> BitGet ()
357-- | Make sure there are at least @n@ bits.
397-- | Make sure there are at least @n@ bits.
358ensureBits :: Int -> BitGet ()
398ensureBits :: Int -> BitGet ()
359ensureBits n = do
399ensureBits n = do
360− (S bs o bo) <- getState
400+ (S bs o) <- getState
361 if n <= (B.length bs * 8 - o)
401 if n <= (B.length bs * 8 - o)
362 then return ()
402 then return ()
363 else do let currentBits = B.length bs * 8 - o
403 else do let currentBits = B.length bs * 8 - o
364− let byteCount = byte_offset (n - currentBits + 7)
404+ let byteCount = (n - currentBits + 7) `div` 8
365 B $ \_ -> do B.ensureN byteCount
405 B $ \_ -> do B.ensureN byteCount
366 bs' <- B.get
406 bs' <- B.get
367 put B.empty
407 put B.empty
368− return (S (bs`append`bs') o bo, ())
408+ return (S (bs`append`bs') o, ())
370−-- | Test whether all input has been consumed, i.e. there are no remaining
410+-- | Skip the given number of bits
371−-- undecoded bytes.
411+skipBits :: Int -> BitGet ()
372−isEmpty :: BitGet Bool
412+skipBits n = do
373−isEmpty = B $ \ (S bs o bo) -> if B.null bs
413+ ensureBits n
374− then B.isEmpty >>= \e -> return (S bs o bo, e)
414+ s <- getState
375− else return (S bs o bo, False)
415+ putState $! (incS n s)
417+-- | Skip bits if necessary to align to the next byte
418+alignByte :: BitGet ()
377-- | Get 1 bit as a 'Bool'.
424-- | Get 1 bit as a 'Bool'.
378getBool :: BitGet Bool
425getBool :: BitGet Bool
379getBool = block bool
426getBool = 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]@.
428-- | Get @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
386getWord8 :: Int -> BitGet Word8
429getWord8 :: Int -> BitGet Word8
387getWord8 n = block (word8 n)
430getWord8 n = block (word8 n)
389-- | Get @n@ bits as a 'Word16'. @n@ must be within @[0..16]@.
432-- | 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
433getWord16be :: Int -> BitGet Word16
394−getWord16be = getWord16
434+getWord16be n = block (word16be n)
395−{-# DEPRECATED getWord16be "Use 'getWord16' instead" #-}
397-- | Get @n@ bits as a 'Word32'. @n@ must be within @[0..32]@.
436-- | 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
437getWord32be :: Int -> BitGet Word32
402−getWord32be = getWord32
438+getWord32be n = block (word32be n)
403−{-# DEPRECATED getWord32be "Use 'getWord32' instead" #-}
405-- | Get @n@ bits as a 'Word64'. @n@ must be within @[0..64]@.
440-- | 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
441getWord64be :: Int -> BitGet Word64
410−getWord64be = getWord64
442+getWord64be n = block (word64be n)
411−{-# DEPRECATED getWord64be "Use 'getWord64' instead" #-}
413-- | Get @n@ bytes as a 'ByteString'.
444-- | Get @n@ bytes as a 'ByteString'.
414getByteString :: Int -> BitGet ByteString
445getByteString :: Int -> BitGet ByteString
@@ -417,80 +448,94 @@ getByteString n = block (byteString n)
417-- | Get @n@ bytes as a lazy ByteString.
448-- | Get @n@ bytes as a lazy ByteString.
418getLazyByteString :: Int -> BitGet L.ByteString
449getLazyByteString :: Int -> BitGet L.ByteString
419getLazyByteString n = do
450getLazyByteString n = do
420− (S _ o bo) <- getState
451+ (S _ o) <- getState
421 case o of
452 case o of
422− 0 -> B $ \s -> do
453+ 0 -> B $ \ (S bs o') -> do
423− putBackState s
454+ putBackState bs o'
424 lbs <- B.getLazyByteString (fromIntegral n)
455 lbs <- B.getLazyByteString (fromIntegral n)
425− return (S B.empty 0 bo, lbs)
456+ return (S B.empty 0, lbs)
426 _ -> L.fromChunks . (:[]) <$> Data.Binary.Bits.Get.getByteString n
457 _ -> L.fromChunks . (:[]) <$> Data.Binary.Bits.Get.getByteString n
428−
459+-- | Test whether all input has been consumed, i.e. there are no remaining
429−
460+-- undecoded bytes.
430−
461+isEmpty :: BitGet Bool
431−
462+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
463+ 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
464+ else return (S bs o, False)
456-- | Read a 1 bit 'Bool'.
466-- | Read a 1 bit 'Bool'.
457bool :: Block Bool
467bool :: Block Bool
458−bool = Block 1 readBool
468+bool = Block 1 (readBool BB)
460−-- | Read a 1 bit 'Bool'.
462−bool# = Block 1 readBool#
464-- | Read @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
470-- | Read @n@ bits as a 'Word8'. @n@ must be within @[0..8]@.
465word8 :: Int -> Block Word8
471word8 :: Int -> Block Word8
466−word8 n = Block n (readWordChecked 8 n)
472+word8 n = Block n (readWord8 BB n)
468-- | Read @n@ bits as a 'Word16'. @n@ must be within @[0..16]@.
474-- | 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
475word16be :: Int -> Block Word16
473−word16be = word16
476+word16be n = Block n (readWord16 BB n)
474−{-# DEPRECATED word16be "Use 'word16' instead" #-}
476-- | Read @n@ bits as a 'Word32'. @n@ must be within @[0..32]@.
478-- | 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
479word32be :: Int -> Block Word32
481−word32be = word32
480+word32be n = Block n (readWord32 BB n)
482−{-# DEPRECATED word32be "Use 'word32' instead" #-}
484-- | Read @n@ bits as a 'Word64'. @n@ must be within @[0..64]@.
482-- | 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
483word64be :: Int -> Block Word64
489−word64be = word64
484+word64be n = Block n (readWord64 BB n)
490−{-# DEPRECATED word64be "Use 'word64' instead" #-}
492-- | Read @n@ bytes as a 'ByteString'.
486-- | Read @n@ bytes as a 'ByteString'.
493byteString :: Int -> Block ByteString
487byteString :: Int -> Block ByteString
494−byteString n | n > 0 = Block (n*8) (readByteString n)
488+byteString n | n > 0 = Block (n*8) (readByteString BB n)
495 | otherwise = Block 0 (\_ -> B.empty)
489 | otherwise = Block 0 (\_ -> B.empty)
491+------------------------------------------------------------------------
492+-- Unchecked shifts, from the package binary
494+shiftl_w8 :: Word8 -> Int -> Word8
495+shiftl_w16 :: Word16 -> Int -> Word16
496+shiftl_w32 :: Word32 -> Int -> Word32
497+shiftl_w64 :: Word64 -> Int -> Word64
499+shiftr_w8 :: Word8 -> Int -> Word8
500+shiftr_w16 :: Word16 -> Int -> Word16
501+shiftr_w32 :: Word32 -> Int -> Word32
502+shiftr_w64 :: Word64 -> Int -> Word64
504+#if defined(__GLASGOW_HASKELL__) && !defined(__HADDOCK__)
505+shiftl_w8 (W8# w) (I# i) = W8# (w `uncheckedShiftL#` i)
506+shiftl_w16 (W16# w) (I# i) = W16# (w `uncheckedShiftL#` i)
507+shiftl_w32 (W32# w) (I# i) = W32# (w `uncheckedShiftL#` i)
509+shiftr_w8 (W8# w) (I# i) = W8# (w `uncheckedShiftRL#` i)
510+shiftr_w16 (W16# w) (I# i) = W16# (w `uncheckedShiftRL#` i)
511+shiftr_w32 (W32# w) (I# i) = W32# (w `uncheckedShiftRL#` i)
514+#if WORD_SIZE_IN_BITS < 64
515+shiftl_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftL64#` i)
516+shiftr_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftRL64#` i)
518+#if __GLASGOW_HASKELL__ <= 606
519+-- Exported by GHC.Word in GHC 6.8 and higher
520+foreign import ccall unsafe "stg_uncheckedShiftL64"
521+ uncheckedShiftL64# :: Word64# -> Int# -> Word64#
522+foreign import ccall unsafe "stg_uncheckedShiftRL64"
523+ uncheckedShiftRL64# :: Word64# -> Int# -> Word64#
527+shiftl_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftL#` i)
528+shiftr_w64 (W64# w) (I# i) = W64# (w `uncheckedShiftRL#` i)