1 /*
2  * Copyright (C) 2007 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package com.google.android.collect;
18 
19 import android.annotation.UnsupportedAppUsage;
20 import java.util.ArrayList;
21 import java.util.Collections;
22 
23 /**
24  * Provides static methods for creating {@code List} instances easily, and other
25  * utility methods for working with lists.
26  */
27 public class Lists {
28 
29     /**
30      * Creates an empty {@code ArrayList} instance.
31      *
32      * <p><b>Note:</b> if you only need an <i>immutable</i> empty List, use
33      * {@link Collections#emptyList} instead.
34      *
35      * @return a newly-created, initially-empty {@code ArrayList}
36      */
37     @UnsupportedAppUsage
newArrayList()38     public static <E> ArrayList<E> newArrayList() {
39         return new ArrayList<E>();
40     }
41 
42     /**
43      * Creates a resizable {@code ArrayList} instance containing the given
44      * elements.
45      *
46      * <p><b>Note:</b> due to a bug in javac 1.5.0_06, we cannot support the
47      * following:
48      *
49      * <p>{@code List<Base> list = Lists.newArrayList(sub1, sub2);}
50      *
51      * <p>where {@code sub1} and {@code sub2} are references to subtypes of
52      * {@code Base}, not of {@code Base} itself. To get around this, you must
53      * use:
54      *
55      * <p>{@code List<Base> list = Lists.<Base>newArrayList(sub1, sub2);}
56      *
57      * @param elements the elements that the list should contain, in order
58      * @return a newly-created {@code ArrayList} containing those elements
59      */
60     @UnsupportedAppUsage
newArrayList(E... elements)61     public static <E> ArrayList<E> newArrayList(E... elements) {
62         int capacity = (elements.length * 110) / 100 + 5;
63         ArrayList<E> list = new ArrayList<E>(capacity);
64         Collections.addAll(list, elements);
65         return list;
66     }
67 }
68