Class COM.odi.jcpp.unsigned_charPU

java.lang.Object
   |
   +----COM.odi.jcpp.unsigned_charPU

public class unsigned_charPU
extends Object

The unsigned_charPU class is the unsafe counterpart class for the unsigned_charP class. The unsigned_charPU class contains static methods for unsafe operations on instances of the associated peer class, unsigned_charP. Unsafe operations include operations such as array access and casting.

cast(PeerPointer): Creates an unsigned_charP object and uses the same linear object reference (linear address) as the specified peer pointer object.
deleteArray(unsigned_charP): Deallocates a C++ array that contains elements of type unsigned char.
makeArray(Segment, int): Creates a C++ array in which the type of the elements is unsigned char.
ref(unsigned_charP, int): Returns a particular element from the specified C++ array.
set(unsigned_charP, int, char): Sets the array element in the specified position to the specified value.

makeArray

  public static unsigned_charP makeArray(Segment s,
                                         int size)

Creates a C++ array in which the type of the elements is unsigned char. ObjectStore places the array in the specified segment and creates the specified number of elements.

Parameters:: s - The segment in which to allocate the array.; size - The number of elements in the array.
Returns:: An unsigned_charP object whose linear address refers to the newly created object.

deleteArray

  public static void deleteArray(unsigned_charP theArray)

Deallocates a C++ array that contains elements of type unsigned char.

Parameters:: theArray - The C++ array you want to delete.

ref

  public static char ref(unsigned_charP theArray,
                         int index)

Returns a particular element from the specified C++ array.

Parameters:: theArray - The array that contains the element you want.; index - The position of the desired element in the array. Postions begin at 0. If you want the third element, specify 2.
Returns:: The element at the specified position.

set

  public static void set(unsigned_charP theArray,
                         int index,
                         char newValue)

Sets the array element in the specified position to the specified value.

Parameters:: theArray - The array that contains the element for which you want to specify a value.; index - The position of the element in the array.; newValue - The value for the element in the specified position.

cast

  public static unsigned_charP cast(PeerPointer p)

Creates an unsigned_charP object and uses the same linear object reference (linear address) as the specified peer pointer object. Typically, this is useful when you have a return value of type voidP and you know it should be of type unsigned_charP.

Parameters:: p - The peer pointer object whose linear address you want to copy.
Returns:: The newly created unsigned_charP object.