Z-Data: Array, vector and text

[ bsd3, data, library ] [ Propose Tags ] [ Report a vulnerability ]

This package provides array, slice and text operations

[Skip to Readme]

Modules

[Index] [Quick Jump]

Z
- Data
- Z.Foreign

Flags

Manual Flags

Name	Description	Default
integer-simple	Use the simple integer library instead of integer-gmp	Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Z-Data-0.7.0.0.tar.gz [browse] (Cabal source package)
Package description (revised from the package)

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

winterland, lyndward

For package maintainers and hackage trustees

edit package information

Candidates

0.1.0.0, 0.1.6.0, 0.1.7.2, 0.2.0.0, 0.5.0.0, 0.8.3.0, 0.9.0.0

Versions [RSS]	0.1.0.0, 0.1.1.0, 0.1.2.0, 0.1.3.0, 0.1.3.1, 0.1.4.0, 0.1.4.1, 0.1.4.2, 0.1.5.0, 0.1.6.0, 0.1.6.1, 0.1.7.0, 0.1.7.1, 0.1.7.2, 0.1.8.0, 0.1.9.0, 0.1.9.1, 0.2.0.0, 0.3.0.0, 0.4.0.0, 0.5.0.0, 0.6.0.0, 0.6.1.0, 0.7.0.0, 0.7.1.0, 0.7.2.0, 0.7.3.0, 0.7.4.0, 0.8.0.0, 0.8.1.0, 0.8.2.0, 0.8.3.0, 0.8.4.0, 0.8.5.0, 0.8.6.0, 0.8.6.1, 0.8.7.0, 0.8.8.0, 0.9.0.0, 1.0.0.0, 1.0.0.1, 1.1.0.0, 1.2.0.0, 1.2.1.0, 1.3.0.0, 1.3.0.1, 2.0.0.0, 2.0.0.1, 2.0.0.2, 2.0.1.0 (info)
Change log	ChangeLog.md
Dependencies	base (>=4.12 && <5.0), bytestring (>=0.10.4 && <0.12), case-insensitive (>=1.2 && <1.3), containers (>=0.6 && <0.7), deepseq (>=1.4 && <1.5), ghc-prim (>=0.5.3 && <0.8), hashable (>=1.3 && <1.4), integer-gmp (>=0.2 && <1.2), primitive (>=0.7.1 && <0.7.2), QuickCheck (>=2.14), scientific (>=0.3 && <0.4), tagged (>=0.8 && <0.9), template-haskell (>=2.14.0), time (>=1.9 && <2.0), unordered-containers (>=0.2 && <0.3) [details]
License	BSD-3-Clause
Copyright	(c) Z.Haskell Contributors
Author	Z.Haskell Contributors
Maintainer	winterland1989@gmail.com
Revised	Revision 1 made by winterland at 2021-03-10T08:11:20Z
Category	Data
Home page	https://github.com/haskell-Z/z-data
Bug tracker	https://github.com/haskell-Z/z-data/issues
Source repo	head: git clone git://github.com/haskell-Z/z-data.git
Uploaded	by winterland at 2021-03-04T08:55:55Z
Distributions
Reverse Dependencies	5 direct, 0 indirect [details]
Downloads	16940 total (55 in the last 30 days)
Rating	2.5 (votes: 3) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs available [build log] Last success reported on 2021-03-04 [all 1 reports]

Readme for Z-Data-0.7.0.0

[back to package description]

Z-Data

This package is part of ZHaskell project, providing basic data structures and functions:

Array, vector(array slice), sorting, searching
Text based UTF-8, basic unicode manipulating, regex
FFI utilties
Fast parsing and building monad
JSON encoding and decoding

Requirements

A working haskell compiler system, GHC(>=8.6), cabal-install(>=2.4), hsc2hs.
Tests need hspec-discover.

Example usage

> import qualified Z.Data.Vector as V
> import qualified Z.Data.Array as A
>
> -- convert from list
> let v = V.pack [1..10] :: V.PrimVector Int  
> -- vector combinators works on arrays as well
> let a = V.pack [1..10] :: A.Array Int   
> -- slicing vector(slice) is O(1)
> V.take 3 v                              
[1,2,3]
-- slicing array is not O(1)
> V.drop 3 a                              
fromListN 7 [4,5,6,7,8,9,10]
>
> V.intersperse 10 v
[1,10,2,10,3,10,4,10,5,10,6,10,7,10,8,10,9,10,10]
>
> V.mergeSort (V.intersperse 10 v) 
[1,2,3,4,5,6,7,8,9,10,10,10,10,10,10,10,10,10,10]
> -- Generic KMP search on vectors
> V.indices (V.singleton 10) (V.intersperse 10 v) True   
[1,3,5,7,9,11,13,15,17,18]
>
> -- quoter for writing numeric vector literals
> :set -XQuasiQuotes 
> :t [V.vecWord|1,2,3,4,5,4,3,2,1|]                     
[V.vecWord|1,2,3,4,5,4,3,2,1|] :: V.PrimVector Word
>
> import qualified Z.Data.Builder as B
> import qualified Z.Data.Text as T
> :set -XOverloadedStrings 
>
> -- Builders can be used with OverloadedStrings
> B.buildBytes $ "builders: " >> B.hex (3 :: Word16) >> B.comma >> B.double 1.2345678
[98,117,105,108,100,101,114,115,58,32,48,48,48,51,44,49,46,50,51,52,53,54,55,56]
> 
> B.buildText $ "builders: " >> B.hex (3 :: Word16) >> B.comma >> B.double 1.2345678
"builders: 0003,1.2345678"
>
> import qualified Z.Data.JSON as JSON
> import GHC.Generics
> 
> JSON.parseValue "[1,2,3,4,5]"
([],Right (Array [Number 1.0,Number 2.0,Number 3.0,Number 4.0,Number 5.0]))
>
> -- JSON module support deriving through Generic
> :set -XDeriveAnyClass -XDeriveGeneric
> data Foo = Foo {foo :: Double} deriving (JSON.JSON, Generic)
> JSON.toValue (Foo 0.01)
Object [("foo",Number 1.0e-2)]
> JSON.encodeText (Foo 0.01)
"{\"foo\":1.0e-2}"

Dev guide

# get code
git clone --recursive git@github.com:ZHaskell/z-data.git 
cd z-data
# build
cabal build
# test
cabal test --test-show-details=direct
# install 
cabal install
# generate document
cabal haddock