CoinArrayWithLength

Pointer with length in bytes.

Derived classes: CoinArbitraryArrayWithLength, CoinBigIndexArrayWithLength, CoinDoubleArrayWithLength, CoinFactorizationDoubleArrayWithLength, CoinFactorizationLongDoubleArrayWithLength, CoinIntArrayWithLength, CoinUnsignedIntArrayWithLength, CoinVoidStarArrayWithLength

Description

This has a pointer to an array and the number of bytes in array. If number of bytes==-1 then CoinConditionalNew deletes existing pointer and returns new pointer of correct size (and number bytes still -1). CoinConditionalDelete deletes existing pointer and NULLs it. So behavior is as normal (apart from New deleting pointer which will have no effect with good coding practices. If number of bytes >=0 then CoinConditionalNew just returns existing pointer if array big enough otherwise deletes existing pointer, allocates array with spare 1%+64 bytes and updates number of bytes CoinConditionalDelete sets number of bytes = -size-2 and then array returns NULL

Public Methods

`getSize`

Get the size.

CoinBigIndex getSize()

`rawSize`

Get the size.

CoinBigIndex rawSize()

`switchedOn`

See if persistence already on.

bool switchedOn()

`capacity`

Get the capacity (just read it)

CoinBigIndex capacity()

`setCapacity`

Set the capacity to >=0 if <=-2.

void setCapacity()

`array`

Get Array.

const char * array()

`setSize`

Set the size.

void setSize(CoinByteArray value)

Parameters:

value (CoinByteArray)

`switchOff`

Set the size to -1.

void switchOff()

`switchOn`

Set the size to -2 and alignment.

void switchOn(int alignment = 3)

Parameters:

alignment (int)

`setPersistence`

Does what is needed to set persistence.

void setPersistence(int flag, CoinByteArray currentLength)

Parameters:

flag (int)
currentLength (CoinByteArray)

`clear`

Zero out array.

void clear()

`swap`

Swaps memory between two members.

void swap(CoinArrayWithLength & other)

Parameters:

other (CoinArrayWithLength &)

`extend`

Extend a persistent array keeping data (size in bytes)

void extend(CoinByteArray newSize)

Parameters:

newSize (CoinByteArray)

`conditionalNew`

Conditionally gets new array.

char * conditionalNew(CoinByteArray sizeWanted)

Parameters:

sizeWanted (CoinByteArray)

`conditionalDelete`

Conditionally deletes.

void conditionalDelete()