1 /* 2 * reserved comment block 3 * DO NOT REMOVE OR ALTER! 4 */ 5 /* 6 * Copyright 2004,2005 The Apache Software Foundation. 7 * 8 * Licensed under the Apache License, Version 2.0 (the "License"); 9 * you may not use this file except in compliance with the License. 10 * You may obtain a copy of the License at 11 * 12 * http://www.apache.org/licenses/LICENSE-2.0 13 * 14 * Unless required by applicable law or agreed to in writing, software 15 * distributed under the License is distributed on an "AS IS" BASIS, 16 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 17 * See the License for the specific language governing permissions and 18 * limitations under the License. 19 */ 20 package com.sun.org.apache.xerces.internal.xs.datatypes; 21 22 import java.util.List; 23 24 import com.sun.org.apache.xerces.internal.xs.XSException; 25 26 /** 27 * <p>The <code>ByteList</code> is an immutable ordered collection of 28 * <code>byte</code>.</p> 29 * 30 * @author Ankit Pasricha, IBM 31 * 32 * @version $Id: ByteList.java,v 1.7 2010-11-01 04:40:31 joehw Exp $ 33 */ 34 public interface ByteList extends List { 35 36 /** 37 * The number of <code>byte</code>s in the list. The range of 38 * valid child object indices is 0 to <code>length-1</code> inclusive. 39 */ 40 public int getLength(); 41 42 /** 43 * Checks if the <code>byte</code> <code>item</code> is a 44 * member of this list. 45 * @param item <code>byte</code> whose presence in this list 46 * is to be tested. 47 * @return True if this list contains the <code>byte</code> 48 * <code>item</code>. 49 */ 50 public boolean contains(byte item); 51 52 /** 53 * Returns the <code>index</code>th item in the collection. The index 54 * starts at 0. 55 * @param index index into the collection. 56 * @return The <code>byte</code> at the <code>index</code>th 57 * position in the <code>ByteList</code>. 58 * @exception XSException 59 * INDEX_SIZE_ERR: if <code>index</code> is greater than or equal to the 60 * number of objects in the list or less than zero. 61 */ 62 public byte item(int index) throws XSException; 63 64 }