Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4400854

ambiguities in the API documentation for DataInput for method skipBytes

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Duplicate
    • Icon: P3 P3
    • None
    • 1.3.0
    • docs
    • generic
    • generic



      Name: boT120536 Date: 12/27/2000


      java version "1.3.0"
      Java(TM) 2 RuntimeEnvironment, Standard Edition (build 1.3.0-C)
      Java HotSpot(TM) Client VM (build 1.3.0-C, mixed mode)

      <<<<" public int skipBytes(int n) throws IOException
       Makes an attempt to skip over n bytes of data from the input stream,
       discarding the skipped bytes. However, it may skip over some smaller number
       of bytes, possibly zero. This may result from any of a number of conditions;
       reaching end of file before n bytes have been skipped is only one
       possibility. This method never throws an EOFException(*). The actual number
       of bytes skipped is returned. Parameters:
       n - the number of bytes to be skipped.
       Returns:
       the number of bytes skipped, which is always n(**).
       Throws:
       EOFException - if this stream reaches the end before skipping all the bytes.
      ">>>>
      ==> It is not clear from this whether it returns EOFException or not?
      ==> what is the integer value returned - always the requested number, or the
       actual number?

       2) I found the following numbering mixup in the documentation guide for
       Object Serialization for jdk1.3 (Java Object Serialization Specification -
       Section

      <<<<"If the replacement object is not one of the types covered by Steps 3
       through 7, processing resumes using the replacement object at Step 10.">>>>
      ==> There is no Step 10 in the document. After Step 8, it starts again at Step
      1.
      (Review ID: 113688)
      ======================================================================

            shommel Scott Hommel (Inactive)
            bonealsunw Bret O'neal (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: