151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/* 251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Copyright (c) 1995, 2004, Oracle and/or its affiliates. All rights reserved. 351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is free software; you can redistribute it and/or modify it 651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * under the terms of the GNU General Public License version 2 only, as 751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * published by the Free Software Foundation. Oracle designates this 851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * particular file as subject to the "Classpath" exception as provided 951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * by Oracle in the LICENSE file that accompanied this code. 1051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This code is distributed in the hope that it will be useful, but WITHOUT 1251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 1351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 1451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * version 2 for more details (a copy is included in the LICENSE file that 1551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * accompanied this code). 1651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 1751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * You should have received a copy of the GNU General Public License version 1851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2 along with this work; if not, write to the Free Software Foundation, 1951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 2151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * or visit www.oracle.com if you need additional information or have any 2351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * questions. 2451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 2551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipackage java.io; 2751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 2851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski/** 2951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * This class allows an application to create an input stream in 3051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * which the bytes read are supplied by the contents of a string. 3151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Applications can also read bytes from a byte array by using a 3251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>ByteArrayInputStream</code>. 3351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 3451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Only the low eight bits of each character in the string are used by 3551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * this class. 3651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 3751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @author Arthur van Hoff 3851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.io.ByteArrayInputStream 3951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.io.StringReader 4051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @since JDK1.0 4151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @deprecated This class does not properly convert characters into bytes. As 4251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * of JDK 1.1, the preferred way to create a stream from a 4351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * string is via the <code>StringReader</code> class. 4451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 4551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski@Deprecated 4651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskipublic 4751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebskiclass StringBufferInputStream extends InputStream { 4851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 4951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The string from which bytes are read. 5051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 5151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected String buffer; 5251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 5351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 5451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The index of the next character to read from the input stream buffer. 5551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 5651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.io.StringBufferInputStream#buffer 5751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 5851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected int pos; 5951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 6051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 6151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The number of valid characters in the input stream buffer. 6251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 6351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @see java.io.StringBufferInputStream#buffer 6451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 6551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski protected int count; 6651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 6751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 6851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Creates a string input stream to read data from the specified string. 6951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 7051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param s the underlying input buffer. 7151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 7251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public StringBufferInputStream(String s) { 7351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski this.buffer = s; 7451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski count = s.length(); 7551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 7651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 7751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 7851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Reads the next byte of data from this input stream. The value 7951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * byte is returned as an <code>int</code> in the range 8051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>0</code> to <code>255</code>. If no byte is available 8151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * because the end of the stream has been reached, the value 8251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>-1</code> is returned. 8351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 8451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The <code>read</code> method of 8551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>StringBufferInputStream</code> cannot block. It returns the 8651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * low eight bits of the next character in this input stream's buffer. 8751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 8851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the next byte of data, or <code>-1</code> if the end of the 8951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * stream is reached. 9051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 9151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public synchronized int read() { 9251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return (pos < count) ? (buffer.charAt(pos++) & 0xFF) : -1; 9351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 9451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 9551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 9651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Reads up to <code>len</code> bytes of data from this input stream 9751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * into an array of bytes. 9851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <p> 9951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * The <code>read</code> method of 10051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>StringBufferInputStream</code> cannot block. It copies the 10151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * low eight bits from the characters in this input stream's buffer into 10251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the byte array argument. 10351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 10451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param b the buffer into which the data is read. 10551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param off the start offset of the data. 10651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param len the maximum number of bytes read. 10751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the total number of bytes read into the buffer, or 10851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * <code>-1</code> if there is no more data because the end of 10951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * the stream has been reached. 11051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 11151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public synchronized int read(byte b[], int off, int len) { 11251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (b == null) { 11351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new NullPointerException(); 11451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } else if ((off < 0) || (off > b.length) || (len < 0) || 11551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski ((off + len) > b.length) || ((off + len) < 0)) { 11651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski throw new IndexOutOfBoundsException(); 11751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 11851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (pos >= count) { 11951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return -1; 12051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 121a810284b165943041afbbd4e920b8997ae88fdefPrzemyslaw Szczepaniak 122a810284b165943041afbbd4e920b8997ae88fdefPrzemyslaw Szczepaniak int avail = count - pos; 123a810284b165943041afbbd4e920b8997ae88fdefPrzemyslaw Szczepaniak if (len > avail) { 124a810284b165943041afbbd4e920b8997ae88fdefPrzemyslaw Szczepaniak len = avail; 12551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 12651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (len <= 0) { 12751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return 0; 12851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 12951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski String s = buffer; 13051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski int cnt = len; 13151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski while (--cnt >= 0) { 13251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski b[off++] = (byte)s.charAt(pos++); 13351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 13451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 13551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return len; 13651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 13751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 13851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 13951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Skips <code>n</code> bytes of input from this input stream. Fewer 14051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * bytes might be skipped if the end of the input stream is reached. 14151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 14251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @param n the number of bytes to be skipped. 14351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the actual number of bytes skipped. 14451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 14551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public synchronized long skip(long n) { 14651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (n < 0) { 14751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return 0; 14851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 14951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski if (n > count - pos) { 15051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski n = count - pos; 15151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 15251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski pos += n; 15351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return n; 15451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 15551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 15651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 15751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Returns the number of bytes that can be read from the input 15851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * stream without blocking. 15951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * 16051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * @return the value of <code>count - pos</code>, which is the 16151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * number of bytes remaining to be read from the input buffer. 16251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 16351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public synchronized int available() { 16451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski return count - pos; 16551b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 16651b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski 16751b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski /** 16851b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * Resets the input stream to begin reading from the first character 16951b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski * of this input stream's underlying buffer. 17051b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski */ 17151b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski public synchronized void reset() { 17251b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski pos = 0; 17351b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski } 17451b1b6997fd3f980076b8081f7f1165ccc2a4008Piotr Jastrzebski} 175