Skip to content

Commit bfff756

Browse files
committed
Update README and docs
1 parent c722e4a commit bfff756

File tree

4 files changed

+192
-100
lines changed

4 files changed

+192
-100
lines changed

README.md

Lines changed: 3 additions & 100 deletions
Original file line numberDiff line numberDiff line change
@@ -1,102 +1,5 @@
1-
# Module Documentation
1+
# purescript-node-buffer
22

3-
## Module Node.Buffer
3+
Type declarations and FFI wrappers for Node's Buffer class.
44

5-
### Types
6-
7-
data Buffer :: *
8-
9-
data BufferValueType where
10-
UInt8 :: BufferValueType
11-
UInt16LE :: BufferValueType
12-
UInt16BE :: BufferValueType
13-
UInt32LE :: BufferValueType
14-
UInt32BE :: BufferValueType
15-
Int8 :: BufferValueType
16-
Int16LE :: BufferValueType
17-
Int16BE :: BufferValueType
18-
Int32LE :: BufferValueType
19-
Int32BE :: BufferValueType
20-
FloatLE :: BufferValueType
21-
FloatBE :: BufferValueType
22-
DoubleLE :: BufferValueType
23-
DoubleBE :: BufferValueType
24-
25-
data BufferWrite :: !
26-
27-
type Octet = Number
28-
29-
type Offset = Number
30-
31-
32-
### Type Class Instances
33-
34-
instance showBuffer :: Show Buffer
35-
36-
instance showBufferValueType :: Show BufferValueType
37-
38-
39-
### Values
40-
41-
concat :: [Buffer] -> Buffer
42-
43-
concat' :: [Buffer] -> Number -> Buffer
44-
45-
copy :: Offset -> Offset -> Buffer -> Offset -> Buffer -> Buffer
46-
47-
create :: Number -> Buffer
48-
49-
fill :: forall e. Octet -> Offset -> Offset -> Buffer -> Eff (buffer :: BufferWrite | e) Unit
50-
51-
fromArray :: [Octet] -> Buffer
52-
53-
fromString :: String -> Encoding -> Buffer
54-
55-
getAtOffset :: Offset -> Buffer -> Maybe Octet
56-
57-
read :: BufferValueType -> Offset -> Buffer -> Number
58-
59-
readString :: forall e. Encoding -> Offset -> Offset -> Buffer -> String
60-
61-
setAtOffset :: forall e. Octet -> Offset -> Buffer -> Eff (buffer :: BufferWrite | e) Unit
62-
63-
size :: forall e. Buffer -> Number
64-
65-
toArray :: Buffer -> [Octet]
66-
67-
toString :: forall e. Encoding -> Buffer -> String
68-
69-
write :: forall e. BufferValueType -> Number -> Offset -> Buffer -> Eff (buffer :: BufferWrite | e) Unit
70-
71-
writeString :: forall e. Encoding -> Offset -> Number -> String -> Buffer -> Eff (buffer :: BufferWrite | e) Number
72-
73-
74-
## Module Node.Buffer.Unsafe
75-
76-
### Values
77-
78-
slice :: Offset -> Offset -> Buffer -> Buffer
79-
80-
81-
## Module Node.Encoding
82-
83-
### Types
84-
85-
data Encoding where
86-
ASCII :: Encoding
87-
UTF8 :: Encoding
88-
UTF16LE :: Encoding
89-
UCS2 :: Encoding
90-
Base64 :: Encoding
91-
Binary :: Encoding
92-
Hex :: Encoding
93-
94-
95-
### Type Class Instances
96-
97-
instance showEncoding :: Show Encoding
98-
99-
100-
### Values
101-
102-
byteLength :: String -> Encoding -> Number
5+
[Module documentation](docs/)

