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
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.// This module is browser compatible.
/** * An abstract interface which when implemented provides an interface to read bytes into an array buffer asynchronously. */export interface Reader {  /** Reads up to `p.byteLength` bytes into `p`. It resolves to the number of   * bytes read (`0` < `n` <= `p.byteLength`) and rejects if any error   * encountered. Even if `read()` resolves to `n` < `p.byteLength`, it may   * use all of `p` as scratch space during the call. If some data is   * available but not `p.byteLength` bytes, `read()` conventionally resolves   * to what is available instead of waiting for more.   *   * When `read()` encounters end-of-file condition, it resolves to EOF   * (`null`).   *   * When `read()` encounters an error, it rejects with an error.   *   * Callers should always process the `n` > `0` bytes returned before   * considering the EOF (`null`). Doing so correctly handles I/O errors that   * happen after reading some bytes and also both of the allowed EOF   * behaviors.   *   * Implementations should not retain a reference to `p`.   *   * Use   * {@linkcode https://deno.land/std@$STD_VERSION/io/to_iterator.ts?s=toIterator}   * to turn a {@linkcode Reader} into an {@linkcode AsyncIterableIterator}.   */  read(p: Uint8Array): Promise<number | null>;}
/** * An abstract interface which when implemented provides an interface to read bytes into an array buffer synchronously. */export interface ReaderSync {  /** Reads up to `p.byteLength` bytes into `p`. It resolves to the number   * of bytes read (`0` < `n` <= `p.byteLength`) and rejects if any error   * encountered. Even if `read()` returns `n` < `p.byteLength`, it may use   * all of `p` as scratch space during the call. If some data is available   * but not `p.byteLength` bytes, `read()` conventionally returns what is   * available instead of waiting for more.   *   * When `readSync()` encounters end-of-file condition, it returns EOF   * (`null`).   *   * When `readSync()` encounters an error, it throws with an error.   *   * Callers should always process the `n` > `0` bytes returned before   * considering the EOF (`null`). Doing so correctly handles I/O errors that happen   * after reading some bytes and also both of the allowed EOF behaviors.   *   * Implementations should not retain a reference to `p`.   *   * Use   * {@linkcode https://deno.land/std@$STD_VERSION/io/to_iterator.ts?s=toIteratorSync}   * to turn a {@linkcode ReaderSync} into an {@linkcode IterableIterator}.   */  readSync(p: Uint8Array): number | null;}
/** * An abstract interface which when implemented provides an interface to write bytes from an array buffer to a file/resource asynchronously. */export interface Writer {  /** Writes `p.byteLength` bytes from `p` to the underlying data stream. It   * resolves to the number of bytes written from `p` (`0` <= `n` <=   * `p.byteLength`) or reject with the error encountered that caused the   * write to stop early. `write()` must reject with a non-null error if   * would resolve to `n` < `p.byteLength`. `write()` must not modify the   * slice data, even temporarily.   *   * Implementations should not retain a reference to `p`.   */  write(p: Uint8Array): Promise<number>;}/** * An abstract interface which when implemented provides an interface to write bytes from an array buffer to a file/resource synchronously. */export interface WriterSync {  /** Writes `p.byteLength` bytes from `p` to the underlying data   * stream. It returns the number of bytes written from `p` (`0` <= `n`   * <= `p.byteLength`) and any error encountered that caused the write to   * stop early. `writeSync()` must throw a non-null error if it returns `n` <   * `p.byteLength`. `writeSync()` must not modify the slice data, even   * temporarily.   *   * Implementations should not retain a reference to `p`.   */  writeSync(p: Uint8Array): number;}
/** * An abstract interface which when implemented provides an interface to close files/resources that were previously opened. */export interface Closer {  /** Closes the resource, "freeing" the backing file/resource. */  close(): void;}