| Modifier and Type | Method and Description |
|---|---|
| public <V> UnsortedBag | collect(Function<? super T, ? extends V> function)
Redeclares org. Returns a new collection with the results of applying the specified function on each element of the source collection. |
| public BooleanBag | collectBoolean(BooleanFunction<? super T> booleanFunction)
Redeclares org. Returns a new primitive |
| public ByteBag | collectByte(ByteFunction<? super T> byteFunction)
Redeclares org. Returns a new primitive |
| public CharBag | collectChar(CharFunction<? super T> charFunction)
Redeclares org. Returns a new primitive |
| public DoubleBag | collectDouble(DoubleFunction<? super T> doubleFunction)
Redeclares org. Returns a new primitive |
| public FloatBag | collectFloat(FloatFunction<? super T> floatFunction)
Redeclares org. Returns a new primitive |
| public <V> UnsortedBag | collectIf(Predicate<? super T> predicate, Function<? super T, ? extends V> function)
Redeclares org. Returns a new collection with the results of applying the specified function on each element of the source collection, but only for those elements which return true upon evaluation of the predicate. |
| public IntBag | collectInt(IntFunction<? super T> intFunction)
Redeclares org. Returns a new primitive |
| public LongBag | collectLong(LongFunction<? super T> longFunction)
Redeclares org. Returns a new primitive |
| public ShortBag | collectShort(ShortFunction<? super T> shortFunction)
Redeclares org. Returns a new primitive |
| public <P, V> UnsortedBag | collectWith(Function2<? super T, ? super P, ? extends V> function, P parameter)
Redeclares org. Same as |
| public <V> UnsortedBag | collectWithOccurrences(ObjectIntToObjectFunction<? super T, ? extends V> function)
Redeclares org. Iterates over the unique elements and their occurrences and collects the results of applying the specified function. |
| public <V> UnsortedBag | flatCollect(Function<? super T, ? extends Iterable<V>> function)
Redeclares org.
|
| public default <P, V> UnsortedBag | flatCollectWith(Function2<? super T, ? super P, ? extends Iterable<V>> function, P parameter)
Overrides default org. Same as flatCollect, only with a Function2 that is passed an extra parameter. |
| public <V> UnsortedBagMultimap | groupBy(Function<? super T, ? extends V> function)
Redeclares org. For each element of the iterable, the function is evaluated and the results of these evaluations are collected into a new multimap, where the transformed value is the key and the original values are added to the same (or similar) species of collection as the source iterable. |
| public <V> UnsortedBagMultimap | groupByEach(Function<? super T, ? extends Iterable<V>> function)
Redeclares org. Similar to |
| public PartitionUnsortedBag | partition(Predicate<? super T> predicate)
Redeclares org. Filters a collection into a PartitionedIterable based on the evaluation of the predicate. |
| public UnsortedBag | reject(Predicate<? super T> predicate)
Redeclares org. Returns all elements of the source collection that return false when evaluating of the predicate. |
| public <P> UnsortedBag | rejectWith(Predicate2<? super T, ? super P> predicate, P parameter)
Redeclares org. Similar to |
| public UnsortedBag | select(Predicate<? super T> predicate)
Redeclares org. Returns all elements of the source collection that return true when evaluating the predicate. |
| public UnsortedBag | selectByOccurrences(IntPredicate predicate)
Redeclares org. Returns all elements of the bag that have a number of occurrences that satisfy the predicate. |
| public default UnsortedBag | selectDuplicates()
Overrides default org. Returns all elements of the bag that have more than one occurrence. |
| public <S> UnsortedBag | selectInstancesOf(Class<S> clazz)
Redeclares org. Returns all elements of the source collection that are instances of the Class |
| public UnsortedSetIterable | selectUnique()
Redeclares org. Returns a set containing all elements of the bag that have exactly one occurrence. |
| public <P> UnsortedBag | selectWith(Predicate2<? super T, ? super P> predicate, P parameter)
Redeclares org. Similar to |
| public UnsortedBag | tap(Procedure<? super T> procedure)
Redeclares org. Executes the Procedure for each element in the iterable and returns |
| public <S> UnsortedBag | zip(Iterable<S> that)
Redeclares org.
Deprecated
in 6.0. Use
OrderedIterable#zip(Iterable) instead.
Returns a |
| public UnsortedSetIterable | zipWithIndex()
Redeclares org.
Deprecated
in 6.0. Use
OrderedIterable#zipWithIndex() instead.
Zips this |
| collect | back to summary |
|---|---|
| public <V> UnsortedBag Redeclares org. Doc from org. Returns a new collection with the results of applying the specified function on each element of the source collection. This method is also commonly called transform or map. Example using a Java 8 lambda expression:
RichIterable<String> names =
people.collect(person -> person.getFirstName() + " " + person.getLastName());
| |
| collectBoolean | back to summary |
|---|---|
| public BooleanBag collectBoolean(BooleanFunction<? super T> booleanFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
BooleanIterable licenses =
people.collectBoolean(person -> person.hasDrivingLicense());
| |
| collectByte | back to summary |
|---|---|
| public ByteBag collectByte(ByteFunction<? super T> byteFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
ByteIterable bytes =
people.collectByte(person -> person.getCode());
| |
| collectChar | back to summary |
|---|---|
| public CharBag collectChar(CharFunction<? super T> charFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
CharIterable chars =
people.collectChar(person -> person.getMiddleInitial());
| |
| collectDouble | back to summary |
|---|---|
| public DoubleBag collectDouble(DoubleFunction<? super T> doubleFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
DoubleIterable doubles =
people.collectDouble(person -> person.getMilesFromNorthPole());
| |
| collectFloat | back to summary |
|---|---|
| public FloatBag collectFloat(FloatFunction<? super T> floatFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
FloatIterable floats =
people.collectFloat(person -> person.getHeightInInches());
| |
| collectIf | back to summary |
|---|---|
| public <V> UnsortedBag Redeclares org. Doc from org. Returns a new collection with the results of applying the specified function on each element of the source collection, but only for those elements which return true upon evaluation of the predicate. This is the optimized equivalent of calling iterable.select(predicate).collect(function). Example using a Java 8 lambda and method reference: RichIterable<String> strings = Lists.mutable.with(1, 2, 3).collectIf(e -> e != null, Object::toString); Example using Predicates factory: RichIterable<String> strings = Lists.mutable.with(1, 2, 3).collectIf(Predicates.notNull(), Functions.getToString());
| |
| collectInt | back to summary |
|---|---|
| public IntBag collectInt(IntFunction<? super T> intFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
IntIterable ints =
people.collectInt(person -> person.getAge());
| |
| collectLong | back to summary |
|---|---|
| public LongBag collectLong(LongFunction<? super T> longFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
LongIterable longs =
people.collectLong(person -> person.getGuid());
| |
| collectShort | back to summary |
|---|---|
| public ShortBag collectShort(ShortFunction<? super T> shortFunction) Redeclares org. Doc from org. Returns a new primitive Example using a Java 8 lambda expression:
ShortIterable shorts =
people.collectShort(person -> person.getNumberOfJunkMailItemsReceivedPerMonth());
| |
| collectWith | back to summary |
|---|---|
| public <P, V> UnsortedBag Redeclares org. Doc from org. Same as Example using a Java 8 lambda expression:
RichIterable<Integer> integers =
Lists.mutable.with(1, 2, 3).collectWith((each, parameter) -> each + parameter, Integer.valueOf(1));
| |
| collectWithOccurrences | back to summary |
|---|---|
| public <V> UnsortedBag Redeclares org. Doc from org. Iterates over the unique elements and their occurrences and collects the results of applying the specified function.
| |
| flatCollect | back to summary |
|---|---|
| public <V> UnsortedBag Redeclares org. Doc from org.
Consider the following example where we have a Function<Person, List<Address>> addressFunction = Person::getAddresses; RichIterable<Person> people = ...;Using collect returns a collection of collections of addresses.
RichIterable<List<Address>> addresses = people.collect(addressFunction);Using flatCollect returns a single flattened list of addresses.
RichIterable<Address> addresses = people.flatCollect(addressFunction);
| |
| flatCollectWith | back to summary |
|---|---|
| public default <P, V> UnsortedBag Overrides default org. Doc from org. Same as flatCollect, only with a Function2 that is passed an extra parameter.
| |
| groupBy | back to summary |
|---|---|
| public <V> UnsortedBagMultimap Redeclares org. Doc from org. For each element of the iterable, the function is evaluated and the results of these evaluations are collected into a new multimap, where the transformed value is the key and the original values are added to the same (or similar) species of collection as the source iterable. Example using a Java 8 method reference:
Multimap<String, Person> peopleByLastName =
people.groupBy(Person::getLastName);
| |
| groupByEach | back to summary |
|---|---|
| public <V> UnsortedBagMultimap Redeclares org. Doc from org. Similar to
| |
| partition | back to summary |
|---|---|
| public PartitionUnsortedBag Redeclares org. Doc from org. Filters a collection into a PartitionedIterable based on the evaluation of the predicate. Example using a Java 8 lambda expression:
PartitionIterable<Person> newYorkersAndNonNewYorkers =
people.partition(person -> person.getAddress().getState().getName().equals("New York"));
| |
| reject | back to summary |
|---|---|
| public UnsortedBag Redeclares org. Doc from org. Returns all elements of the source collection that return false when evaluating of the predicate. This method is also sometimes called filterNot and is the equivalent of calling iterable.select(Predicates.not(predicate)). Example using a Java 8 lambda expression:
RichIterable<Person> rejected =
people.reject(person -> person.person.getLastName().equals("Smith"));
| |
| rejectWith | back to summary |
|---|---|
| public <P> UnsortedBag Redeclares org. Doc from org. Similar to
E.g. return a Example using a Java 8 lambda expression:
RichIterable<Person> rejected =
people.rejectWith((Person person, Integer age) -> person.getAge() < age, Integer.valueOf(18));
| |
| select | back to summary |
|---|---|
| public UnsortedBag Redeclares org. Doc from org. Returns all elements of the source collection that return true when evaluating the predicate. This method is also commonly called filter. Example using a Java 8 lambda expression:
RichIterable<Person> selected =
people.select(person -> person.getAddress().getCity().equals("London"));
| |
| selectByOccurrences | back to summary |
|---|---|
| public UnsortedBag Redeclares org. Doc from org. Returns all elements of the bag that have a number of occurrences that satisfy the predicate.
| |
| selectDuplicates | back to summary |
|---|---|
| public default UnsortedBag Overrides default org. Doc from org. Returns all elements of the bag that have more than one occurrence.
| |
| selectInstancesOf | back to summary |
|---|---|
| public <S> UnsortedBag Redeclares org. Doc from org. Returns all elements of the source collection that are instances of the Class
RichIterable<Integer> integers =
List.mutable.with(new Integer(0), new Long(0L), new Double(0.0)).selectInstancesOf(Integer.class);
| |
| selectUnique | back to summary |
|---|---|
| public UnsortedSetIterable Redeclares org. Doc from org. Returns a set containing all elements of the bag that have exactly one occurrence.
| |
| selectWith | back to summary |
|---|---|
| public <P> UnsortedBag Redeclares org. Doc from org. Similar to
E.g. return a Example using a Java 8 lambda expression:
RichIterable<Person> selected =
people.selectWith((Person person, Integer age) -> person.getAge()>= age, Integer.valueOf(18));
| |
| tap | back to summary |
|---|---|
| public UnsortedBag Redeclares org. Doc from org. Executes the Procedure for each element in the iterable and returns Example using a Java 8 lambda expression:
RichIterable<Person> tapped =
people.tap(person -> LOGGER.info(person.getName()));
| |
| zip | back to summary |
|---|---|
| public <S> UnsortedBag Redeclares org. Doc from org. Deprecated in 6.0. Use Returns a
| |
| zipWithIndex | back to summary |
|---|---|
| public UnsortedSetIterable Redeclares org. Doc from org. Deprecated in 6.0. Use Zips this
| |