htsjdk.samtools.util

Class CollectionUtil

java.lang.Object

htsjdk.samtools.util.CollectionUtil

public class CollectionUtil
extends java.lang.Object

Small utility methods for dealing with collection classes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CollectionUtil.DefaultingMap<K,V> A defaulting map, which returns a default value when a value that does not exist in the map is looked up.
static class	CollectionUtil.MultiMap<K,V> Simple multi-map for convenience of storing collections in map values.
static class	CollectionUtil.Partitioner<V,K> Deprecated. use Collectors.groupingBy instead

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Comparator<java.lang.Object>	OBJECT_TOSTRING_COMPARATOR Simple case-insensitive lexical comparator of objects using their Object.toString() value.

Constructor Summary

Constructors

Constructor and Description
CollectionUtil()

Method Summary

Modifier and Type	Method and Description
static <T> T	getSoleElement(java.util.Collection<T> items)
static java.lang.String	join(java.util.Collection<?> items, java.lang.String inBetween) Construct a string by toString()ing each item in the collection with inBetween between each item.
static <T> java.util.Collection<T>	makeCollection(java.util.Iterator<T> i)
static <T> java.util.List<T>	makeList(T... list)
static <T> java.util.Set<T>	makeSet(T... list)
static <K,V> java.util.Map<K,java.util.Collection<V>>	partition(java.util.Collection<V> collection, CollectionUtil.Partitioner<V,K> p) Deprecated. use java8 .stream().collect(Collectors.groupingBy(()-> function)) instead
static <K,V> java.util.Map<K,java.util.Collection<V>>	partition(java.util.Collection<V> collection, java.util.function.Function<? super V,? extends K> keyer) Partitions a collection into groups based on a characteristics of that group.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

OBJECT_TOSTRING_COMPARATOR

public static final java.util.Comparator<java.lang.Object> OBJECT_TOSTRING_COMPARATOR

Simple case-insensitive lexical comparator of objects using their Object.toString() value.

Constructor Detail

CollectionUtil

public CollectionUtil()

Method Detail

makeList

public static <T> java.util.List<T> makeList(T... list)

makeSet

public static <T> java.util.Set<T> makeSet(T... list)

makeCollection

public static <T> java.util.Collection<T> makeCollection(java.util.Iterator<T> i)

join

public static java.lang.String join(java.util.Collection<?> items,
                                    java.lang.String inBetween)

Construct a string by toString()ing each item in the collection with inBetween between each item.

getSoleElement

public static <T> T getSoleElement(java.util.Collection<T> items)

partition

@Deprecated
public static <K,V> java.util.Map<K,java.util.Collection<V>> partition(java.util.Collection<V> collection,
                                                                                   CollectionUtil.Partitioner<V,K> p)

Deprecated. use java8 .stream().collect(Collectors.groupingBy(()-> function)) instead

Partitions a collection into groups based on a characteristics of that group. Partitions are embodied in a map, whose keys are the value of that characteristic, and the values are the partition of elements whose characteristic evaluate to that key.

partition

public static <K,V> java.util.Map<K,java.util.Collection<V>> partition(java.util.Collection<V> collection,
                                                                       java.util.function.Function<? super V,? extends K> keyer)

Partitions a collection into groups based on a characteristics of that group. Partitions are embodied in a map, whose keys are the value of that characteristic, and the values are the partition of elements whose characteristic evaluate to that key.