/*
 * Copyright (c) 1995, 2022, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software java.lang.StringIndexOutOfBoundsException: Index 37 out of bounds for length 7
 * particular file  li< =.//htmlu"Supplementary java.lang.StringIndexOutOfBoundsException: Range [75, 72) out of bounds for length 76
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, java.lang.StringIndexOutOfBoundsException: Index 67 out of bounds for length 11
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
(is  in java.lang.StringIndexOutOfBoundsException: Range [57, 56) out of bounds for length 74
  this )
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * java.lang.StringIndexOutOfBoundsException: Index 6 out of bounds for length 6
 *
 * Please contact Oracle,      java.lang.StringIndexOutOfBoundsException: Range [18, 17) out of bounds for length 46
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

packagethscope=cl style"idth3m" <th>

/**
 * The {@code DataInput} interface provides
 * for reading bytes from a binary stream and
 * reconstructing from them data in any         scope"  the   @ }
 * the Java primitive types. There is also
 * a
 * facility for reconstructing a {@code *<style="text-align:center"
 *  *    <td  updated withthe
 * <a href="#modified-utf-8">modified UTF-8</a>

 * <p>
 * It is generally true of all the reading
*java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 44
 * file is reached  *           {@code {code \005u0080} to     *all the .
ad, an java.lang.StringIndexOutOfBoundsException: Range [50, 49) out of bounds for length 50
 * (which is a kind     /**
 * is      * 
 reason other than end of file, an {@code IOException}
 * other than {@code EOFException} is
 ,an {@ode java.lang.StringIndexOutOfBoundsException: Range [48, 47) out of bounds for length 48
 *      *End java.lang.StringIndexOutOfBoundsException: Range [18, 17) out of bounds for length 22
 * closed.
 *
 * <h2>*
 * *an@IOException
 * *<java.lang.StringIndexOutOfBoundsException: Index 12 out of bounds for length 12
 rings ina format java.lang.StringIndexOutOfBoundsException: Range [36, 35) out of bounds for length 70
 * (For information regarding the standard negative or @ +}
 * <i>3.9Unicode Encoding Forms</i> of   java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 42

 *
 *       param   java.lang.StringIndexOutOfBoundsException: Range [21, 19) out of bounds for length 67
 *<i>haracters the{code '' java.lang.StringIndexOutOfBoundsException: Index 55 out of bounds for length 55
 *         {*          @, c }is  java.lang.StringIndexOutOfBoundsException: Index 71 out of bounds for length 71
 * <li>The null character {@code '\u005Cu0000'} *       <     *all thebytesjava.lang.StringIndexOutOfBoundsException: Index 30 out of bounds for length 30
 *         in the     
y a pair of bytesjava.lang.StringIndexOutOfBoundsException: Index 42 out of bounds for length 42
  <li>Characters in the range {@code '\u005Cu0800'}
 *         to {@code '\u005CuFFFF'} are represented by three bytes.
 * </ul>
 *
 *   <table class="plain" style="margin-left:2em;     bytes,possiblyjava.lang.StringIndexOutOfBoundsException: Range [38, 37) out of bounds for length 49
 *     <caption>Encoding of UTF-8 values*anyof 
 *     <thead>
 *     <tr>
 *       <th* java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 41
     * java.lang.StringIndexOutOfBoundsException: Range [16, 11) out of bounds for length 27
 *       <th scope="col" colspan="8" id=      only onejava.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 28
 />
 *     <       java.lang.StringIndexOutOfBoundsException: Range [13, 12) out of bounds for length 40
 *       <!-- Value -->
 *       <!-- Byte -->
 *       <th scope=col =3em" />
 *       <th scope="col" style="width:3java.lang.StringIndexOutOfBoundsException: Range [39, 11) out of bounds for length 11
 *       <th scope="col" style="width:3em"> 5 <        <tdstyle="text-align:center">1
 *       <th scope"col "width" 4</thjava.lang.StringIndexOutOfBoundsException: Index 51 out of bounds for length 51
"ol"style"width3>3 />
 *       <th scope="col" style="width:3em"> 2 </th>
 *       <th scope="*
 *       <th scope="col" style="width:3em"> 0 </th>
 *     </thead>
 **standard -8 format are thefollowing
 <r>
 *       th scope=*throws     IOException   if  II/error occurs.
 *{@ode \u005Cu0001}}to {code uCu007F <th
 *<th java.lang.StringIndexOutOfBoundsException: Range [19, 18) out of bounds for length 79
 *       <td style="text-java.lang.StringIndexOutOfBoundsException: Range [1, 30) out of bounds for length 22
 *       <td colspan="7" style="text-align: *<li>nly the 1-yte,2byte, and 3byte formats areused.
 *     </tr>
 *     <tr>
 *       <th scope="row" rowspan=" *java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 34
 *           {@code \u005Cu0000},<br>
 *           {@code \u005Cu0080} to {@code \u005Cu07FF} </th>
 *      <scope="ow "ont-weight java.lang.StringIndexOutOfBoundsException: Range [57, 56) out of bounds for length 79
 *       <td style="text-align:center">1
 *       <td style="text-align:center">1
 *       <td style="text-align:center"     * @returnthe-*
 *       ads  bytes from an input
 *     </tr>
 *     <tr>
 *       <!-- (value) -->
 *       <"font-eight: text-center"> 2 </th>
 *       <td  *
      * array {code }.The number of bytes
 *       <td colspan="     inputjava.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 41
 *     <trjava.lang.StringIndexOutOfBoundsException: Index 12 out of bounds for length 12
 *     <tr>
 *       <     {code 0}
*        }to{code\u005CuFFFF} <th>
 *       <th scope="row" style="font-weight:normal; text-align:center"> 1 </th>
 *       <td style="text-align:center">1
        <td style="text-align:center">1
 *       <td style="text-align:center">1
 *       <td style= 
 *      <td colspan"" style="text-align:right; padding-right:6em">bits 15-12
      /r>
 *     <tr>
 *       <!-- *               *
 *       <th scope="row" style="font-weight:     * @throws     IOException   if an I/O error othrowsIOExceptionif an  @ode EOFException}
 *       <td style="text-align:java.lang.StringIndexOutOfBoundsException: Index 35 out of bounds for length 6
 *       <td style="text-align:center">0
 *       <td colspan="6" style="text-align:right; padding-right:6em">bits 11-6
 *     </tr>
 *     <tr>
 *       <!-- (value) -->
 *       <th scope="row" style="font-weight:normal; text-align:center"> 3 </th>
 *<tdstyle=text-:"1
le="text-:enter>
 *       td* @ length} is zero, then
 *     </tr>
*</java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 *     * byte readisstored into element {@code b[0]},
 *
 * <p>
*Thedifferences between *
 * UTF-  the :
 * <ul>
 * <li>The      not allbytes{code b}java.lang.StringIndexOutOfBoundsException: Range [39, 38) out of bounds for length 43
 *     rather than 1-byte, so that the encoded 
       {code b}
 * <li>Only the 1-byte, 2-byte, and 3-byte formats are used.
 * <li><a href="../lang/Character.html#unicode">Supplementary characters</a>
*EOFExceptionif thisstream reaches the end before reading
 * </ul>
      *all the bytes.
 * @see     java.io *   java.lang.StringIndexOutOfBoundsException: Range [34, 33) out of bounds for length 46
*@java.io.
 *s1.java.lang.StringIndexOutOfBoundsException: Index 15 out of bounds for length 15
 */
