|
Java Card 2.1 Platform Final Revision 1.0 |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javacard.framework.Util
The Util
class contains common utility functions.
Some of the methods may be implemented as native functions for
performance reasons.
All methods in Util
, class are static methods.
Some methods of Util
namely arrayCopy()
, arrayCopyNonAtomic()
,
arrayFillNonAtomic()
and setShort()
, refer to the persistence of
array objects. The term persistent means that arrays and their values persist from
one CAD session to the next, indefinitely.
The JCSystem
class is used to control the persistence and transience of objects.
JCSystem
Method Summary | |
static byte |
arrayCompare(byte[] src,
short srcOff,
byte[] dest,
short destOff,
short length)
Compares an array from the specified source array, beginning at the specified position, with the specified position of the destination array from left to right. |
static short |
arrayCopy(byte[] src,
short srcOff,
byte[] dest,
short destOff,
short length)
Copies an array from the specified source array, beginning at the specified position, to the specified position of the destination array. |
static short |
arrayCopyNonAtomic(byte[] src,
short srcOff,
byte[] dest,
short destOff,
short length)
Copies an array from the specified source array, beginning at the specified position, to the specified position of the destination array (non-atomically). |
static short |
arrayFillNonAtomic(byte[] bArray,
short bOff,
short bLen,
byte bValue)
Fills the byte array (non-atomically) beginning at the specified position, for the specified length with the specified byte value. |
static short |
getShort(byte[] bArray,
short bOff)
Concatenates two bytes in a byte array to form a short value. |
static short |
makeShort(byte b1,
byte b2)
Concatenates the two parameter bytes to form a short value. |
static short |
setShort(byte[] bArray,
short bOff,
short sValue)
Deposits the short value as two successive bytes at the specified offset in the byte array. |
Methods inherited from class java.lang.Object |
equals |
Method Detail |
public static final short arrayCopy(byte[] src, short srcOff, byte[] dest, short destOff, short length) throws IndexOutOfBoundsException, NullPointerException, TransactionException
Notes:
srcOff
or destOff
or length
parameter
is negative an IndexOutOfBoundsException
exception is thrown.
srcOff+length
is greater than src.length
, the length
of the src
array a IndexOutOfBoundsException
exception is thrown
and no copy is performed.
destOff+length
is greater than dest.length
, the length
of the dest
array an IndexOutOfBoundsException
exception is thrown
and no copy is performed.
src
or dest
parameter is null
a NullPointerException
exception is thrown.
src
and dest
arguments refer to the same array object,
then the copying is performed as if the components at positions srcOff
through srcOff+length-1
were first copied to a temporary array with length components
and then the contents of the temporary array were copied into
positions destOff
through destOff+length-1
of the argument array.
TransactionException
exception is thrown.
src
- source byte array.srcOff
- offset within source byte array to start copy from.dest
- destination byte array.destOff
- offset within destination byte array to start copy into.length
- byte length to be copied.destOff+length
src
or dest
is null
.JCSystem.getUnusedCommitCapacity()
public static final short arrayCopyNonAtomic(byte[] src, short srcOff, byte[] dest, short destOff, short length) throws IndexOutOfBoundsException, NullPointerException
This method does not use the transaction facility during the copy operation even if a transaction is in progress. Thus, this method is suitable for use only when the contents of the destination array can be left in a partially modified state in the event of a power loss in the middle of the copy operation.
Notes:
srcOff
or destOff
or length
parameter
is negative an IndexOutOfBoundsException
exception is thrown.
srcOff+length
is greater than src.length
, the length
of the src
array a IndexOutOfBoundsException
exception is thrown
and no copy is performed.
destOff+length
is greater than dest.length
, the length
of the dest
array an IndexOutOfBoundsException
exception is thrown
and no copy is performed.
src
or dest
parameter is null
a NullPointerException
exception is thrown.
src
and dest
arguments refer to the same array object,
then the copying is performed as if the components at positions srcOff
through srcOff+length-1
were first copied to a temporary array with length components
and then the contents of the temporary array were copied into
positions destOff
through destOff+length-1
of the argument array.
length
parameter is not constrained by the atomic commit capacity limitations.src
- source byte array.srcOff
- offset within source byte array to start copy from.dest
- destination byte array.destOff
- offset within destination byte array to start copy into.length
- byte length to be copied.destOff+length
src
or dest
is null
.JCSystem.getUnusedCommitCapacity()
public static final short arrayFillNonAtomic(byte[] bArray, short bOff, short bLen, byte bValue) throws IndexOutOfBoundsException, NullPointerException
This method does not use the transaction facility during the fill operation even if a transaction is in progress. Thus, this method is suitable for use only when the contents of the byte array can be left in a partially filled state in the event of a power loss in the middle of the fill operation.
Notes:
bOff
or bLen
parameter
is negative an IndexOutOfBoundsException
exception is thrown.
bOff+bLen
is greater than bArray.length
, the length
of the bArray
array an IndexOutOfBoundsException
exception is thrown.
bArray
parameter is null
a NullPointerException
exception is thrown.
bLen
parameter is not constrained by the atomic commit capacity limitations.bArray
- the byte array.bOff
- offset within byte array to start filling bValue into.bLen
- byte length to be filled.bValue
- the value to fill the byte array with.bOff+bLen
null
JCSystem.getUnusedCommitCapacity()
public static final byte arrayCompare(byte[] src, short srcOff, byte[] dest, short destOff, short length) throws IndexOutOfBoundsException, NullPointerException
Notes:
srcOff
or destOff
or length
parameter
is negative an IndexOutOfBoundsException
exception is thrown.
srcOff+length
is greater than src.length
, the length
of the src
array a IndexOutOfBoundsException
exception is thrown.
destOff+length
is greater than dest.length
, the length
of the dest
array an IndexOutOfBoundsException
exception is thrown.
src
or dest
parameter is null
a NullPointerException
exception is thrown.
src
- source byte array.srcOff
- offset within source byte array to start compare.dest
- destination byte array.destOff
- offset within destination byte array to start compare.length
- byte length to be compared.0
if identical
-1
if the first miscomparing byte in source array is less than that in destination array,
1
if the first miscomparing byte in source array is greater that that in destination array.src
or dest
is null
.public static final short makeShort(byte b1, byte b2)
b1
- the first byte ( high order byte ).b2
- the second byte ( low order byte ).public static final short getShort(byte[] bArray, short bOff)
bArray
- byte array.bOff
- offset within byte array containing first byte (the high order byte).public static final short setShort(byte[] bArray, short bOff, short sValue) throws TransactionException
bArray
- byte array.bOff
- offset within byte array to deposit the first byte (the high order byte).sValue
- the short value to set into array.bOff+2
Note:
TransactionException
exception is thrown.JCSystem.getUnusedCommitCapacity()
|
Submit a bug or feature Java and Java Card are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 1993-1999 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved. |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |