Latest 1.4.0
License MIT
Platforms ios 8.0, osx 10.10, tvos 9.0, watchos 2.0

Swift 4.2
GitHub license
Build Status

A Swift framework with classes for reading and writing bits and bytes.


BitByteData can be integrated into your project using Swift Package Manager, CocoaPods or Carthage.

Swift Package Manager

To install using SPM, add BitByteData to you package dependencies
and specify it as a dependency for your target, e.g.:

import PackageDescription

let package = Package(
    name: "PackageName",
    dependencies: [
        .package(url: "",
                 from: "1.4.0")
    targets: [
            name: "TargetName",
            dependencies: ["BitByteData"]

More details you can find in Swift Package Manager’s Documentation.


Add pod 'BitByteData', '~> 1.4' and use_frameworks! to your Podfile.

To complete installation, run pod install.


Add to your Cartfile github "tsolomko/BitByteData" ~> 1.4.

Then run carthage update.

Finally, drag and drop BitByteData.framework from Carthage/Build folder
into the "Embedded Binaries" section on your targets’ "General" tab in Xcode.


Use ByteReader class to read bytes.
For reading bits there are two classes: LsbBitReader and MsbBitReader, which implement BitReader protocol
for two bit-numbering schemes ("LSB 0" and "MSB 0" correspondingly).
Both LsbBitReader and MsbBitReader classes inherit from ByteReader so you can also use them to read bytes
(but they must be aligned, see documentation for more details).

Writing bits is implemented in two classes LsbBitWriter and MsbBitWriter (again, for two bit-numbering schemes).
They both conform to BitWriter protocol.

Note: All readers and writers aren’t structs, but classes intentionally.
This is done to make it easier to pass them as arguments to functions and to eliminate unnecessary copying and inouts.


Every function or type of BitByteData’s public API is documented.
This documentation can be found at its own website.


Whether you find a bug, have a suggestion, idea or something else,
please create an issue on GitHub.

If you’d like to contribute code, please create a pull request on GitHub.

Note: If you are considering working on BitByteData, please note that Xcode project (BitByteData.xcodeproj)
was created manually and you shouldn’t use swift package generate-xcodeproj command.

Performance and benchmarks

One of the most important goals of BitByteData’s development is high speed performance. To help achieve this goal there
are benchmarks for every function in the project as well as a handy command-line tool,, which helps to
run, show, and compare benchmarks and their results.

If you are considering contributing to the project please make sure that:

  1. Every new function has also a new benchmark added.
  2. Every other change to any existing function doesn’t introduce performance regressions, or, at the very least, these
    regressions are small and such performance tradeoff is necessary and justifiable.

Finally, please note that any meaningful comparison can be made only between benchmarks run on the same hardware and
software system.

Latest podspec

    "name": "BitByteData",
    "version": "1.4.0",
    "summary": "Read and write bits and bytes in Swift.",
    "description": "A Swift framework with classes for reading and writing bits and bytes.",
    "homepage": "",
    "documentation_url": "",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    "authors": {
        "Timofey Solomko": "[email protected]"
    "source": {
        "git": "",
        "tag": "1.4.0"
    "platforms": {
        "ios": "8.0",
        "osx": "10.10",
        "tvos": "9.0",
        "watchos": "2.0"
    "swift_version": "4.2",
    "source_files": "Sources/*.swift",
    "testspecs": [
            "name": "Tests",
            "test_type": "unit",
            "source_files": "Tests/BitByteDataTests/*.swift"

Pin It on Pinterest

Share This