packages feed

ptr-0.16.8.8: library/Ptr/Read.hs

module Ptr.Read
  ( Read,
    Status (..),
    runOnPtr,
    runOnByteString,
    runOnByteStringFinishing,
    skip,
    skipWhile,
    byteString,
    byteStringWhile,
    foldlWhile',
    word8,
    int16InBe,
    int32InBe,
    int64InBe,
    nullTerminatedByteString,
    asciiIntegral,
  )
where

import qualified Data.ByteString.Internal as ByteString
import qualified Ptr.IO as IO
import Ptr.Prelude hiding (Read)
import qualified Ptr.Util.ByteString as ByteString
import qualified Ptr.Util.Word8Predicates as Word8Predicates
import qualified StrictList

-- |
-- Deserializer highly optimized for reading from pointers.
--
-- Parsing ByteString is just a special case.
newtype Read a
  = Read (Ptr Word8 -> Ptr Word8 -> IO (Status a))

instance Functor Read where
  fmap f (Read cont) =
    Read (\start end -> fmap (fmap f) (cont start end))

instance Applicative Read where
  pure a =
    Read (\s e -> pure (FinishedStatus s a))
  Read lGetStatus <*> Read rGetStatus =
    Read $ \start end -> do
      lGetStatus start end >>= \case
        FinishedStatus lAfter lRes ->
          rGetStatus lAfter end & fmap (fmap lRes)
        UnfinishedStatus lNextPeek ->
          return (UnfinishedStatus (lNextPeek <*> Read rGetStatus))

instance Monad Read where
  return = pure
  Read lGetStatus >>= k =
    Read $ \start end ->
      lGetStatus start end >>= \case
        FinishedStatus lAfter lRes ->
          k lRes & \(Read rGetStatus) -> rGetStatus lAfter end
        UnfinishedStatus lNextPeek ->
          return (UnfinishedStatus (lNextPeek >>= k))