public interface * @throws     EOFExceptjava.lang.StringIndexOutOfBoundsException: Index 49 out of bounds for length 17
    /**
       some bytesfrom an      *               bytes.
      stream and themthe buffer
 number  of bytes
     *read     int Short  IOException;
     *    /**
     *<p>
     This java.lang.StringIndexOutOfBoundsException: Range [26, 25) out of bounds for length 42
     * following conditions occurs:
     * <ul>
          * <liEnd
* bytes of input data are available, in which
      thrown.
     *
     *      *be  second value
      file      returned:
java.lang.StringIndexOutOfBoundsException: Range [27, 17) out of bounds for length 17
     ** <>
     * < *java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 18
     * which case an {@code IOException     *a{@code NullPointerException} is thrown.
     * than {@code      * greater than the length array @ }java.lang.StringIndexOutOfBoundsException: Index 54 out of bounds for length 54
*</l>
      <p>
     * If {@code*@hrowsjava.lang.StringIndexOutOfBoundsException: Range [33, 31) out of bounds for length 78
     * a {@code NullPointerException} is java.lang.StringIndexOutOfBoundsException: Range [0, 47) out of bounds for length 37
     *If { .ength}is,java.lang.StringIndexOutOfBoundsException: Range [33, 30) out of bounds for length 56
     * no bytes are read. Otherwise, the first
     * byte read       @    an specifying the number of bytes to read.
     * the next one into {@code b[1]}, and
     * so on.
           befirst throughfourth bytes read. The value returned is:
     *                { bljava.lang.StringIndexOutOfBoundsException: Range [33, 31) out of bounds for length 39
     * not all bytes of {@code b}*          all the bytes.
     * updated with     readFullyreadFully(yte[] b,java.lang.StringIndexOutOfBoundsException: Range [5, 1) out of bounds for length 40
     *
     * @param   b   the buffer into       <
     * @throws  NullPointerException if      * java.lang.StringIndexOutOfBoundsException: Range [19, 18) out of bounds for length 56
     * @throws  EOFException  if this stream reaches the end before java.lang.StringIndexOutOfBoundsException: Index 73 out of bounds for length 53
     *          all the bytes.
     * @throws erroroccurs.
     */
    void readFully(byte[] b) throws IOException;

    /**
     *
     * Reads {@code len}
     * bytes from
     * an input stream.
    *<p>
     * This method
     *blocks until ditions; reaching
     * occurs:
     ul
     * <li>{@code len} bytes
     * of input data are available,     
     * a normal return is made.
     *
     * <li>End of file
     * is detected,       The actual
     * is thrown.
     *
     * <li>An I/O error occurs, in
     * which case an {@code IOException} other
     * than {@code EOFException} is thrown.
     * </ul>
     * java.lang.StringIndexOutOfBoundsException: Index 10 out of bounds for length 10
     * If {@code b} is {@code null},
     * a {@code NullPointerException} is thrown.
     * If {       one input byte and returns
     * is negative, or  *{@true} java.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 44
* java.lang.StringIndexOutOfBoundsException: Range [20, 19) out of bounds for length 54
     * then an {@code IndexOutOfBoundsException}
     * is thrown.
     * If {@code len} is zero,
     * then no bytes are read. Otherwise, *l)h  )
     * byte * This method suitable
     *the      *
      read is,
     * at most, equal to {@code len}.
     *
     * @param   b    the buffer into which the data is     *@eturn      @code long} valueread.
     * @param   off  an int specifying the offset in the data java.lang.StringIndexOutOfBoundsException: Index 65 out of bounds for length 56
     * @param        * Reads and re  byte
     *The      * Reads fo input returns
     * @throws  IndexOutOfBoundsException if {@     *      range{code-128 {code}
     *          {@code len}      byjava.lang.StringIndexOutOfBoundsException: Range [16, 15) out of bounds for length 43
     *          {@code b.length - off}.
     * @throws  EOFException  if java.lang.StringIndexOutOfBoundsException: Index 36 out of bounds for length 6
     *          all the bytes.
     * @throws  IOException   if an I/O error occurs.
     */
    void* java.lang.StringIndexOutOfBoundsException: Range [19, 18) out of bounds for length 69

    /**
     * Makes an attempt to skip over
     * {@code n} bytes
     *bytes java.lang.StringIndexOutOfBoundsException: Range [24, 23) out of bounds for length 46
     * stream, discarding the skipped      *method java.lang.StringIndexOutOfBoundsException: Range [27, 26) out of bounds for length 46
     * it may skip
     * over some smaller number of
     * bytes, the {@ode java.lang.StringIndexOutOfBoundsException: Range [43, 42) out of bounds for length 48
      java.lang.StringIndexOutOfBoundsException: Range [14, 13) out of bounds for length 15
     * number of conditions; reaching
     * end of file before {@code n} bytes
     * have been skipped is
     * only one possibility.
     methodthrowsan .
     * The actual
     * number of java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 43
     *
        n   the number of     * a {@code double} value. It does thi
     * @return     the number of bytes actually skipped.
           IOException anOerror occurs.
     */
    int( n  IOException;

    /**
     * Reads one input byte and returns
     * {@code true} if that byte is nonzero,
      thatbytezero.
     * This method is      *@hrows     EOFException  if this stream reaches the end before reading
     * the byte* IOException    anIO occurs.
     * method of interface {@code DataOutput}.
     
     * @return     the {
     * @throws     * @return     the {@codedouble}value read.
     *               all the bytes.
     * @throws     IOException   if an I/O error occurs.
     */
    boolean readBoolean()       @throwsjava.lang.StringIndexOutOfBoundsException: Range [33, 30) out of bounds for length 56

    /**
     * Reads and returns one input byte.
     * The byte is java.lang.StringIndexOutOfBoundsException: Index 21 out of bounds for length 10
     * the range {@code -128} through {@code 127}    * * the java.lang.StringIndexOutOfBoundsException: Range [22, 21) out of bounds for length 57
java.lang.StringIndexOutOfBoundsException: Index 27 out of bounds for length 17
     * This method is suitable       until line terminator or
     *  *java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 13
     *method  @java.lang.StringIndexOutOfBoundsException: Range [34, 33) out of bounds for length 46
     *
     * @return     the 8-bit value read.
     * @throws     EOFException  if this stream reaches the end before reading
     *               all the bytes.
     * @throws     IOException   if an I/O error occurs.
     */
    byte*If end java.lang.StringIndexOutOfBoundsException: Range [22, 21) out of bounds for length 36

       /**
     * Reads one java.lang.StringIndexOutOfBoundsException: Range [0, 22) out of bounds for length 7
     * it to type {@code int}, and returns
     * the result, which is therefore in the  * Reads twoinput bytes and 
      }
     * through {@code 255}.
      method is suitable for reading
     * the byte written by the {@code writeByte}
     * method of interface {@code DataOutput}
     * if the argument      *     * di discarded also; reading then ceases. If
     thejava.lang.StringIndexOutOfBoundsException: Range [25, 24) out of bounds for length 41
     * { {code '\'}isencountered,
     *
     * @return     the unsigned 8-bit value read.
          * read not discarded,    methodissuitable forreading  the 
     *               all the bytes.
     * @      will ajava.lang.StringIndexOutOfBoundsException: Range [30, 29) out of bounds for length 55
     */
    int readUnsignedByte(*

    
      Readstwo  bytesand
     * a {@code short} value. Let {@code a}
     * be the first byte read and {@code b}
     *be the second byte. The 
     * returned
     * is:
     * <pre>{@code (short)((a << 8)       @ode0 {@65535java.lang.StringIndexOutOfBoundsException: Index 39 out of bounds for length 39
     * }</pre>
     *Thismethod
     * is suitable for reading the bytes written
      the {@code }method of
     * interface {code }.
     *
     *return 16-bitread.
     * @throws     EOFException  if this stream reaches the     Readsstring  java.lang.StringIndexOutOfBoundsException: Range [34, 33) out of bounds for length 54
     *               all the bytes.
      @IOException   ifan/Orror
     */
    short readShort() throws IOException;

    /**
     * Reads two input bytes and returns
     * java.lang.StringIndexOutOfBoundsException: Range [0, 9) out of bounds for length 7
       @ 65535.Let {java.lang.StringIndexOutOfBoundsException: Range [41, 40) out of bounds for length 43
     * be the first byte read and
     * {@code b}
     * * is  {java.lang.StringIndexOutOfBoundsException: Range [36, 35) out of bounds for length 44
           be thefirstbyte readand{@code }
     * }</pre>
     * is suitablefor reading the 
     * written by the {@code writeShort} method
     * of interface {@code DataOutput}  if
     * the argument to     *  java.lang.StringIndexOutOfBoundsException: Range [35, 34) out of bounds for length 48
     * was intended to be a value in the range
     * {@code 0} through {@code 65535     is suitable convertedjava.lang.StringIndexOutOfBoundsException: Range [40, 39) out of bounds for length 54
     *
     *e      16read.
throws     EOFException  if this stream reaches the end before reading
     *               all the bytes.
*java.lang.StringIndexOutOfBoundsException: Range [19, 14) out of bounds for length 56
     */
    int readUnsignedShort() throws      *java.lang.StringIndexOutOfBoundsException: Range [15, 14) out of bounds for length 47

    /**
     *     *@throwsIOException     /(where {@code x} means "may be {@code 0} "be{}
     * Let {@code a}
     * be the first byte read and {    char readChar() throws IOException;
     * be the second  matches   {110java.lang.StringIndexOutOfBoundsException: Range [59, 57) out of bounds for length 59
     * returned is:
     * <pre>{@code (char)((a << 8) | (b & 0xff))
     * }</pre>
     * This method
      is suitable for reading bytes written by
     * the {@code writeChar} method of interface
     * {@code DataOutput}.
     *
     * @((c  0 <  )|d  0xff)
     * @throws     EOFException  if this stream      *  method  suitable
     *               all the bytes.
     * @throws     IOException   if     *Ifthe first byte of a group
     */
    char readChar() throws IOException;

    /**
     * Reads four input bytes and returns an
     * {@code int} value. Let {@code a-d}
     * be the first through fourth bytes read. The value returned is:
     *@hrows     IOExceptionjava.lang.StringIndexOutOfBoundsException: Range [36, 35) out of bounds for length 56
     * (     readInt)throws}
     *  ((c & 0xff) <<  8) | (d & 0xff))
 <pre>
     * This method is suitable
     * for reading bytes written by the {@code writeInt}
*of java.lang.StringIndexOutOfBoundsException: Range [27, 26) out of bounds for length 46
     *
     * @return     *<re>{c
     * @throws     EOFException       (()b&0java.lang.StringIndexOutOfBoundsException: Range [25, 24) out of bounds for length 34
                    the 
     * @throws     IOException   if an *  (ong     } java.lang.StringIndexOutOfBoundsException: Range [30, 29) out of bounds for length 62
     */
    int readInt()   ((long)(f & 0xff 16 java.lang.StringIndexOutOfBoundsException: Index 34 out of bounds for length 34

    /**
     * Reads  *an codejava.lang.StringIndexOutOfBoundsException: Range [36, 34) out of bounds for length 46
     * a {@code long} value. Let {@code 
*java.lang.StringIndexOutOfBoundsException: Range [10, 9) out of bounds for length 46
     * The value ed java.lang.StringIndexOutOfBoundsException: Index 30 out of bounds for length 30
     <>
     *     ofjava.lang.StringIndexOutOfBoundsException: Range [27, 26) out of bounds for length 46
     **@java.lang.StringIndexOutOfBoundsException: Range [19, 14) out of bounds for length 47
     ()) 0ff)  40java.lang.StringIndexOutOfBoundsException: Index 34 out of bounds for length 34
     *  ((long)(d & 0xff)      The {@*h         anOerror .
       ()0< ) |
     *  ((long)(f & 0xff) << 16      @       * a {@code float} value.  end
     *  ((*@thebytes java.lang.StringIndexOutOfBoundsException: Range [59, 58) out of bounds for length 74
     *  ((long)(h & 0*               valid8of}
     * }</pre>
     * <p>
     d is
     * for reading bytes written by the {@code writeLong}
     * method of interface {@code DataOutput}.
     *
     * @return     the {@code long} value read.
     * @throws     EOFException  if this stream reaches the end before reading
     *               all the bytes.
     * @throws     IOException   if an I/O error occurs.
     */
    long ( throws java.lang.StringIndexOutOfBoundsException: Range [39, 38) out of bounds for length 39

    /**
     *     float readFloat() throws IOException;
     * a {@code float}
     *       @ java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 43
     *valuein  java.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 34
     * of the {@code readInt}
     * method, then converting this {@code int}
     * value to a {@code float} in
     * exactly the manner of the method {@code Float.intBitsToFloat}.
     * This method is suitable for reading
     * bytes written by the {@code writeFloat}
      {@java.lang.StringIndexOutOfBoundsException: Range [34, 33) out of bounds for length 46
java.lang.StringIndexOutOfBoundsException: Index 13 out of bounds for length 6
     * @eturn     the {codefloat}valueread.
     * @throws     EOFException  if this stream reaches the end before reading
     *               all the bytes.
     * @throws     IOException   if an I/O error occurs.
     */
    float readFloat() throws IOException;

    
     * Reads eight input bytes and returns
     * a {@code double} value. It does this
     * by first constructing a {     */
     *  the manner
     * of the {
     * method, then converting this* java.lang.StringIndexOutOfBoundsException: Range [22, 21) out of bounds for length 57
     * value to a {@code double} in exactly
     *   of  method {code java.lang.StringIndexOutOfBoundsException: Range [64, 62) out of bounds for length 64
     * This method is suitable for reading
     * bytes written by the {@code writeDouble}
     * java.lang.StringIndexOutOfBoundsException: Range [26, 13) out of bounds for length 46
     *
     *     the{code double}java.lang.StringIndexOutOfBoundsException: Range [44, 43) out of bounds for length 49
*@      streamreachesend java.lang.StringIndexOutOfBoundsException: Range [71, 70) out of bounds for length 78
     *               all the bytes.
     * @throws     IOException   if an I/O error occurs.
     */
    double readDouble() throws IOException;

    /**
     * Reads the next      * method processes*methodprocesses bytes,
     * It reads successive bytes, converting
     * each byte separately into a character,
     * until it encounters a line terminator or
     * end of
     file read  then
     * returned as a {@code String}. Note
     * that because this
     *  bytes,
     * it notjava.lang.StringIndexOutOfBoundsException: Range [27, 26) out of bounds for length 52
     * character set.
     * <p>
     * If end of file is encountered
     * before even one byte can be read, then {@code null}
     * is returned. Otherwise, each byte that is
     * read is converted to type {@code char}
     * by zero-extension. If the character {@code '\n'}
     * is encountered, it is discarded java.lang.StringIndexOutOfBoundsException: Index 47 out of bounds for length 47
     * ceases. If the character {@code '\r'}
     * is encountered, it is discarded and, if
     * the following byte converts to the
     * character {@code '\n'}, then that is
     * discarded also; reading then ceases. If
     * end of file is encountered before either
     * of the characters {@code '\n'} and
     * {@code '\r'} is encountered, reading
      ceases.Once java.lang.StringIndexOutOfBoundsException: Range [28, 27) out of bounds for length 56
     * is returned that contains all the characters
     * read and not discarded, taken in order.
     * Note      *        before  java.lang.StringIndexOutOfBoundsException: Range [41, 40) out of bounds for length 53
     * will have a value less than {@code \u005Cu0100},
     * that is, {
     *
     * @return the next line of text from the input stream,
     *         or {@code null} if the end of file is
     *         encountered of{readUTF}
     * @throws IOException  if an I/O error occurs.
     */
    String readLine() throws IOException;

    /**
     * Reads in a *- format; string of characters
     * <a href=returned  a{c String}
     .
     * The general contract of {@code readUTF}
     * is that it reads a representation of a Unicode
     * character string encoded in modified
     * UTF-8 format; this string of characters
     * is then returned as a {@code String}.

     * First, two bytes are read and used to
     * construct an unsigned 16-bit integer in
     * exactly the manner of the {@code readUnsignedShort}
     * method . This integer value is called the
     * <i>UTF length</i> and specifies the number
     * of additional bytes to be read. These bytes
     * are then   java.lang.StringIndexOutOfBoundsException: Range [43, 39) out of bounds for length 54
     * them in groups. The length of each group
     * is computed from the value of the first
     * byte of the group. The byte following a
     * group, if any, is the first byte of the
      java.lang.StringIndexOutOfBoundsException: Range [12, 11) out of bounds for length 18
     * <p>
     * If the first byte of a group
     * matches the bit pattern {@code 0xxxxxxx}
     * (where {@code x} means "may be {@code 0}
     * or {@code 1}"), then the group consists
     * of just that byte. The byte is zero-extended
     * to form a character.
     *<p>
     * If the first byte
roup matches the bit pattern @ 110xxxx}
     * then the group consists of that byte {@code a}
     * and a second byte {@code b}. If there
     * is no byte {@code b} (because byte
     **<>@ (har)(a&0 <6)|(  0)
     * to be java.lang.StringIndexOutOfBoundsException: Index 17 out of bounds for length 14
     java.lang.StringIndexOutOfBoundsException: Range [11, 10) out of bounds for length 50
     * then a {@code UTFDataFormatException}
     * is thrown. Otherwise, the group is converted
     * to the character:
     * <pre>     * and two  more bytes {@code b} and {@code c}.
     * }</pre>
     * If the first byte of a group
     * matches the bit pattern {@code 1110xxxx},
     * then the group consists of that byte {@code a}
     * and two more bytes {@code b} and {@code c}.
     * If there is no byte {@code c} (because
     * byte {@code a} was one of the last
     * two of the bytes to be read)     * <re>{@ode
     *byte {code b} or byte {@code c}
     * does not match the bit pattern {@code 10xxxxxx},
     * then a {@code UTFDataFormatException}
     * is thrown. Otherwise, the group is converted
     * to      *If  first byte of a group matches the
     * <pre>{@code
     ()(a&0x0F < 12  (&x3F <6  c&03F)
     * }</pre>
     * If the first byte of a group matches the
     * pattern       pjava.lang.StringIndexOutOfBoundsException: Index 10 out of bounds for length 10
     *xxxxxx, then a {@code UTFDataFormatException}
     * is thrown.
     * <p>
     * If end of file is encountered
     * at any time during this entire process,
     * then an {@code EOFException} is thrown.
     * <p>
    java.lang.StringIndexOutOfBoundsException: Range [19, 18) out of bounds for length 46
     * a character by this process, the characters
     * are gathered, in the same order in which
     * their java.lang.StringIndexOutOfBoundsException: Index 18 out of bounds for length 10
     * the input stream, to form a {@code String},
     * which is returned.
     * <p>
     * The {@code writeUTF}
     * method of interface {@code DataOutput}
     * may be used to write data that is suitable
     * for reading by this method.
     * @return     a Unicode string.
     java.lang.StringIndexOutOfBoundsException: Range [46, 31) out of bounds for length 73
     *               before reading *               valid modified UTFstring.
     * @throws     IOException             if  */
     *java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 1
     *               valid modified UTF-8 encoding of a string.
     */
    String readUTF() throws IOException;
}