https://github.com/electronic-mango/java-zipper
Zipping multiple lists in Java.
https://github.com/electronic-mango/java-zipper
Last synced: 2 months ago
JSON representation
Zipping multiple lists in Java.
- Host: GitHub
- URL: https://github.com/electronic-mango/java-zipper
- Owner: Electronic-Mango
- License: mit
- Created: 2022-12-06T14:02:06.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-06-13T09:40:46.000Z (almost 2 years ago)
- Last Synced: 2025-01-29T04:24:31.365Z (4 months ago)
- Language: Java
- Size: 64.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Java Zipper
[](https://search.maven.org/artifact/io.github.electronic-mango/zipper)
[](https://github.com/Electronic-Mango/java-zipper/actions/workflows/maven-verify.yml)
[](https://coveralls.io/github/Electronic-Mango/java-zipper?branch=main)
[](https://javadoc.io/doc/io.github.electronic-mango/zipper)
[](https://github.com/Electronic-Mango/java-zipper/blob/main/LICENSE)
This is a basic Java library providing Python-style "zip" functionality for lists.
## Installation
Library is available in [Maven Central](https://search.maven.org/artifact/io.github.electronic-mango/zipper), you can add this bit in `dependencies` section of `pom.xml`:
```xml
io.github.electronic-mango
zipper
1.4
```
## Zipping
"Zip" is an operation converting multiple lists into new lists such as:
```java
[[1, 2, 3], [4, 5, 6]] => [[1, 4], [2, 5], [3, 6]]
```
Resulting i-th list will have elements at i-th index in the source lists.
You can also think about it as selecting columns from provided rows.
If input lists aren't all the same length, then smallest possible subset is selected. For example:
```java
[[1, 2, 3, 4], [5, 6, 7], [8, 9]] => [[1, 5, 8], [2, 6, 9]]
```
Result only has two lists, as that's the size of the smallest input list. Above operation is equivalent to zipping: `[[1, 2], [5, 6], [8, 9]]`.
If one of input list is empty (or input is just an empty list), then result will also be an empty list.
## Usage
The library provides three static methods in `Zipper` class, all three used for zipping multiple lists together.
All three will work with lists of any types.
All three will also return new, mutable lists, not a view of the input.
### Zipping list of lists
One way of providing multiple lists for zipping is to provide a list of lists. For example:
```java
final var input = List.of(List.of(1, 2, 3), List.of(1, 2, 3)); // [[1, 2, 3], [1, 2, 3]]
final var output = Zipper.zip(input); // [[1, 1], [2, 2], [3, 3]]
```
### Zipping using varargs
You can also provide multiple lists as multiple arguments to `zip` method as varargs:
```java
final var output1 = Zipper.zip(List.of("A", "B"), List.of("C", "D"), List.of("E", "F"));
// output1 is [["A", "C", "E"], ["B", "D", "F"]]
final var list1 = List.of('1', '2', '3');
final var list2 = List.of('3', '2', '1');
final var output2 = Zipper.zip(list1, list2);
// output2 is [['1', '3'], ['2', '2'], ['3', '1']]
```
### Zipping using Stream API collector
`Zipper` class also provides method returning Stream API collector.
This collector can be used to collect lists as stream elements:
```java
final output = Stream.of(List.of(1, 1, 1), List.of(2, 2, 2)).collect(Zipper.zipCollector());
// output is [[1, 2], [1, 2], [1, 2]]
```
**Since order of output elements is correlated to order of input elements using unordered and/or parallel streams might cause unexpected results!**
Using this collector is equivalent to collecting elements into a list and zipping the resulting collection via the first method.
### `NullPointerException`
All three methods will throw `NullPointerException` if one of zipped lists is null, or if main argument is null in case of zipping list of lists.
`zipCollector()` won't throw `NullPointerException` directly, however applying returned collector to a stream will.