docs/Node/Buffer.md

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
## Module Node.Buffer
2+
3+
#### `Octet`
4+
5+
``` purescript
6+
type Octet = Number
7+
```
8+
9+
#### `Offset`
10+
11+
``` purescript
12+
type Offset = Number
13+
```
14+
15+
#### `Buffer`
16+
17+
``` purescript
18+
data Buffer :: *
19+
```
20+
21+
##### Instances
22+
``` purescript
23+
instance showBuffer :: Show Buffer
24+
```
25+
26+
#### `BufferWrite`
27+
28+
``` purescript
29+
data BufferWrite :: !
30+
```
31+
32+
#### `BufferValueType`
33+
34+
``` purescript
35+
data BufferValueType
36+
= UInt8
37+
| UInt16LE
38+
| UInt16BE
39+
| UInt32LE
40+
| UInt32BE
41+
| Int8
42+
| Int16LE
43+
| Int16BE
44+
| Int32LE
45+
| Int32BE
46+
| FloatLE
47+
| FloatBE
48+
| DoubleLE
49+
| DoubleBE
50+
```
51+
52+
##### Instances
53+
``` purescript
54+
instance showBufferValueType :: Show BufferValueType
55+
```
56+
57+
#### `create`
58+
59+
``` purescript
60+
create :: Int -> Buffer
61+
```
62+
63+
#### `fromArray`
64+
65+
``` purescript
66+
fromArray :: Array Octet -> Buffer
67+
```
68+
69+
#### `fromString`
70+
71+
``` purescript
72+
fromString :: String -> Encoding -> Buffer
73+
```
74+
75+
#### `read`
76+
77+
``` purescript
78+
read :: BufferValueType -> Offset -> Buffer -> Number
79+
```
80+
81+
#### `readString`
82+
83+
``` purescript
84+
readString :: forall e. Encoding -> Offset -> Offset -> Buffer -> String
85+
```
86+
87+
#### `toString`
88+
89+
``` purescript
90+
toString :: forall e. Encoding -> Buffer -> String
91+
```
92+
93+
#### `write`
94+
95+
``` purescript
96+
write :: forall e. BufferValueType -> Number -> Offset -> Buffer -> Eff (buffer :: BufferWrite | e) Unit
97+
```
98+
99+
#### `writeString`
100+
101+
``` purescript
102+
writeString :: forall e. Encoding -> Offset -> Number -> String -> Buffer -> Eff (buffer :: BufferWrite | e) Number
103+
```
104+
105+
#### `toArray`
106+
107+
``` purescript
108+
toArray :: Buffer -> Array Octet
109+
```
110+
111+
#### `getAtOffset`
112+
113+
``` purescript
114+
getAtOffset :: Offset -> Buffer -> Maybe Octet
115+
```
116+
117+
#### `setAtOffset`
118+
119+
``` purescript
120+
setAtOffset :: forall e. Octet -> Offset -> Buffer -> Eff (buffer :: BufferWrite | e) Unit
121+
```
122+
123+
#### `size`
124+
125+
``` purescript
126+
size :: Buffer -> Number
127+
```
128+
129+
#### `concat`
130+
131+
``` purescript
132+
concat :: Array Buffer -> Buffer
133+
```
134+
135+
#### `concat'`
136+
137+
``` purescript
138+
concat' :: Array Buffer -> Number -> Buffer
139+
```
140+
141+
#### `copy`
142+
143+
``` purescript
144+
copy :: Offset -> Offset -> Buffer -> Offset -> Buffer -> Buffer
145+
```
146+
147+
#### `fill`
148+
149+
``` purescript
150+
fill :: forall e. Octet -> Offset -> Offset -> Buffer -> Eff (buffer :: BufferWrite | e) Unit
151+
```
152+
153+

docs/Node/Buffer/Unsafe.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
## Module Node.Buffer.Unsafe
2+
3+
#### `slice`
4+
5+
``` purescript
6+
slice :: Offset -> Offset -> Buffer -> Buffer
7+
```
8+
9+

docs/Node/Encoding.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
## Module Node.Encoding
2+
3+
#### `Encoding`
4+
5+
``` purescript
6+
data Encoding
7+
= ASCII
8+
| UTF8
9+
| UTF16LE
10+
| UCS2
11+
| Base64
12+
| Binary
13+
| Hex
14+
```
15+
16+
##### Instances
17+
``` purescript
18+
instance showEncoding :: Show Encoding
19+
```
20+
21+
#### `byteLength`
22+
23+
``` purescript
24+
byteLength :: String -> Encoding -> Number
25+
```
26+
27+

0 commit comments

Comments
 (0)