PtrPoker.Write

Documentation

writeToByteString :: Write -> ByteString

Execute Write, producing strict ByteString.

data Write

Specification of how many bytes to allocate and how to populate them.

Useful for creating strict bytestrings and tasks like that.

Constructors

Write

Fields

• writeSize :: Int
• writePoke :: Poke

Instances

IsString Write

Reuses the IsString instance of ByteString.

Defined in PtrPoker.Write

Methods

fromString :: String -> Write

Semigroup Write

Defined in PtrPoker.Write

Methods

(<>) :: Write -> Write -> Write

sconcat :: NonEmpty Write -> Write

stimes :: Integral b => b -> Write -> Write

Monoid Write

Defined in PtrPoker.Write

Methods

mempty :: Write

mappend :: Write -> Write -> Write

mconcat :: [Write] -> Write

word8 :: Word8 -> Write

Render Word8 as byte.

word64AsciiDec :: Word64 -> Write

Render Word64 in ASCII decimal.

wordAsciiDec :: Word -> Write

Render Word in ASCII decimal.

int64AsciiDec :: Int64 -> Write

Render Int64 in ASCII decimal.

intAsciiDec :: Int -> Write

Render Int in ASCII decimal.

doubleAsciiDec :: Double -> Write

Render double interpreting non-real values, such as NaN, Infinity, -Infinity, as is.

zeroNonRealDoubleAsciiDec :: Double -> Write

Render double interpreting non real values, such as NaN, Infinity, -Infinity, as zero.

scientificAsciiDec :: Scientific -> Write

Render Scientific in ASCII decimal.

byteString :: ByteString -> Write

Efficiently copy the contents of ByteString using memcpy.

textUtf8 :: Text -> Write

Render Text in UTF8.

Does pretty much the same as encodeUtf8, both implementation and performance-wise, while allowing you to avoid redundant memcpy compared to (byteString . encodeUtf8).

Following are the benchmark results comparing the performance of (writeToByteString . textUtf8) with Data.Text.Encoding.encodeUtf8 on inputs in Latin and Greek (requiring different number of surrogate bytes). The results show that they are quite similar.

Benchmark results

textUtf8/ptr-poker/latin/1               mean 57.06 ns  ( +- 3.283 ns  )
textUtf8/ptr-poker/latin/10              mean 214.1 ns  ( +- 8.601 ns  )
textUtf8/ptr-poker/latin/100             mean 1.536 μs  ( +- 75.03 ns  )
textUtf8/ptr-poker/greek/1               mean 85.98 ns  ( +- 5.038 ns  )
textUtf8/ptr-poker/greek/10              mean 482.1 ns  ( +- 12.38 ns  )
textUtf8/ptr-poker/greek/100             mean 4.398 μs  ( +- 33.94 ns  )
textUtf8/text/latin/1                    mean 60.28 ns  ( +- 3.517 ns  )
textUtf8/text/latin/10                   mean 201.6 ns  ( +- 8.118 ns  )
textUtf8/text/latin/100                  mean 1.323 μs  ( +- 51.25 ns  )
textUtf8/text/greek/1                    mean 99.14 ns  ( +- 1.264 ns  )
textUtf8/text/greek/10                   mean 483.4 ns  ( +- 5.844 ns  )
textUtf8/text/greek/100                  mean 4.238 μs  ( +- 40.55 ns  )