com.tencent.kona.sun.security.util.math

Interface MutableIntegerModuloP

All Superinterfaces:

IntegerModuloP

All Known Implementing Classes:

IntegerPolynomial.MutableElement

public interface MutableIntegerModuloP
extends IntegerModuloP

An interface for mutable integers modulo a prime value. This interface should be used to improve performance and avoid the allocation of a large number of temporary objects. Methods in this interface that modify the value also return the modified element. This structure enables fluent expressions like: a.setSum(b).setProduct(c).setDifference(d).setSquare()

Nested Class Summary

Nested classes/interfaces inherited from interface com.tencent.kona.sun.security.util.math.IntegerModuloP

IntegerModuloP.MultiplicativeInverser

Method Summary

Modifier and Type	Method and Description
void	conditionalSet(IntegerModuloP b, int set) Set this value to the value of b when set has the value 1.
void	conditionalSwapWith(MutableIntegerModuloP b, int swap) Swap the value of this with the value of b when swap has the value 1.
MutableIntegerModuloP	setAdditiveInverse() Set the value of this element equal to 0 - this.
MutableIntegerModuloP	setDifference(IntegerModuloP b) Set the value of this element equal to this - b.
MutableIntegerModuloP	setProduct(IntegerModuloP b) Set the value of this element equal to this * b.
MutableIntegerModuloP	setProduct(SmallValue v) Set the value of this element equal to this * v.
MutableIntegerModuloP	setSquare() Set the value of this element equal to this * this.
MutableIntegerModuloP	setSum(IntegerModuloP b) Set the value of this element equal to this + b.
MutableIntegerModuloP	setValue(byte[] v, int offset, int length, byte highByte) Set the value equal to the little-endian unsigned integer stored at the specified position in an array.
MutableIntegerModuloP	setValue(java.nio.ByteBuffer buf, int length, byte highByte) Set the value equal to the little-endian unsigned integer stored in a buffer.
MutableIntegerModuloP	setValue(IntegerModuloP v) Set the value of this element equal to the value of the supplied element.

Methods inherited from interface com.tencent.kona.sun.security.util.math.IntegerModuloP

add, additiveInverse, addModPowerTwo, addModPowerTwo, asBigInteger, asByteArray, asByteArray, fixed, getField, multiplicativeInverse, multiply, mutable, pow, square, subtract

Method Detail

conditionalSet

void conditionalSet(IntegerModuloP b,
                    int set)

Set this value to the value of b when set has the value 1. No change is made to this element when set has the value 0. The result is undefined when set has a value other than 0 or 1. The set parameter is an int (rather than boolean) to allow the implementation to perform the assignment using branch-free integer arithmetic.

Parameters:

b - the element to conditionally swap with

set - an int that determines whether to set

conditionalSwapWith

void conditionalSwapWith(MutableIntegerModuloP b,
                         int swap)

Swap the value of this with the value of b when swap has the value 1. No change is made to either element when swap has the value 0. The result is undefined when swap has a value other than 0 or 1. The swap parameter is an int (rather than boolean) to allow the implementation to perform the swap using branch-free integer arithmetic.

Parameters:

b - the element to conditionally swap with

swap - an int that determines whether to swap

setValue

MutableIntegerModuloP setValue(IntegerModuloP v)

Set the value of this element equal to the value of the supplied element. The argument is not modified.

Parameters:

v - the element whose value should be copied to this

Returns:

this

setValue

MutableIntegerModuloP setValue(byte[] v,
                               int offset,
                               int length,
                               byte highByte)

Set the value equal to the little-endian unsigned integer stored at the specified position in an array. The range of accepted values is implementation-specific. This method also takes a byte which is interpreted as an additional high-order byte of the number.

Parameters:

v - an array containing a little-endian unsigned integer

offset - the starting position of the integer

length - the number of bytes to read

highByte - the high-order byte of the number

Returns:

this

setValue

MutableIntegerModuloP setValue(java.nio.ByteBuffer buf,
                               int length,
                               byte highByte)

Set the value equal to the little-endian unsigned integer stored in a buffer. The range of accepted values is implementation-specific. This method also takes a byte which is interpreted as an additional high-order byte of the number.

Parameters:

buf - a buffer containing a little-endian unsigned integer

length - the number of bytes to read

highByte - the high-order byte of the number

Returns:

this

setSquare

MutableIntegerModuloP setSquare()

Set the value of this element equal to this * this.

Returns:

this

setSum

MutableIntegerModuloP setSum(IntegerModuloP b)

Set the value of this element equal to this + b. The argument is not modified.

Parameters:

b - the sumand

Returns:

this

setDifference

MutableIntegerModuloP setDifference(IntegerModuloP b)

Set the value of this element equal to this - b. The argument is not modified.

Parameters:

b - the subtrahend

Returns:

this

setProduct

MutableIntegerModuloP setProduct(IntegerModuloP b)

Set the value of this element equal to this * b. The argument is not modified.

Parameters:

b - the multiplicand

Returns:

this

setProduct

MutableIntegerModuloP setProduct(SmallValue v)

Set the value of this element equal to this * v. The argument is not modified.

Parameters:

v - the small multiplicand

Returns:

this

setAdditiveInverse

MutableIntegerModuloP setAdditiveInverse()

Set the value of this element equal to 0 - this.

Returns:

this