57 lines
767 B
Markdown
57 lines
767 B
Markdown
# read-chunk [![Build Status](https://travis-ci.org/sindresorhus/read-chunk.svg?branch=master)](https://travis-ci.org/sindresorhus/read-chunk)
|
|
|
|
> Read a chunk from a file
|
|
|
|
Because the built-in way requires way too much boilerplate.
|
|
|
|
|
|
## Install
|
|
|
|
```
|
|
$ npm install read-chunk
|
|
```
|
|
|
|
|
|
## Usage
|
|
|
|
```js
|
|
const readChunk = require('read-chunk');
|
|
|
|
// foo.txt => hello
|
|
|
|
readChunk.sync('foo.txt', 1, 3);
|
|
//=> 'ell'
|
|
```
|
|
|
|
|
|
## API
|
|
|
|
### readChunk(filepath, position, length)
|
|
|
|
Returns a `Promise<Buffer>`.
|
|
|
|
### readChunk.sync(filepath, position, length)
|
|
|
|
Returns a `Buffer`.
|
|
|
|
#### filepath
|
|
|
|
Type: `string`
|
|
|
|
#### position
|
|
|
|
Type: `number`
|
|
|
|
Position to start reading.
|
|
|
|
#### length
|
|
|
|
Type: `number`
|
|
|
|
Number of bytes to read.
|
|
|
|
|
|
## License
|
|
|
|
MIT © [Sindre Sorhus](https://sindresorhus.com)
|