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

confusing documentation for subList()

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P4 P4
    • 1.4.0
    • 1.2.0
    • docs
    • beta
    • generic
    • generic
    • Not verified



      Name: vi73552 Date: 05/14/99


      > The documentation for subList() has two contradictory paragraphs:
      >
      > >Returns a view of the portion of this list between the specified fromIndex,
      > >inclusive, and toIndex, exclusive. (If fromIndex and toIndex are equal, the
      > > returned list is empty.) The returned list is backed by this list, so
      > >changes in the returned list are reflected in this list, and vice-versa.
      > >
      > > The semantics of this list returned by this method become undefined if
      > >the backing list (i.e., this list) is structurally modified in any way other
      > >than via the
      > > returned list. (Structural modifications are those that change the size
      > >of this list, or otherwise perturb it in such a fashion that iterations in
      > >progress may yield
      > > incorrect results.)
      >
      > The vice-versa in the first paragraph should be removed.
      >
      > Jon Bright
      (Review ID: 63217)
      ======================================================================

            jhosunw Jamie Ho (Inactive)
            vasya Vassili Igouchkine (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: