Lists.java

  1. /*
  2.  * Licensed to the Apache Software Foundation (ASF) under one
  3.  * or more contributor license agreements.  See the NOTICE file
  4.  * distributed with this work for additional information
  5.  * regarding copyright ownership.  The ASF licenses this file
  6.  * to you under the Apache License, Version 2.0 (the
  7.  * "License"); you may not use this file except in compliance
  8.  * with the License.  You may obtain a copy of the License at
  9.  *
  10.  * http://www.apache.org/licenses/LICENSE-2.0
  11.  *
  12.  * Unless required by applicable law or agreed to in writing,
  13.  * software distributed under the License is distributed on an
  14.  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
  15.  * KIND, either express or implied.  See the License for the
  16.  * specific language governing permissions and limitations
  17.  * under the License.
  18.  */

  19. package org.apache.commons.compress.utils;

  20. import java.util.ArrayList;
  21. import java.util.Iterator;

  22. /**
  23.  * List utilities
  24.  *
  25.  * @since 1.13
  26.  */
  27. public class Lists {

  28.     /**
  29.      * Creates a new {@link ArrayList}.
  30.      *
  31.      * @param <E> type of elements contained in new list
  32.      * @return a new {@link ArrayList}
  33.      */
  34.     public static <E> ArrayList<E> newArrayList() {
  35.         return new ArrayList<>();
  36.     }

  37.     /**
  38.      * Creates a new {@link ArrayList} filled with the contents of the given {@code iterator}.
  39.      *
  40.      * @param iterator the source iterator
  41.      * @param <E>      type of elements contained in new list
  42.      * @return a new {@link ArrayList}
  43.      */
  44.     public static <E> ArrayList<E> newArrayList(final Iterator<? extends E> iterator) {
  45.         final ArrayList<E> list = newArrayList();
  46.         Iterators.addAll(list, iterator);
  47.         return list;
  48.     }

  49.     private Lists() {
  50.         // do not instantiate
  51.     }

  52. }