1f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/* 2f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Copyright (c) 2000 World Wide Web Consortium, 3f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * (Massachusetts Institute of Technology, Institut National de 4f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Recherche en Informatique et en Automatique, Keio University). All 5f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Rights Reserved. This program is distributed under the W3C's Software 6f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Intellectual Property License. This program is distributed in the 7f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * hope that it will be useful, but WITHOUT ANY WARRANTY; without even 8f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 9f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * PURPOSE. 10f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * See W3C License http://www.w3.org/Consortium/Legal/ for more details. 11f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 12f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 13f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpackage org.w3c.dom; 14f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 15f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project// BEGIN android-note 16f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project// Cleaned up @param tags that seemed to be missing spaces between 17f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project// the parameter name and the start of the description. 18f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project// END android-note 19f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 20f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//BEGIN android-note 21f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//Filled some gaps in the documentation and refactored parts of the existing 22f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//documentation to make the Doclet happy. 23f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project//END android-note 24f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 25f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project/** 26f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The <code>NodeList</code> interface provides the abstraction of an ordered 27f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * collection of nodes, without defining or constraining how this collection 28f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * is implemented. <code>NodeList</code> objects in the DOM are live. 29f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p>The items in the <code>NodeList</code> are accessible via an integral 30f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * index, starting from 0. 31f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Core-20001113'>Document Object Model (DOM) Level 2 Core Specification</a>. 32f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 33f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Projectpublic interface NodeList { 34f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 35f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * Returns the <code>index</code>th item in the collection. If 36f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <code>index</code> is greater than or equal to the number of nodes in 37f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * the list, this returns <code>null</code>. 38f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @param index Index into the collection. 39f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return The node at the <code>index</code>th position in the 40f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * <code>NodeList</code>, or <code>null</code> if that is not a valid 41f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * index. 42f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 43f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public Node item(int index); 44f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 45f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project /** 46f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * The number of nodes in the list. The range of valid child node indices 47f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * is 0 to <code>length-1</code> inclusive. 48f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * 49f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project * @return the length of the list. 50f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project */ 51f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project public int getLength(); 52f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project 53f6c387128427e121477c1b32ad35cdcaa5101ba3The Android Open Source Project} 54