Mozo.Fwob 1.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Mozo.Fwob --version 1.0.0                
NuGet\Install-Package Mozo.Fwob -Version 1.0.0                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Mozo.Fwob" Version="1.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Mozo.Fwob --version 1.0.0                
#r "nuget: Mozo.Fwob, 1.0.0"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Mozo.Fwob as a Cake Addin
#addin nuget:?package=Mozo.Fwob&version=1.0.0

// Install Mozo.Fwob as a Cake Tool
#tool nuget:?package=Mozo.Fwob&version=1.0.0                

Fixed-Width Ordered Binary (FWOB) Format Library

NuGet version (Mozo.Fwob) Build workflow Release workflow

This repository contains the library implementation of the FWOB file format.


  • Enfores increasing order of data frames by key
  • Binary format storage
  • User-defined flat data structure
  • Supports all primitive field types including string
  • High-efficient (de)serializer (40% performance vs the best C++ implementation)
  • Built-in support for a string table
  • Supports on-disk file and in-memory storage

Build from source

# Restore any necessary imported packages
dotnet restore

# Build the entire solution
dotnet build --no-restore

# Run the test cases in the test directory
dotnet test --no-build --verbosity normal

# Publish a portable .dll for any supported system that have the .NET Runtime/SDK installed
dotnet publish -c Release --no-self-contained

# Pack the built manifests into a .nupkg package
dotnet pack -c Release

How to Use

Define your frame data structure

The data structure can be any class, structure or record that implements Mozo.Fwob.Models.IFrame<TKey>, where TKey is a struct type and implements IComparable<TKey>.

The data structure can have fields, methods, indexers, properties, custom parameterized constructors and non-public members. But only public fields and the Key property getter will be used and accessed by the FWOB library.

Since the frame must be fixed-width, a string type must define a fixed length. This can be achieved by using the Mozo.Fwob.LengthAttribute.

Here is an example,

public class StockTick : IFrame<uint>
    public uint Time;

    public uint Price;

    public double RealPrice
        get => Price / 10000.0;
        set => Price = (uint)Math.Round(value * 10000);

    public int Size;

    public string SpecCond;

    public uint Key => Time;

Only the four public fields Time, Price, Size and SpecCond will hold data in a FWOB file. The RealPrice and Key property won't hold any data, though the Key property will be used by the FWOB library to compare and order the frames in the file.

Create an on-disk FWOB file

var fwobFile = FwobFile<StockTick, uint>.CreateNewFile(path, "FileTitle");

Open an existing on-disk FWOB file

var fwobFile = new FwobFile<StockTick, uint>(path);

Create an in-memory FWOB file

var fwobFile = new InMemoryFwobFile<StockTick, uint>(title);

Read frames

// Get the first frame in the file
var firstFrame = fwobFile.FirstFrame;

// Get the last frame in the file
var lastFrame = fwobFile.LastFrame;

// Get the first frame of a given key in the file
var frame = fwobFile.GetFrame(key);

// Get an enumerator for iterating the frames of a given key in the file, in case the key is not unique
var frames = fwobFile.GetFrames(key);

// Get an enumerator for iterating the frames of a given key range [firstKey, lastKey) in the file
var frames = fwobFile.GetFrames(firstKey, lastKey);

// Get an enumerator for iterating the frames of a given lower bound (inclusive) in the file
var frames = fwobFile.GetFramesAfter(firstKey);

// Get an enumerator for iterating the frames of a given higher bound (inclusive) in the file
var frames = fwobFile.GetFramesBefore(lastKey);

Write frames

// Append frames to the end of the file, only the ascending prefixing frames will be taken
long appendedCount = fwobFile.AppendFrames(frames);

// Append frames to the end of the file while enforcing the ascending order by key and no data will be appended if the ordering rule is violated
long appendedCount = fwobFile.AppendFramesTx(frames);

Delete frames

// Deletes all frames whose key is greater than or equal to the given key
long deletedCount = fwobFile.DeleteFramesAfter(firstKey);

// Deletes all frames whose key is less than or equal to the given key
long deletedCount = fwobFile.DeleteFramesBefore(lastKey);

// Deletes all frames from the storage

String table

// Load and unload the string table into memory, not needed in the in-memory storage

// The string table is accessible via a list
var list = fwobFile.Strings;

// Get a specific string at a given index
var str = fwobFile.GetString(index);

// Get a specific index of a given string
int index = fwobFile.GetString(str);

// Append a string to the string table if not exist
int index = fwobFile.AppendString(str);

// Check if a string is in the string table
bool exist = fwobFile.ContainsString(str);

// Remove all strings from the string table
Product Compatible and additional computed target framework versions.
.NET net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net7.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.5.0 216 4/8/2023
1.4.3 164 4/8/2023
1.4.2 171 4/7/2023
1.4.1 188 4/1/2023
1.4.0 186 4/1/2023
1.3.0 222 3/8/2023
1.2.0 227 2/27/2023
1.1.0 240 2/26/2023
1.0.0 302 2/19/2023