javax.realtime.device

Interface RawShortWriter

All Superinterfaces:

RawMemory

All Known Subinterfaces:

RawShort

public interface RawShortWriter
extends RawMemory

A marker for a short accessor object encapsulating the protocol for writing shorts to raw memory. A short accessor can always access at least one short. Each short is transferred in a single atomic operation. Groups of shorts may be transferred together; however, this is not required.

Objects of this type are created with the method RawMemoryFactory.createRawShortWriter(javax.realtime.device.RawMemoryRegion, long, int, int) and RawMemoryFactory.createRawShort(javax.realtime.device.RawMemoryRegion, long, int, int). Each object references a range of elements in the RawMemoryRegion starting at the base address provided to the factory method. The size provided to the factory method determines the number of elements accessible.

Caching of the memory access is controlled by the factory that created this object. If the memory is not cached, this method guarantees serialized access. In other words, the memory access at the memory occurs in the same order as in the program. Multiple writes to the same location may not be coalesced.

Since:

RTSJ 2.0

Method Summary

Modifier and Type	Method and Description
int	set(int offset, short[] values) Copies from values to the memory region, from index start to elements where the nth element is at the address base address + (offset + n) × stride × element size in bytes.
int	set(int offset, short[] values, int start, int count) Copies values to the memory region, where offset is first short in the memory region to write and start is the first index in values from which to read.
void	setShort(int offset, short value) Sets the value of the nth element referenced by this instance, where n is offset and the address is base address + offset × size of Short.
void	setShort(short value) Sets the value at the first position referenced by this instance, i.e., the value at its start address.

Methods inherited from interface javax.realtime.device.RawMemory

getAddress, getSize, getStride

Method Detail

setShort

void setShort(short value)

Sets the value at the first position referenced by this instance, i.e., the value at its start address. This operation must be atomic with respect to all other raw memory accesses to the address.

Parameters:

value - The new value for the element.

setShort

void setShort(int offset,
              short value)
       throws OffsetOutOfBoundsException

Sets the value of the n^th element referenced by this instance, where n is offset and the address is base address + offset × size of Short. This operation must be atomic with respect to all other raw memory accesses to the address. When an exception is thrown, no data is transferred.

Parameters:

offset - of short in the memory region.

value - The new value for the element.

Throws:

OffsetOutOfBoundsException - when offset is negative or greater than or equal to the number of elements in the raw memory region.

set

int set(int offset,
        short[] values)
 throws OffsetOutOfBoundsException,
        java.lang.NullPointerException

Copies from values to the memory region, from index start to elements where the n^th element is at the address base address + (offset + n) × stride × element size in bytes. Only the shorts in the intersection of values and the end of the memory region are transferred. When an exception is thrown, no data is transferred.

Parameters:

offset - of first short in the memory region to be set.

values - The source of the data to write.

Returns:

the number of elements actually transferred to values.

Throws:

OffsetOutOfBoundsException - when offset is negative or greater than or equal to the number of elements in the raw memory region.

java.lang.NullPointerException - when values is null.

set

int set(int offset,
        short[] values,
        int start,
        int count)
 throws OffsetOutOfBoundsException,
        java.lang.ArrayIndexOutOfBoundsException,
        java.lang.IllegalArgumentException,
        java.lang.NullPointerException

Copies values to the memory region, where offset is first short in the memory region to write and start is the first index in values from which to read. The number of bytes transferred is the minimum of count, the size of the memory region minus offset, and length of values minus start. When an exception is thrown, no data is transferred.

Parameters:

offset - of the first short in the memory region to set.

values - The array from which to retrieve the shorts.

start - The first index in array to copy.

count - The maximum number of shorts to copy.

Returns:

the number of shorts actually transferred.

Throws:

OffsetOutOfBoundsException - when offset is negative or either offset or offset + count is greater than or equal to the size of this raw memory area.

java.lang.ArrayIndexOutOfBoundsException - when start is negative or either start or start + count is greater than or equal to the size of values.

java.lang.NullPointerException - when values is null.

java.lang.IllegalArgumentException