xref: /aosp_15_r20/external/pigweed/pw_hdlc/ts/util.ts (revision 61c4878ac05f98d0ceed94b57d316916de578985)
1*61c4878aSAndroid Build Coastguard Worker// Copyright 2021 The Pigweed Authors
2*61c4878aSAndroid Build Coastguard Worker//
3*61c4878aSAndroid Build Coastguard Worker// Licensed under the Apache License, Version 2.0 (the "License"); you may not
4*61c4878aSAndroid Build Coastguard Worker// use this file except in compliance with the License. You may obtain a copy of
5*61c4878aSAndroid Build Coastguard Worker// the License at
6*61c4878aSAndroid Build Coastguard Worker//
7*61c4878aSAndroid Build Coastguard Worker//     https://www.apache.org/licenses/LICENSE-2.0
8*61c4878aSAndroid Build Coastguard Worker//
9*61c4878aSAndroid Build Coastguard Worker// Unless required by applicable law or agreed to in writing, software
10*61c4878aSAndroid Build Coastguard Worker// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11*61c4878aSAndroid Build Coastguard Worker// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12*61c4878aSAndroid Build Coastguard Worker// License for the specific language governing permissions and limitations under
13*61c4878aSAndroid Build Coastguard Worker// the License.
14*61c4878aSAndroid Build Coastguard Worker
15*61c4878aSAndroid Build Coastguard Worker/** Convenience methods for working with Uint8Array buffers */
16*61c4878aSAndroid Build Coastguard Worker
17*61c4878aSAndroid Build Coastguard Worker/**
18*61c4878aSAndroid Build Coastguard Worker * Returns a new array where all instances of target have been replaced by the
19*61c4878aSAndroid Build Coastguard Worker * provided substitue.
20*61c4878aSAndroid Build Coastguard Worker */
21*61c4878aSAndroid Build Coastguard Workerexport function replace(
22*61c4878aSAndroid Build Coastguard Worker  data: Uint8Array,
23*61c4878aSAndroid Build Coastguard Worker  target: number,
24*61c4878aSAndroid Build Coastguard Worker  substitute: number[],
25*61c4878aSAndroid Build Coastguard Worker): Uint8Array {
26*61c4878aSAndroid Build Coastguard Worker  const result: number[] = [];
27*61c4878aSAndroid Build Coastguard Worker  data.forEach((value) => {
28*61c4878aSAndroid Build Coastguard Worker    if (value === target) {
29*61c4878aSAndroid Build Coastguard Worker      result.push(...substitute);
30*61c4878aSAndroid Build Coastguard Worker    } else {
31*61c4878aSAndroid Build Coastguard Worker      result.push(value);
32*61c4878aSAndroid Build Coastguard Worker    }
33*61c4878aSAndroid Build Coastguard Worker  });
34*61c4878aSAndroid Build Coastguard Worker  return Uint8Array.from(result);
35*61c4878aSAndroid Build Coastguard Worker}
36*61c4878aSAndroid Build Coastguard Worker
37*61c4878aSAndroid Build Coastguard Worker/** Flattens the provided list of Uint8Arrays into a single array. */
38*61c4878aSAndroid Build Coastguard Workerexport function concatenate(...byteList: Uint8Array[]): Uint8Array {
39*61c4878aSAndroid Build Coastguard Worker  const length = byteList.reduce(
40*61c4878aSAndroid Build Coastguard Worker    (accumulator, bytes) => accumulator + bytes.length,
41*61c4878aSAndroid Build Coastguard Worker    0,
42*61c4878aSAndroid Build Coastguard Worker  );
43*61c4878aSAndroid Build Coastguard Worker  const result = new Uint8Array(length);
44*61c4878aSAndroid Build Coastguard Worker  let offset = 0;
45*61c4878aSAndroid Build Coastguard Worker  byteList.forEach((value) => {
46*61c4878aSAndroid Build Coastguard Worker    result.set(value, offset);
47*61c4878aSAndroid Build Coastguard Worker    offset += value.length;
48*61c4878aSAndroid Build Coastguard Worker  });
49*61c4878aSAndroid Build Coastguard Worker  return result;
50*61c4878aSAndroid Build Coastguard Worker}
51