deno.land / std@0.224.0 / bytes / copy.ts

View Documentation
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
// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.// This module is browser compatible.
/** * Copy bytes from the source array to the destination array and returns the * number of bytes copied. * * If the source array is larger than what the `dst` array can hold, only the * amount of bytes that fit in the `dst` array are copied. * * @param src Source array to copy from. * @param dst Destination array to copy to. * @param offset Offset in the destination array to start copying to. Defaults * to 0. * @returns Number of bytes copied. * * @example Basic usage * ```ts * import { copy } from "https://deno.land/std@$STD_VERSION/bytes/copy.ts"; * * const src = new Uint8Array([9, 8, 7]); * const dst = new Uint8Array([0, 1, 2, 3, 4, 5]); * * copy(src, dst); // 3 * dst; // Uint8Array(6) [9, 8, 7, 3, 4, 5] * ``` * * @example Copy with offset * ```ts * import { copy } from "https://deno.land/std@$STD_VERSION/bytes/copy.ts"; * * const src = new Uint8Array([1, 1, 1, 1]); * const dst = new Uint8Array([0, 0, 0, 0]); * * copy(src, dst, 1); // 3 * dst; // Uint8Array(4) [0, 1, 1, 1] * ``` * Defining an offset will start copying at the specified index in the * destination array. */export function copy(src: Uint8Array, dst: Uint8Array, offset = 0): number { offset = Math.max(0, Math.min(offset, dst.byteLength)); const dstBytesAvailable = dst.byteLength - offset; if (src.byteLength > dstBytesAvailable) { src = src.subarray(0, dstBytesAvailable); } dst.set(src, offset); return src.byteLength;}
std

Version Info

Tagged at
6 months ago