Java DoubleBuffer wrap()方法及示例

wrap(double[] array)

java.nio.DoubleBuff er类的 wrap() 方法用于将一个双数组包裹成一个缓冲区。新的缓冲区将以给定的双数组为后盾；也就是说，对缓冲区的修改将导致数组的修改，反之亦然。新的缓冲区的容量和限制将是array.length，它的位置将是0，它的标记将是未定义的。它的支持数组将是给定的数组，它的数组偏移将是零。

语法

public static DoubleBuffer wrap(double[] array)

参数： 该方法以数组作为参数，该数组将支持这个缓冲区。

返回值： 该方法返回 新的DoubleBuffer 。

下面的例子说明了wrap()方法。

// Java program to demonstrate
// wrap() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // Declaire and initialize the float array
        double[] fbb = { 1.23D, 2.34D, 4.56D };
  
        // print the float array length
        System.out.println("Array length : " + fbb.length);
  
        // print the float array element
        System.out.println("\nArray element : "
                           + Arrays.toString(fbb));
  
        // wrap the float array into floatBuffer
        // using wrap() method
        DoubleBuffer doubleBuffer = DoubleBuffer.wrap(fbb);
  
        // Rewind the floatbuffer
        doubleBuffer.rewind();
  
        // print the float buffer
        System.out.println("\ndoubleBuffer : "
                           + Arrays.toString(doubleBuffer.array()));
  
        // print the DoubleBuffer capacity
        System.out.println("\ndoublebuffer capacity : "
                           + doubleBuffer.capacity());
  
        // print the DoubleBuffer position
        System.out.println("\ndoublebuffer position:  "
                           + doubleBuffer.position());
    }
}

输出:

Array length : 3

Array element : [1.23, 2.34, 4.56]

doubleBuffer : [1.23, 2.34, 4.56]

doublebuffer capacity : 3

doublebuffer position:  0

wrap(double[] array, int offset, int length)

新的缓冲区将由给定的双数组支持；也就是说，对缓冲区的修改将导致数组被修改，反之亦然。新的缓冲区的容量是array.length，它的位置是offset，它的极限是offset + length，它的标记是未定义。它的支持数组将是给定的数组，它的数组偏移将是0。

语法

public static FloatBuffer wrap (double[] array, int offset, int length)

参数： 该方法需要以下参数。

array: 将支持新缓冲区的数组。
offset: 要使用的子数组的偏移量；必须是非负数，并且不大于array.length。新缓冲区的位置将被设置为这个值。
length: 要使用的子数组的长度；必须是非负数，并且不大于array.length – offset。新缓冲区的极限将被设置为offset + length。

返回值： 该方法返回 新的DoubleBuffer 。

异常： 如果offset和length参数的前提条件不成立，该方法会抛出 IndexOutOfBoundsException 。

下面是说明wrap()方法的例子。

例子 1 :

// Java program to demonstrate
// wrap() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
  
    public static void main(String[] args)
    {
  
        // Declare and initialize the float array
        double[] fbb = { 1.23D, 2.34D, 4.56D };
  
        // print the float array length
        System.out.println("Array length : " + fbb.length);
  
        // print the float array element
        System.out.println("\nArray element : "
                           + Arrays.toString(fbb));
  
        // wrap the double array into floatBuffer
        // using wrap() method
        DoubleBuffer doubleBuffer = DoubleBuffer.wrap(fbb, 0,
                                                      fbb.length);
  
        // Rewind the doublebuffer
        doubleBuffer.rewind();
  
        // print the float buffer
        System.out.println("\ndoubleBuffer : "
                           + Arrays.toString(doubleBuffer.array()));
  
        // print the FloatBuffer capacity
        System.out.println("\ndoublebuffer capacity : "
                           + doubleBuffer.capacity());
  
        // print the FloatBuffer position
        System.out.println("\ndoublebuffer position:  "
                           + doubleBuffer.position());
    }
}

输出:

Array length : 3

Array element : [1.23, 2.34, 4.56]

doubleBuffer : [1.23, 2.34, 4.56]

doublebuffer capacity : 3

doublebuffer position:  0

实例2： 演示IndexOutOfBoundsException

// Java program to demonstrate
// asReadOnlyBuffer() method
  
import java.nio.*;
import java.util.*;
  
public class GFG {
  
    public static void main(String[] args)
    {
  
        // Declare and initialize the Double array
        double[] fbb = { 1.23D, 2.34D, 4.56D };
  
        // print the Double array length
        System.out.println("Array length : " + fbb.length);
  
        // print the Double array element
        System.out.println("\nArray element : " + Arrays.toString(fbb));
  
        try {
            // wrap the Double array into floatBuffer
            // using wrap() method
            System.out.println("\nHere "
                               + "offset and length does not hold"
                               + " the required condition ");
            DoubleBuffer doubleBuffer = DoubleBuffer.wrap(fbb,
                                                          1,
                                                          fbb.length);
  
            // Rewind the Doublebuffer
            doubleBuffer.rewind();
  
            // print the Double buffer
            System.out.println("\ndoubleBuffer : "
                               + Arrays.toString(doubleBuffer.array()));
  
            // print the DoubleBuffer capacity
            System.out.println("\ndoublebuffer capacity : "
                               + doubleBuffer.capacity());
  
            // print the DoubleBuffer position
            System.out.println("\ndoublebuffer position:  "
                               + doubleBuffer.position());
        }
        catch (IndexOutOfBoundsException e) {
            System.out.println("Exception throws:  " + e);
        }
    }
}

输出:

Array length : 3

Array element : [1.23, 2.34, 4.56]

Here offset and length does not hold the required condition 
Exception throws:  java.lang.IndexOutOfBoundsException