src/java.base/share/classes/java/nio/X-Buffer.java.template

*** 545,554 ****
--- 545,594 ----
       */
      @Override
      public abstract $Type$Buffer slice();
  
      /**
+      * Creates a new $type$ buffer whose content is a shared subsequence of
+      * this buffer's content.
+      *
+      * <p> The new buffer will start at position {@code index} in this buffer
+      * and will contain {@code length} elements. Changes to this buffer's
+      * content will be visible in the new buffer, and vice versa; the two
+      * buffers' position, limit, and mark values will be independent.
+      *
+      * <p> The new buffer's position will be zero, its capacity and its limit
+      * will be {@code length}, its mark will be undefined, and its byte order
+      * will be
+ #if[byte]
+      * {@link ByteOrder#BIG_ENDIAN BIG_ENDIAN}.
+ #else[byte]
+      * identical to that of this buffer.
+ #end[byte]
+      * The new buffer will be direct if, and only if, this buffer is direct,
+      * and it will be read-only if, and only if, this buffer is read-only. </p>
+      *
+      * @param   index
+      *          The position in this buffer at which the content of the new
+      *          buffer will start; must be non-negative and less than
+      *          {@link #limit() limit()}
+      *
+      * @param   length
+      *          The number of elements the new buffer will contain; must be
+      *          non-negative and no larger than {@code limit() - index}
+      *
+      * @return  The new buffer
+      *
+      * @throws  IndexOutOfBoundsException
+      *          If {@code index} is negative or not less than {@code limit()},
+      *          {@code length} is negative, or {@code length > limit() - index}
+      *
+      * @since 13
+      */
+     @Override
+     public abstract $Type$Buffer slice(int index, int length);
+ 
+     /**
       * Creates a new $type$ buffer that shares this buffer's content.
       *
       * <p> The content of the new buffer will be that of this buffer.  Changes
       * to this buffer's content will be visible in the new buffer, and vice
       * versa; the two buffers' position, limit, and mark values will be
*** 1948,1962 ****
  
          if (aligned_pos > lim || aligned_lim < pos) {
              aligned_pos = aligned_lim = pos;
          }
  
!         return slice(aligned_pos, aligned_lim);
      }
  
-     abstract ByteBuffer slice(int pos, int lim);
- 
      // #BIN
      //
      // Binary-data access methods  for short, char, int, long, float,
      // and double will be inserted here
  
--- 1988,2000 ----
  
          if (aligned_pos > lim || aligned_lim < pos) {
              aligned_pos = aligned_lim = pos;
          }
  
!         return slice(aligned_pos, aligned_lim - aligned_pos);
      }
  
      // #BIN
      //
      // Binary-data access methods  for short, char, int, long, float,
      // and double will be inserted here