pattern_finder 1.0.1

pattern_finder is a compact library used for signature matching and/or wildcard pattern finder in byte streams.

pattern_finder

pattern_finder is a compact library written in Dart language that is primarily used for signature matching and/or wildcard pattern finder in byte streams.

Usage

A simple usage example:

import 'dart:typed_data';
import 'package:pattern_finder/pattern_finder.dart';

/// Converts array from List<int> to Uint8List
Uint8List toUint8List(List<int> buf) {
  Uint8List data = new Uint8List(buf.length);
  for (int i = 0; i < data.length; i++) {
    data[i] = buf[i];
  }
  return data;
} // end function toUint8List

main() {
  /* Search for patterns using PatternFinder.Find and PatternFinder.Find_B functions */
  var pattern = PatternFinder.Transform('456?89?B');

  var buf1 = [0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF];
  var buf2 = [0x01, 0x23, 0x45, 0x66, 0x89, 0x6B, 0xCD, 0xEF];
  var buf3 = [0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11, 0x11];

  int foundOffset1 =
      PatternFinder.Find_B(toUint8List(buf1), 8, pattern); // foundOffset1: 2
  int foundOffset2 =
      PatternFinder.Find(toUint8List(buf2), 8, '456?89?B'); // foundOffset2: 2
  int foundOffset3 =
      PatternFinder.Find_B(toUint8List(buf3), 8, pattern); // foundOffset3: -1

  /* Search for patterns using signatures */
  Signature sig1 = new Signature("pattern1", "456?89?B");
  Signature sig2 = new Signature("pattern2", "1111111111");
  Signature sig3 = new Signature("pattern3", "AB??EF");
  Signature sig4 = new Signature("pattern4", "45??67");
  List<Signature> signatures = [sig1, sig2, sig3, sig4];

  var buf = [
    0x01,
    0x23,
    0x45,
    0x67,
    0x89,
    0xAB,
    0xCD,
    0xEF,
    0x45,
    0x65,
    0x67,
    0x89
  ];

  List<Signature> results =
      SignatureFinder.Scan(toUint8List(buf), buf.length, signatures);

  for (int i = 0; i < results.length; i++) {
    print('Found: ${results[i]} at ${results[i].FoundOffset}');
    //    Found: pattern1 at 2
    //    Found: pattern3 at 5
    //    Found: pattern4 at 8
  }
}

License

Copyright (c) 2021 Mbadiwe Nnaemeka Ronald [e-mail]

This software is provided 'as-is', without any express or implied
warranty. In no event will the author be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation must be
specified.

2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.

3. This notice may not be removed or altered from any source distribution.

Tip Jar

• 💵 Bitcoin: 1Mcci95WffSJnV6PsYG7KD1af1gDfUvLe6