node-taglib-sharp / Exports / IStream
Interface for a stream, it wraps around a file descriptor to make reading and writing to files using node IO a lot easier.
• Readonly canWrite: boolean
Whether or not the stream can be written to
• Readonly length: number
Number of bytes currently stored in file this stream connects to
• position: number
Position within the stream
▸ close(): void
Closes the stream
void
▸ read(buffer, offset, length): number
Reads a block of bytes from the current stream and writes the data to a buffer.
| Name | Type | Description |
|---|---|---|
buffer |
Uint8Array |
When this method returns, contains the specified byte array with the values between offset and (offset + length - 1) replaced by the characters read from the current stream |
offset |
number |
Zero-based byte offset in buffer at which to begin storing data from the current stream |
length |
number |
The maximum number of bytes to read |
number
Total number of bytes written to the buffer. This can be less than the number of bytes requested if that number of bytes are not currently available or zero if the end of the stream is reached before any bytes are read
▸ seek(offset, origin): void
Sets the position within the current stream to the specified value.
| Name | Type | Description |
|---|---|---|
offset |
number |
New position within the stream. this is relative to the origin parameter and can be positive or negative |
origin |
SeekOrigin |
Seek reference point SeekOrigin |
void
▸ setLength(length): void
Sets the length of the current current stream to the specified value.
| Name | Type | Description |
|---|---|---|
length |
number |
Number of bytes to set the length of the stream to |
void
▸ write(buffer, bufferOffset, length): number
Writes a block of bytes to the current stream using data read from a buffer.
| Name | Type | Description |
|---|---|---|
buffer |
ByteVector | Uint8Array |
Buffer to write data from |
bufferOffset |
number |
Zero-based byte offset in buffer at which to begin copying bytes to the current stream |
length |
number |
Maximum number of bytes to write |
number