Method immutableSortedCopy

output/java_guava/1.4.17/Ordering.java:905–914

Returns an immutable list containing elements sorted by this ordering. The input is not modified. Unlike Sets#newTreeSet(Iterable), this method does not discard elements that are duplicates according to the comparator. The sort performed is stable , meaning that such

(Iterable<E> elements)

   */

  @CanIgnoreReturnValue // TODO(kak): Consider removing this
  public <E extends T> ImmutableList<E> immutableSortedCopy(Iterable<E> elements) {
    @SuppressWarnings("unchecked") // we'll only ever have E's in here
    E[] array = (E[]) Iterables.toArray(elements);
    for (E e : array) {
      checkNotNull(e);
    }
    Arrays.sort(array, this);
    return ImmutableList.asImmutableList(array);
  }

  /**
   * Returns {@code true} if each element in {@code iterable} after the first is