39 lines
1.1 KiB
TypeScript
39 lines
1.1 KiB
TypeScript
// Copyright 2017-2021 @polkadot/util authors & contributors
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
/**
|
|
* @name u8aFixLength
|
|
* @summary Shifts a Uint8Array to a specific bitLength
|
|
* @description
|
|
* Returns a uint8Array with the specified number of bits contained in the return value. (If bitLength is -1, length checking is not done). Values with more bits are trimmed to the specified length.
|
|
* @example
|
|
* <BR>
|
|
*
|
|
* ```javascript
|
|
* import { u8aFixLength } from '@polkadot/util';
|
|
*
|
|
* u8aFixLength('0x12') // => 0x12
|
|
* u8aFixLength('0x12', 16) // => 0x0012
|
|
* u8aFixLength('0x1234', 8) // => 0x12
|
|
* ```
|
|
*/
|
|
export function u8aFixLength (value: Uint8Array, bitLength = -1, atStart = false): Uint8Array {
|
|
const byteLength = Math.ceil(bitLength / 8);
|
|
|
|
if (bitLength === -1 || value.length === byteLength) {
|
|
return value;
|
|
} else if (value.length > byteLength) {
|
|
return value.subarray(0, byteLength);
|
|
}
|
|
|
|
const result = new Uint8Array(byteLength);
|
|
|
|
if (atStart) {
|
|
result.set(value, 0);
|
|
} else {
|
|
result.set(value, byteLength - value.length);
|
|
}
|
|
|
|
return result;
|
|
}
|