jdk-sandbox: comparison src/java.base/share/classes/java/io/InputStream.java

equal deleted inserted replaced

-:33de7752835c
+:94bb65cb37d3
 *
 * <p> A subclass must provide an implementation of this method.
 *
 * @return     the next byte of data, or <code>-1</code> if the end of the
 *             stream is reached.
-* @exception  IOException  if an I/O error occurs.
+* @throws     IOException  if an I/O error occurs.
 */
 public abstract int read() throws IOException;
 /**
 * Reads some number of bytes from the input stream and stores them into
 *
 * @param      b   the buffer into which the data is read.
 * @return     the total number of bytes read into the buffer, or
 *             <code>-1</code> if there is no more data because the end of
 *             the stream has been reached.
-* @exception  IOException  If the first byte cannot be read for any reason
+* @throws     IOException  If the first byte cannot be read for any reason
-* other than the end of the file, if the input stream has been closed, or
+*             other than the end of the file, if the input stream has been
-* if some other I/O error occurs.
+*             closed, or if some other I/O error occurs.
-* @exception  NullPointerException  if <code>b</code> is <code>null</code>.
+* @throws     NullPointerException  if <code>b</code> is <code>null</code>.
 * @see        java.io.InputStream#read(byte[], int, int)
 */
 public int read(byte b[]) throws IOException {
 return read(b, 0, b.length);
 }
 *                   at which the data is written.
 * @param      len   the maximum number of bytes to read.
 * @return     the total number of bytes read into the buffer, or
 *             <code>-1</code> if there is no more data because the end of
 *             the stream has been reached.
-* @exception  IOException If the first byte cannot be read for any reason
+* @throws     IOException If the first byte cannot be read for any reason
-* other than end of file, or if the input stream has been closed, or if
+*             other than end of file, or if the input stream has been closed,
-* some other I/O error occurs.
+*             or if some other I/O error occurs.
-* @exception  NullPointerException If <code>b</code> is <code>null</code>.
+* @throws     NullPointerException If <code>b</code> is <code>null</code>.
-* @exception  IndexOutOfBoundsException If <code>off</code> is negative,
+* @throws     IndexOutOfBoundsException If <code>off</code> is negative,
-* <code>len</code> is negative, or <code>len</code> is greater than
+*             <code>len</code> is negative, or <code>len</code> is greater than
-* <code>b.length - off</code>
+*             <code>b.length - off</code>
 * @see        java.io.InputStream#read()
 */
 public int read(byte b[], int off, int len) throws IOException {
 Objects.checkFromIndexSize(off, len, b.length);
 if (len == 0) {
 * <p> This method should be overridden by subclasses.
 *
 * @return     an estimate of the number of bytes that can be read (or
 *             skipped over) from this input stream without blocking or
 *             {@code 0} when it reaches the end of the input stream.
-* @exception  IOException if an I/O error occurs.
+* @throws     IOException if an I/O error occurs.
 */
 public int available() throws IOException {
 return 0;
 }
 * with the stream.
 *
 * <p> The <code>close</code> method of <code>InputStream</code> does
 * nothing.
 *
-* @exception  IOException  if an I/O error occurs.
+* @throws     IOException  if an I/O error occurs.
 */
 public void close() throws IOException {}
 /**
 * Marks the current position in this input stream. A subsequent call to
 *     particular type of the input stream. </ul></ul>
 *
 * <p>The method <code>reset</code> for class <code>InputStream</code>
 * does nothing except throw an <code>IOException</code>.
 *
-* @exception  IOException  if this stream has not been marked or if the
+* @throws  IOException  if this stream has not been marked or if the
-*               mark has been invalidated.
+*          mark has been invalidated.
 * @see     java.io.InputStream#mark(int)
 * @see     java.io.IOException
 */
 public synchronized void reset() throws IOException {
 throw new IOException("mark/reset not supported");

changeset 58242	94bb65cb37d3
parent 58054	ee230ad8cfef
child 58288	48e480e56aad