-- |
-- Result of a single iteration.
--
-- Errors can be achieved by using Either for output.
data Status a
  = FinishedStatus {-# UNPACK #-} !(Ptr Word8) a
  | UnfinishedStatus (Read a)
  deriving (Functor)

-------------------------

runOnPtr :: Read a -> Ptr Word8 -> Ptr Word8 -> IO (Status a)
runOnPtr =
  coerce

runOnByteString :: Read a -> ByteString -> Either (Read a) (a, ByteString)
runOnByteString (Read read) (ByteString.PS bsFp bsOff bsSize) =
  unsafePerformIO
    $ withForeignPtr bsFp
    $ \p ->
      let startP = plusPtr p bsOff
          endP = plusPtr startP bsSize
       in read startP endP <&> \case
            FinishedStatus newStartP res ->
              let newBsOff = minusPtr newStartP p
                  newBs = ByteString.PS bsFp newBsOff (bsSize - (newBsOff - bsOff))
               in Right (res, newBs)
            UnfinishedStatus next ->
              Left next

runOnByteStringFinishing :: Read a -> ByteString -> Maybe a
runOnByteStringFinishing read byteString =
  runOnByteString read byteString
    & either (const Nothing) (Just . fst)

-------------------------

skip ::
  -- |
  --  Amount of bytes to skip.
  --
  --  __Warning:__ It is your responsibility to ensure that it is not negative.
  Int ->
  Read ()
skip =
  Read . loop
  where
    loop needed start end =
      if post <= end
        then return (FinishedStatus post ())
        else return (UnfinishedStatus (Read (loop nextNeeded)))
      where
        post = plusPtr start needed
        nextNeeded = minusPtr post end

skipWhile :: (Word8 -> Bool) -> Read ()
skipWhile predicate =
  Read loop
  where
    loop start end =
      if post <= end
        then do
          w <- IO.peekWord8 start
          if predicate w
            then loop post end
            else return (FinishedStatus start ())
        else return (UnfinishedStatus (Read loop))
      where
        post = plusPtr start 1

byteString ::
  -- |
  --  Size of the bytestring.
  --
  --  __Warning:__ It is your responsibility to ensure that it is not negative.
  Int ->
  Read ByteString
byteString totalNeededSize =
  Read (collectChunks totalNeededSize StrictList.Nil)
  where
    collectChunks neededSize chunks startPtr endPtr =
      let nextPtr = plusPtr startPtr neededSize
       in -- If there's enough
          if nextPtr <= endPtr
            then
              let lastChunkLength = minusPtr nextPtr startPtr
                  !chunk = ByteString.fromPtr lastChunkLength startPtr
                  merged = ByteString.fromReverseStrictListWithHead chunk (totalNeededSize - lastChunkLength) chunks
               in return (FinishedStatus nextPtr merged)
            else
              let lastChunkLength = minusPtr endPtr startPtr
                  !chunk = ByteString.fromPtr lastChunkLength startPtr
                  newNeededSize = neededSize - lastChunkLength
                  newChunks = StrictList.Cons chunk chunks
                  loop = collectChunks newNeededSize newChunks
               in return (UnfinishedStatus (Read loop))

byteStringWhile :: (Word8 -> Bool) -> Read ByteString
byteStringWhile predicate =
  Read (collectChunks 0 StrictList.Nil)
  where
    collectChunks totalLength chunks startPtr endPtr =
      populateChunk startPtr
      where
        populateChunk curPtr =
          if curPtr < endPtr
            then do
              w <- IO.peekWord8 curPtr
              if predicate w
                then populateChunk (plusPtr curPtr 1)
                else
                  let chunkLength =
                        minusPtr curPtr startPtr
                      !chunk =
                        ByteString.fromPtr chunkLength startPtr
                      merged =
                        ByteString.fromReverseStrictListWithHead chunk totalLength chunks
                   in return (FinishedStatus curPtr merged)
            else
              let chunkLength =
                    minusPtr endPtr startPtr
                  !chunk =
                    ByteString.fromPtr chunkLength startPtr
                  newTotalLength =
                    totalLength + chunkLength
                  newChunks =
                    StrictList.Cons chunk chunks
               in return (UnfinishedStatus (Read (collectChunks newTotalLength newChunks)))

foldlWhile' :: (Word8 -> Bool) -> (acc -> Word8 -> acc) -> acc -> Read acc
foldlWhile' predicate step =
  Read . loop
  where
    loop !acc start end =
      if post <= end
        then do
          w <- IO.peekWord8 start
          if predicate w
            then loop (step acc w) post end
            else return (FinishedStatus start acc)
        else return (UnfinishedStatus (Read (loop acc)))
      where
        post = plusPtr start 1

-------------------------

word8 :: Read Word8
word8 =
  Read $ \start end ->
    if end > start
      then IO.peekWord8 start <&> FinishedStatus (plusPtr start 1)
      else return (UnfinishedStatus word8)

int16InBe :: Read Int16
int16InBe =
  Read inWhole
  where
    inWhole start end =
      if inWholePost <= end
        then IO.peekBEInt16 start <&> FinishedStatus inWholePost
        else bytely 2 0 start end
      where
        inWholePost = plusPtr start 2
    bytely !needed !acc start end =
      if start < end
        then do
          w <- IO.peekWord8 start
          let newAcc = unsafeShiftL acc 8 .|. fromIntegral w
              newStart = plusPtr start 1
           in if needed > 1
                then bytely (pred needed) newAcc newStart end
                else return (FinishedStatus newStart newAcc)
        else return (UnfinishedStatus (Read (bytely needed acc)))

int32InBe :: Read Int32
int32InBe =
  Read inWhole
  where
    inWhole start end =
      if inWholePost <= end
        then IO.peekBEInt32 start <&> FinishedStatus inWholePost
        else bytely 4 0 start end
      where
        inWholePost = plusPtr start 4
    bytely !needed !acc start end =
      if start < end
        then do
          w <- IO.peekWord8 start
          let newAcc = unsafeShiftL acc 8 .|. fromIntegral w
              newStart = plusPtr start 1
           in if needed > 1
                then bytely (pred needed) newAcc newStart end
                else return (FinishedStatus newStart newAcc)
        else return (UnfinishedStatus (Read (bytely needed acc)))

int64InBe :: Read Int64
int64InBe =
  Read inWhole
  where
    inWhole start end =
      if inWholePost <= end
        then IO.peekBEInt64 start <&> FinishedStatus inWholePost
        else bytely 8 0 start end
      where
        inWholePost = plusPtr start 8
    bytely !needed !acc start end =
      if start < end
        then do
          w <- IO.peekWord8 start
          let newAcc = unsafeShiftL acc 8 .|. fromIntegral w
              newStart = plusPtr start 1
           in if needed > 1
                then bytely (pred needed) newAcc newStart end
                else return (FinishedStatus newStart newAcc)
        else return (UnfinishedStatus (Read (bytely needed acc)))

nullTerminatedByteString :: Read ByteString
nullTerminatedByteString =
  byteStringWhile (/= 0) <* skip 1

-- |
-- Integral number encoded in ASCII.
asciiIntegral :: (Integral a) => Read a
asciiIntegral =
  foldlWhile' Word8Predicates.asciiDigit step 0
  where
    step acc byte =
      acc * 10 + fromIntegral byte - 48