com.bugvm.rt.bro.ptr.DoublePtr Maven / Gradle / Ivy
/*
* Copyright (C) 2012 RoboVM AB
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.bugvm.rt.bro.ptr;
import java.nio.ByteOrder;
import java.nio.DoubleBuffer;
import com.bugvm.rt.bro.Struct;
import com.bugvm.rt.bro.annotation.StructMember;
/**
* Points to a double value (double * in C).
*/
public final class DoublePtr extends Struct {
/**
* Pointer to {@link DoublePtr} (double ** in C)
*/
public static class DoublePtrPtr extends com.bugvm.rt.bro.ptr.Ptr {}
/**
* Creates a new {@link DoublePtr} with a value of 0.0.
*/
public DoublePtr() {
}
/**
* Creates a new {@link DoublePtr} and initializes it with the specified value.
*
* @param value the value.
*/
public DoublePtr(double value) {
set(value);
}
/**
* Returns the current value.
*
* @return the value.
*/
@StructMember(0)
public native double get();
/**
* Sets the value.
*
* @param value the new value.
*/
@StructMember(0)
public native void set(double value);
/**
* Returns a {@link DoubleBuffer} which reads and writes to the same memory
* location pointed to by this {@link DoublePtr}.
*
* @param n the maximum number of doubles the {@link DoubleBuffer} can
* read/write. This will be the {@link DoubleBuffer}'s
* capacity.
* @return the {@link DoubleBuffer}.
*/
public DoubleBuffer asDoubleBuffer(int n) {
return as(BytePtr.class).asByteBuffer(n << 3).order(ByteOrder.nativeOrder()).asDoubleBuffer();
}
/**
* Copies {@code n} doubles from the memory pointed to by this {@link DoublePtr}
* to a new {@code double[]} instance.
*
* @param n the number of doubles to copy.
* @return the {@code double[]}.
*/
public double[] toDoubleArray(int n) {
double[] result = new double[n];
get(result);
return result;
}
/**
* Copies {@code dst.length} doubles from the memory pointed to by this
* {@link DoublePtr} to {@code dst}.
*
* @param dst the destination.
*/
public void get(double[] dst) {
get(dst, 0, dst.length);
}
/**
* Copies {@code count} doubles from the memory pointed to by this
* {@link DoublePtr} to {@code dst} starting at offset {@code offset}.
*
* @param dst the destination.
* @param offset the offset within the destination array to start copying to.
* @param count the number of elements to copy.
*/
public void get(double[] dst, int offset, int count) {
asDoubleBuffer(count).get(dst, offset, count);
}
/**
* Copies {@code src.length} doubles from {@code src} to the memory pointed to by
* this {@link DoublePtr}.
*
* @param src the source.
*/
public void set(double[] src) {
set(src, 0, src.length);
}
/**
* Copies {@code count} doubles from {@code src} starting at offset {@code offset}
* to the memory pointed to by this {@link DoublePtr}.
*
* @param src the source.
* @param offset the offset within the source array to start copying from.
* @param count the number of elements to copy.
*/
public void set(double[] src, int offset, int count) {
asDoubleBuffer(count).put(src, offset, count);
}
}