1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
|
Name: bytestring
Version: 0.10.9.0
Synopsis: Fast, compact, strict and lazy byte strings with a list interface
Description:
An efficient compact, immutable byte string type (both strict and lazy)
suitable for binary or 8-bit character data.
.
The 'ByteString' type represents sequences of bytes or 8-bit characters.
It is suitable for high performance use, both in terms of large data
quantities, or high speed requirements. The 'ByteString' functions follow
the same style as Haskell\'s ordinary lists, so it is easy to convert code
from using 'String' to 'ByteString'.
.
Two 'ByteString' variants are provided:
.
* Strict 'ByteString's keep the string as a single large array. This
makes them convenient for passing data between C and Haskell.
.
* Lazy 'ByteString's use a lazy list of strict chunks which makes it
suitable for I\/O streaming tasks.
.
The @Char8@ modules provide a character-based view of the same
underlying 'ByteString' types. This makes it convenient to handle mixed
binary and 8-bit character content (which is common in many file formats
and network protocols).
.
The 'Builder' module provides an efficient way to build up 'ByteString's
in an ad-hoc way by repeated concatenation. This is ideal for fast
serialisation or pretty printing.
.
There is also a 'ShortByteString' type which has a lower memory overhead
and can can be converted to or from a 'ByteString', but supports very few
other operations. It is suitable for keeping many short strings in memory.
.
'ByteString's are not designed for Unicode. For Unicode strings you should
use the 'Text' type from the @text@ package.
.
These modules are intended to be imported qualified, to avoid name clashes
with "Prelude" functions, e.g.
.
> import qualified Data.ByteString as BS
License: BSD3
License-file: LICENSE
Category: Data
Copyright: Copyright (c) Don Stewart 2005-2009,
(c) Duncan Coutts 2006-2015,
(c) David Roundy 2003-2005,
(c) Jasper Van der Jeugt 2010,
(c) Simon Meier 2010-2013.
Author: Don Stewart,
Duncan Coutts
Maintainer: Duncan Coutts <duncan@community.haskell.org>
Homepage: https://github.com/haskell/bytestring
Bug-reports: https://github.com/haskell/bytestring/issues
Tested-With: GHC==7.10.1, GHC==7.8.4, GHC==7.6.3, GHC==7.4.2, GHC==6.12.3
Build-Type: Simple
Cabal-Version: >= 1.10
extra-source-files: README.md Changelog.md
source-repository head
type: git
location: https://github.com/haskell/bytestring
flag integer-simple
description: Use the simple integer library instead of GMP
default: False
library
build-depends: base >= 4.2 && < 5, ghc-prim, deepseq
exposed-modules: Data.ByteString
Data.ByteString.Char8
Data.ByteString.Unsafe
Data.ByteString.Internal
Data.ByteString.Lazy
Data.ByteString.Lazy.Char8
Data.ByteString.Lazy.Internal
Data.ByteString.Short
Data.ByteString.Short.Internal
Data.ByteString.Builder
Data.ByteString.Builder.Extra
Data.ByteString.Builder.Prim
-- perhaps only exposed temporarily
Data.ByteString.Builder.Internal
Data.ByteString.Builder.Prim.Internal
-- sigh, we decided to rename shortly after making
-- an initial release, so these are here for compat
Data.ByteString.Lazy.Builder
Data.ByteString.Lazy.Builder.Extras
Data.ByteString.Lazy.Builder.ASCII
other-modules:
Data.ByteString.Builder.ASCII
Data.ByteString.Builder.Prim.Binary
Data.ByteString.Builder.Prim.ASCII
Data.ByteString.Builder.Prim.Internal.Floating
Data.ByteString.Builder.Prim.Internal.UncheckedShifts
Data.ByteString.Builder.Prim.Internal.Base16
default-language: Haskell98
other-extensions: CPP,
ForeignFunctionInterface,
BangPatterns
UnliftedFFITypes,
MagicHash,
UnboxedTuples,
DeriveDataTypeable
ScopedTypeVariables
RankNTypes
NamedFieldPuns
-- if impl(ghc >= 7.2)
-- other-extensions: Trustworthy, Unsafe
-- older ghc had issues with language pragmas guarded by cpp
if impl(ghc < 7)
default-extensions: CPP, MagicHash, UnboxedTuples,
DeriveDataTypeable, BangPatterns,
NamedFieldPuns
ghc-options: -Wall -fwarn-tabs
-O2
-fmax-simplifier-iterations=10
-fdicts-cheap
-fspec-constr-count=6
c-sources: cbits/fpstring.c
cbits/itoa.c
include-dirs: include
includes: fpstring.h
install-includes: fpstring.h
-- flags for the decimal integer serialization code
if impl(ghc >= 6.11)
if !flag(integer-simple)
cpp-options: -DINTEGER_GMP
build-depends: integer-gmp >= 0.2
if impl(ghc >= 6.9) && impl(ghc < 6.11)
cpp-options: -DINTEGER_GMP
build-depends: integer >= 0.1 && < 0.2
-- QC properties, with GHC RULES disabled
test-suite prop-compiled
type: exitcode-stdio-1.0
main-is: Properties.hs
other-modules: Rules
QuickCheckUtils
TestFramework
hs-source-dirs: . tests
build-depends: base, ghc-prim, deepseq, random, directory,
test-framework, test-framework-quickcheck2,
QuickCheck >= 2.3 && < 2.10
c-sources: cbits/fpstring.c
include-dirs: include
ghc-options: -fwarn-unused-binds
-fno-enable-rewrite-rules
-threaded -rtsopts
cpp-options: -DHAVE_TEST_FRAMEWORK=1
default-language: Haskell98
-- older ghc had issues with language pragmas guarded by cpp
if impl(ghc < 7)
default-extensions: CPP, MagicHash, UnboxedTuples,
DeriveDataTypeable, BangPatterns,
NamedFieldPuns
test-suite regressions
-- temporarily disabled as it allocates too much memory
buildable: False
type: exitcode-stdio-1.0
main-is: Regressions.hs
hs-source-dirs: . tests
build-depends: base, ghc-prim, deepseq, random, directory,
test-framework, test-framework-hunit, HUnit
c-sources: cbits/fpstring.c
include-dirs: include
ghc-options: -fwarn-unused-binds
-fno-enable-rewrite-rules
-threaded -rtsopts
default-language: Haskell98
-- older ghc had issues with language pragmas guarded by cpp
if impl(ghc < 7)
default-extensions: CPP, MagicHash, UnboxedTuples,
DeriveDataTypeable, BangPatterns,
NamedFieldPuns
test-suite test-builder
type: exitcode-stdio-1.0
hs-source-dirs: . tests tests/builder
main-is: TestSuite.hs
other-modules: Data.ByteString.Builder.Tests
Data.ByteString.Builder.Prim.Tests
Data.ByteString.Builder.Prim.TestUtils
TestFramework
build-depends: base, ghc-prim,
deepseq,
QuickCheck >= 2.4 && < 2.10,
byteorder == 1.0.*,
dlist >= 0.5 && < 0.9,
directory,
mtl >= 2.0 && < 2.3,
HUnit,
test-framework,
test-framework-hunit,
test-framework-quickcheck2
ghc-options: -Wall -fwarn-tabs -threaded -rtsopts
cpp-options: -DHAVE_TEST_FRAMEWORK=1
default-language: Haskell98
-- older ghc had issues with language pragmas guarded by cpp
if impl(ghc < 7)
default-extensions: CPP, MagicHash, UnboxedTuples,
DeriveDataTypeable, BangPatterns,
NamedFieldPuns
c-sources: cbits/fpstring.c
cbits/itoa.c
include-dirs: include
includes: fpstring.h
install-includes: fpstring.h
|