Skip to content

Commit 4a5bc7f

Browse files
committed
update readme
1 parent 3dc66f1 commit 4a5bc7f

File tree

2 files changed

+24
-18
lines changed

2 files changed

+24
-18
lines changed

README.md

Lines changed: 23 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,28 @@ Convert between JS object and Node.js buffer with rigidly predetermined scheme.
99
```
1010

1111

12-
## Example & usage
12+
## Usage
13+
14+
`require("data-struct")` exports just 3 namespaces:
15+
16+
* `DataTypes` – dictonary of supported types:
17+
* **boolean** – 1 byte
18+
* **int8** – 1 byte
19+
* **uint8** – 1 byte
20+
* **int16** – 2 bytes
21+
* **uint16** – 2 bytes
22+
* **int32** – 4 bytes
23+
* **uint32** – 4 bytes
24+
* **float** – 4 bytes
25+
* **double** – 8 bytes
26+
* **string** – 2 bytes header + string bytes length (max length: 65535 bytes, **not string length!**)
27+
* **shortBuffer** – 2 bytes header + buffer length (max length: 65535 bytes)
28+
* **buffer** – 4 bytes header + buffer length (max length 4294967295 bytes)
29+
* `DataReader(buffer, scheme)` – buffer -> object function.
30+
* `DataWriter(object, scheme)` – object -> buffer function.
31+
32+
## Example
33+
1334

1435
```javascript
1536

@@ -74,20 +95,4 @@ var mapScheme = [[DataTypes.uint8]];
7495

7596
var mapBuf = DataWriter(map, mapScheme);
7697
var mapClone = DataReader(mapBuf, mapScheme);
77-
```
78-
79-
80-
## Data types
81-
82-
* **boolean** - 1 byte
83-
* **int8** - 1 byte
84-
* **uint8** - 1 byte
85-
* **int16** - 2 bytes
86-
* **uint16** - 2 bytes
87-
* **int32** - 4 bytes
88-
* **uint32** - 4 bytes
89-
* **float** - 4 bytes
90-
* **double** - 8 bytes
91-
* **string** - 2 bytes header + string bytes length (max length: 65535 bytes, **not string length!**)
92-
* **shortBuffer** - 2 bytes header + buffer length (max length: 65535 bytes)
93-
* **buffer** - 4 bytes header + buffer length (max length 4294967295 bytes)
98+
```

package.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@
1414
"node",
1515
"buffer",
1616
"object",
17+
"serialization",
1718
"convert"
1819
],
1920
"author": "rzcoder",

0 commit comments

Comments
 (0)