Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
bit-sequence
Advanced tools
Readme
Turn an arbitrary sequence of bits from a byte array and turn it into an integer
Given an Array
-like containing bytes (unsigned 8-bit integers), extract an arbitrary sequence of the underlying bits and convert them into an unsigned integer value.
Useful for cases where a sub-sequence of bits within a longer byte sequence is used to form an index, such as in a hash array mapped trie where an index at each level of the tree structure is formed by incremental chunks of a key's hash.
const bitSequence = require('bit-sequence')
const assert = require('assert')
const bytes = new Uint8Array([ 0b00010101, 0b10101000, 0b00000000, 0b00000000 ])
// extract bits from here ^ to here ^
const int = bitSequence(bytes, 7, 11)
assert.strictEqual(int, 0b11010100000) // or `1696`
bitSequence(bytes, start, length)
bytes
is an Array
-like containing bytes. It's assumed that it can be accessed with an array indexing operator and that it will return 8-bit integers (< 255
). A Uint8Array
or Node.js Buffer
fits into this category, as does a standard Array
, however the 8-bit assumption is not enforced so an Array
full of larger integers will yield undefined results.start
is an integer bit index to start extraction (not a byte index).length
is the number of bits to extract from the bytes
array.Returns an unsigned integer version of the bit sequence. The most significant bit is not interpreted for a two's compliment representation. You should only get positive numbers >= 0
.
As per the example above, the assumption is that we are extracting bytes where the least significant bit is to the right, so we extract in the same order as presented by binary literals.
JavaScript's crazy numbers allows us to extract potentially very large bit sequences, but the usual caveats apply at 32-bits and beyond Number.MAX_SAFE_INTEGER
.
github.com/rvagg/bit-sequence/go
Exports BitSequence(bytes []byte, bitStart uint32, bitLength uint32) (uint32, error)
where:
bytes
is a simple byte array of arbitrary lengthbitStart
is a bit index to start extraction (not a byte index).bitLength
is the number of bits to extract from the bytes
array. This value can only be a maximum of 32
, higher values will be adjusted down.Returns an unsigned integer version of the bit sequence. The most significant bit is not interpreted for a two's compliment representation.
Returns an error if bitLength
exceeds 32 or the requested sequence overflows the bytes boundary.
Copyright 2019 Rod Vagg
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
FAQs
Turn an arbitrary sequence of bits from a byte array and turn it into an integer
The npm package bit-sequence receives a total of 41 weekly downloads. As such, bit-sequence popularity was classified as not popular.
We found that bit-sequence demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.