Selang Seling

Selang Seling is a Dart library for interleaving lists, providing flexible methods to combine elements from multiple lists based on customizable item counts.

Installation

Add the following to your pubspec.yaml file:

dependencies:
  selang_seling: any

Then, run:

dart pub get

Usage

Interleave Two Lists

import 'package:selang_seling/selang_seling.dart';

void main() {
  List<int> list1 = [1, 3, 5, 7, 9];
  List<int> list2 = [2, 4, 6];

  // Interleave two lists
  List<int> combinedList = SelangSeling.interleave(list1: list1, list2: list2, firstCount: 2, secondCount: 1);
  print('Interleave: $combinedList'); // Output: [1, 3, 2, 5, 7, 4, 9, 6]
}

Interleave Multiple Lists

import 'package:selang_seling/selang_seling.dart';

void main() {
  List<int> list3 = [1, 4, 7];
  List<int> list4 = [2, 5, 8];
  List<int> list5 = [3, 6, 9, 10, 11];

  List<List<int>> lists = [list3, list4, list5];
  List<int> itemCounts = [1, 2, 1]; // Number of items from each list

  // Interleave multiple lists
  List<int> combinedMultipleList = SelangSeling.interleaveMultiple(lists: lists, itemCounts: itemCounts);
  print('Interleave Multiple: $combinedMultipleList'); // Output: [1, 2, 5, 3, 4, 7, 6, 8, 9, 10, 11]
}

API

SelangSeling.interleave

Interleaves two lists based on specified item counts.

• Parameters:

  • list1: First list to be interleaved.
  • list2: Second list to be interleaved.
  • firstCount: Number of items to take from list1 in each iteration.
  • secondCount: Number of items to take from list2 in each iteration.

• Returns:

  • A list containing interleaved elements from list1 and list2.

SelangSeling.interleaveMultiple

Interleaves multiple lists based on specified item counts for each list.

• Parameters:

  • lists: List of lists to be interleaved.
  • itemCounts: List specifying the number of items to take from each list in each iteration.

• Returns:

  • A list containing interleaved elements from all lists according to the specified item counts.

Exceptions

• Throws ArgumentError if the length of itemCounts does not match the length of lists in interleaveMultiple.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---