001    /*
002     * Copyright (c) 2007 Henri Sivonen
003     * Copyright (c) 2010 Mozilla Foundation
004     *
005     * Permission is hereby granted, free of charge, to any person obtaining a 
006     * copy of this software and associated documentation files (the "Software"), 
007     * to deal in the Software without restriction, including without limitation 
008     * the rights to use, copy, modify, merge, publish, distribute, sublicense, 
009     * and/or sell copies of the Software, and to permit persons to whom the 
010     * Software is furnished to do so, subject to the following conditions:
011     *
012     * The above copyright notice and this permission notice shall be included in 
013     * all copies or substantial portions of the Software.
014     *
015     * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 
016     * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
017     * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 
018     * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 
019     * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 
020     * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 
021     * DEALINGS IN THE SOFTWARE.
022     */
023    
024    package nu.validator.htmlparser.common;
025    
026    import java.io.IOException;
027    
028    /**
029     * An interface for providing a method for reading a stream of bytes one byte at
030     * a time.
031     * 
032     * @version $Id$
033     * @author hsivonen
034     */
035    public interface ByteReadable {
036        /**
037         * Returns the value of the next byte as an integer from 0 to 0xFF or -1 if
038         * the stream has ended.
039         * 
040         * @return integer from 0 to 0xFF or -1 on EOF
041         * @throws IOException
042         */
043        public int readByte() throws IOException;
044    }