1 /* Licensed to the Apache Software Foundation (ASF) under one or more
2  * contributor license agreements.  See the NOTICE file distributed with
3  * this work for additional information regarding copyright ownership.
4  * The ASF licenses this file to You under the Apache License, Version 2.0
5  * (the "License"); you may not use this file except in compliance with
6  * the License.  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 java.lang;
18 
19 import java.util.Iterator;
20 
21 /**
22  * Instances of classes that implement this interface can be used with
23  * the enhanced for loop.
24  *
25  * @since 1.5
26  */
27 public interface Iterable<T> {
28 
29     /**
30      * Returns an {@link Iterator} for the elements in this object.
31      *
32      * @return An {@code Iterator} instance.
33      */
iterator()34     Iterator<T> iterator();
35 }
36