AbstractPrimitiveWrapper (Java Accumulators and Variants)

java.lang.Object
- java.lang.Number
- - net.sf.jaccumulator.scalars.AbstractScalar<REAL>
 - - net.sf.jaccumulator.reals.AbstractReal<PRIMITIVE>
 - - net.sf.jaccumulator.primitives.AbstractPrimitive<PRIMITIVE>
 - net.sf.jaccumulator.primitives.AbstractPrimitiveWrapper<PRIMITIVE>

Type Parameters:
PRIMITIVE - this primitive type (used to facilitate operation chaining on write operations)

All Implemented Interfaces:

Serializable, Appendable, CharSequence, Comparable<SealedPrimitive<?>>, AlgebraicStructure<PRIMITIVE>, BooleanValue<PRIMITIVE>, MutableBooleanValue<PRIMITIVE>, SealedBooleanValue, ByteValue<PRIMITIVE>, MutableByteValue<PRIMITIVE>, SealedByteValue, CharacterValue<PRIMITIVE>, MutableCharacterValue<PRIMITIVE>, SealedCharacterValue, DoubleValue<PRIMITIVE>, MutableDoubleValue<PRIMITIVE>, SealedDoubleValue, FloatValue<PRIMITIVE>, MutableFloatValue<PRIMITIVE>, SealedFloatValue, IntegerValue<PRIMITIVE>, MutableIntegerValue<PRIMITIVE>, SealedIntegerValue, LongValue<PRIMITIVE>, MutableLongValue<PRIMITIVE>, SealedLongValue, Mutable, MutableAlgebraicStructure<PRIMITIVE>, MutableKernel<PRIMITIVE>, MutablePrimitive<PRIMITIVE>, Primitive<PRIMITIVE>, PrimitiveInductor<PRIMITIVE>, PrimitiveReplicator<PRIMITIVE>, SealedPrimitive<PRIMITIVE>, MutableReal<PRIMITIVE>, MutableRealDomain<PRIMITIVE>, Real<PRIMITIVE>, RealDomain<PRIMITIVE>, RealInductor<PRIMITIVE>, RealReplicator<PRIMITIVE>, SealedReal<PRIMITIVE>, SealedRealBag, SealedRealDomain, Replicator<PRIMITIVE>, CharacterProperties, MutableScalar<PRIMITIVE>, MutableScalarDomain<PRIMITIVE>, NumericProperties, Scalar<PRIMITIVE>, ScalarDomain<PRIMITIVE>, ScalarInductor<PRIMITIVE>, ScalarReplicator<PRIMITIVE>, SealedScalar<PRIMITIVE>, SealedScalarBag, SealedScalarDomain, SealedAlgebraicStructure, SealedKernel, MutableShortValue<PRIMITIVE>, SealedShortValue, ShortValue<PRIMITIVE>, StructureProperties, MutableText<PRIMITIVE>, MutableTextValue<PRIMITIVE>, SealedText<PRIMITIVE>, SealedTextValue, Text<PRIMITIVE>, TextInductor, TextProperties, TextReplicator<PRIMITIVE>, TextValue<PRIMITIVE>, MutableUnlimitedDecimalValue<PRIMITIVE>, MutableUnlimitedIntegerValue<PRIMITIVE>, SealedUnlimitedDecimalValue, SealedUnlimitedIntegerValue, UnlimitedDecimalValue<PRIMITIVE>, UnlimitedIntegerValue<PRIMITIVE>

Direct Known Subclasses:

AbstractAccumulator, Variant
```
public abstract class AbstractPrimitiveWrapper<PRIMITIVE extends Primitive<PRIMITIVE>>
extends AbstractPrimitive<PRIMITIVE>
implements Primitive<PRIMITIVE>
```
An abstract primitive wrapper, ready to be overridden and missing only the protected getTarget() and the explicit copy functions

Since:

JCXell 1.0

Author:

Nicole Tedesco (Nicole@NicoleTedesco.com)

See Also:
Serialized Form

Field Summary
- Fields inherited from class net.sf.jaccumulator.scalars.AbstractScalar
  NaN, ONEI, ZERO_DOUBLE_LONG_BITS, ZERO_FLOAT_INT_BITS, ZEROI

Constructor Summary

Constructors
Constructor and Description

AbstractPrimitiveWrapper()

Constructors
Constructor and Description
`AbstractPrimitiveWrapper()`

Method Summary

Methods
Modifier and Type	Method and Description
`PRIMITIVE`	`absoluteValue()` Replace the current value with the absolute value of itself
`PRIMITIVE`	`and(BigInteger aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`and(boolean aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`and(byte aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`and(char aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`and(int aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`and(long aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`and(short aValue)` Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`angleWith(double aValue)` Set this value to the angle formed by the rectangular coordinates given by the current value, x, and the specified value, y.
`PRIMITIVE`	`append(boolean aValue)`
`PRIMITIVE`	`append(char c)`
`PRIMITIVE`	`append(char[] content)`
`PRIMITIVE`	`append(char[] content, int contentIndex)`
`PRIMITIVE`	`append(char[] content, int contentIndex, int contentLength)`
`PRIMITIVE`	`append(CharSequence s)`
`PRIMITIVE`	`append(CharSequence content, int contentStartIndex)`
`PRIMITIVE`	`append(CharSequence s, int start, int end)`
`PRIMITIVE`	`append(double aValue)`
`PRIMITIVE`	`append(float aValue)`
`PRIMITIVE`	`append(int aValue)`
`PRIMITIVE`	`append(long aValue)`
`PRIMITIVE`	`append(Object aValue)`
`PRIMITIVE`	`append(StringBuffer sb)`
`PRIMITIVE`	`appendCodePoint(int codePoint)`
`PRIMITIVE`	`arcCosine()` Replace the current value with its arc `cosine`
`PRIMITIVE`	`arcSine()` Replace the current value with its arc `sine`
`PRIMITIVE`	`arcTangent()` Replace the current value with its arc `tangent`
`PRIMITIVE`	`assertDomain(Domain aDomain)` Attempt to convert the implementation `domain` of this structure to the closest available match for the proposed domain.
`PRIMITIVE`	`assertPrecision(NumericPrecision prec)` Convert the numeric `precision` of this implementation to the closest available match for the proposed precision.
`PRIMITIVE`	`base10Log()` Replace the current value with its base 10 logarithm
`boolean`	`booleanPostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`boolean`	`booleanPostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`boolean`	`booleanValue()`
`byte`	`bytePostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`byte`	`bytePostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`byte`	`byteValue()`
`char`	`charAt(int index)`
`char`	`charPostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`char`	`charPostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`char`	`charValue()`
`void`	`clear()` Same as `Collection.clear()`.
`PRIMITIVE`	`clearContents()` Clear all elements of this structure and answer this object (facilitates chaining}. For text primitives all characters will be removed in an exact analog to `clear()`.
`PRIMITIVE`	`clearText()` Clear all characters from this primitive and re-interpret/re-set
`int`	`codePointAt(int index)`
`int`	`codePointBefore(int index)`
`int`	`codePointCount(int beginIndex, int endIndex)`
`int`	`compareTo(SealedPrimitive<?> o)`
`int`	`compareToPrimitive(SealedPrimitive<?> aPrimitive)` Compares this object with the specified object for order
`int`	`compareToScalar(boolean aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(byte aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(char aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(double aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(float aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(int aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(long aValue)` Compares this object with the specified scalar for order
`int`	`compareToScalar(short aValue)` Compares this object with the specified scalar for order
`int`	`compareToText(CharSequence text)` Compares this object's `text` equivalent with the specified text for order
`int`	`compareToZero()` Compares this object with zero for order
`PRIMITIVE`	`cosine()` Replace the current value, assumed to be an angle in radians, to its `cosine`
`PRIMITIVE`	`cube()` Replace the current value with the cube of itself
`PRIMITIVE`	`cubeRoot()` Replace the current value with the cube root of itself
`PRIMITIVE`	`decrement()` Replace the current value with the current value minus unity (one)
`PRIMITIVE`	`degrees()` Replace the current value, assumed to be an angle in radians, to its equivalent angle in degrees
`PRIMITIVE`	`delete(int start, int end)`
`PRIMITIVE`	`deleteCharAt(int anIndex)`
`PRIMITIVE`	`difference(BigDecimal aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(BigInteger aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(boolean aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(byte aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(char aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(double aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(float aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(int aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(long aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`PRIMITIVE`	`difference(short aValue)` Set the value of this scalar to the mathematical difference between its current value and the specified value
`double`	`doublePostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`double`	`doublePostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`double`	`doubleValue()`
`boolean`	`equals(Object anObject)`
`PRIMITIVE`	`exponential()` Replace the current value with e (Napier's constant) raised to the current value (eⁿ)
`PRIMITIVE`	`exponentialLessOne()` Replace the current value with e (Napier's constant) raised to the current value, less 1 (eⁿ-1)
`float`	`floatPostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`float`	`floatPostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`float`	`floatValue()`
`PRIMITIVE`	`gcd(BigInteger aValue)` Replace the current value with the greatest common denonimator between this value and the specific one
`PRIMITIVE`	`gcd(byte aValue)` Replace the current value with the greatest common factor between this value and the specific one
`PRIMITIVE`	`gcd(char aValue)` Replace the current value with the greatest common factor between this value and the specific one
`PRIMITIVE`	`gcd(int aValue)` Replace the current value with the greatest common factor between this value and the specific one
`PRIMITIVE`	`gcd(long aValue)` Replace the current value with the greatest common factor between this value and the specific one
`PRIMITIVE`	`gcd(short aValue)` Replace the current value with the greatest common factor between this value and the specific one
`ConcurrencyStrategy`	`getConcurrency()`
`Domain`	`getDomain()`
`NumericPrecision`	`getPrecision()`
`StructureStrategy`	`getStructureStrategy()`
`protected abstract Primitive<?>`	`getTarget()`
`int`	`hashCode()`
`PRIMITIVE`	`hyperbolicCosine()` Replace the current value, assumed to be an angle in radians, to its hyperbolic `cosine`
`PRIMITIVE`	`hyperbolicSine()` Replace the current value, assumed to be an angle in radians, to its hyperbolic `sine`
`PRIMITIVE`	`hyperbolicTangent()` Replace the current value, assumed to be an angle in radians, to its hyperbolic `tangent`
`PRIMITIVE`	`increment()` Replace the current value with the current value plus unity (one)
`int`	`indexOfText(CharSequence str)`
`int`	`indexOfText(CharSequence str, int beginIndex)`
`<P extends Primitive<?>> P`	`inducePostDecrement(P aTarget)` Decrement the value of this Primitive then induce its original value into the specified target
`<R extends Real<?>> R`	`inducePostDecrement(R aTarget)` Decrement the value of this real then induce its original value into the specified target
`<S extends Scalar<?>> S`	`inducePostDecrement(S aTarget)` Decrement the value of this scalar then induce its original value into the specified target
`<P extends Primitive<?>> P`	`inducePostIncrement(P aTarget)` Increment the value of this Primitive then induce its original value into the specified target
`<R extends Real<?>> R`	`inducePostIncrement(R aTarget)` Increment the value of this real then induce its original value into the specified target
`<S extends Scalar<?>> S`	`inducePostIncrement(S aTarget)` Increment the value of this scalar then induce its original value into the specified target
`<P extends Primitive<?>> P`	`inducePrimitiveMaximum(P aTarget)` Induce the maximum numeric value of the Primitive into the specified target
`<P extends Primitive<?>> P`	`inducePrimitiveMinimum(P aTarget)` Induce the minimum numeric value of the Primitive into the specified target
`<P extends Primitive<?>> P`	`inducePrimitiveValue(P aTarget)` Induce the current value of this Primitive into the specified target
`<R extends Real<?>> R`	`induceRealMaximum(R aTarget)` Induce the maximum domain value into the target
`<R extends Real<?>> R`	`induceRealMinimum(R aTarget)` Induce the minimum domain value into the target
`<R extends Real<?>> R`	`induceRealSize(R aTarget)` Update the target `scalar` with the element count in this structure
`<R extends Real<?>> R`	`induceRealValue(R aTarget)` Induce the current value of this real into the specified target
`<S extends Scalar<?>> S`	`induceScalarMaximum(S aTarget)` Induce the maximum domain value into the target
`<S extends Scalar<?>> S`	`induceScalarMinimum(S aTarget)` Induce the minimum domain value into the target
`<R extends Scalar<?>> R`	`induceScalarSize(R aTarget)` Update the target `scalar` with the element count in this structure
`<S extends Scalar<?>> S`	`induceScalarValue(S aTarget)` Induce the current value of this scalar into the specified target
`<SCALAR extends Scalar<?>> SCALAR`	`induceTextSize(SCALAR aTarget)` Induce the current value of this text into the `scalar` target
`<TEXT extends Text<?>> TEXT`	`induceTextValue(TEXT aTarget)` Induce the current value of this text into the specified target
`PRIMITIVE`	`insert(int anIndex, boolean aValue)`
`PRIMITIVE`	`insert(int anIndex, char aValue)`
`PRIMITIVE`	`insert(int anIndex, char[] content)`
`PRIMITIVE`	`insert(int targetIndex, char[] content, int contentIndex, int contentLength)`
`PRIMITIVE`	`insert(int anIndex, CharSequence content)`
`PRIMITIVE`	`insert(int targetIndex, CharSequence content, int contentIndex)`
`PRIMITIVE`	`insert(int targetIndex, CharSequence content, int contentStartIndex, int contentEndIndexPlusOne)`
`PRIMITIVE`	`insert(int anIndex, double aValue)`
`PRIMITIVE`	`insert(int anIndex, float aValue)`
`PRIMITIVE`	`insert(int anIndex, int aValue)`
`PRIMITIVE`	`insert(int anIndex, long aValue)`
`PRIMITIVE`	`insert(int anIndex, Object aValue)`
`int`	`intPostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`int`	`intPostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`int`	`intValue()`
`PRIMITIVE`	`invalidate()` Replace the current value an invalid value such `INVALID` if possible, otherwise replace it with zero
`PRIMITIVE`	`inverse()` Replace the current value its multiplicative inverse (`1/x`)
`boolean`	`isAlphabetic()`
`boolean`	`isBmpCodePoint()`
`boolean`	`isConfigurable()` Answer `true` if the implementation of this object can be changed. A configurable object has a structure that can be `expanded`, or `reduced`, or has replaceable components.
`boolean`	`isCountable()` Answer `true` if this structure contains a countable number of elements.
`boolean`	`isDigit()` Determine if this `char`-width or `int`-width character is a digit within Unicode
`boolean`	`isElastic()` Answer `true` if this structure, in principle, can be reduced via element removal or expanded via element addition.
`boolean`	`isEmpty()` Answer `true` if this structure contains no elements.
`boolean`	`isEqual(BigDecimal aValue)`
`boolean`	`isEqual(BigInteger aValue)`
`boolean`	`isEqual(boolean aValue)`
`boolean`	`isEqual(byte aValue)`
`boolean`	`isEqual(char aValue)`
`boolean`	`isEqual(double aValue)`
`boolean`	`isEqual(float aValue)`
`boolean`	`isEqual(int aValue)`
`boolean`	`isEqual(long aValue)`
`boolean`	`isEqual(short aValue)`
`boolean`	`isEqualToPrimitive(SealedPrimitive<?> aPrimitive)`
`boolean`	`isEqualToText(CharSequence aValue)`
`boolean`	`isExpandable()`
`boolean`	`isFinite()`
`boolean`	`isGreater(BigDecimal aValue)`
`boolean`	`isGreater(BigInteger aValue)`
`boolean`	`isGreater(boolean aValue)`
`boolean`	`isGreater(byte aValue)`
`boolean`	`isGreater(char aValue)`
`boolean`	`isGreater(double aValue)`
`boolean`	`isGreater(float aValue)`
`boolean`	`isGreater(int aValue)`
`boolean`	`isGreater(long aValue)`
`boolean`	`isGreater(short aValue)`
`boolean`	`isGreaterOrEqual(BigDecimal aValue)`
`boolean`	`isGreaterOrEqual(BigInteger aValue)`
`boolean`	`isGreaterOrEqual(boolean aValue)`
`boolean`	`isGreaterOrEqual(byte aValue)`
`boolean`	`isGreaterOrEqual(char aValue)`
`boolean`	`isGreaterOrEqual(double aValue)`
`boolean`	`isGreaterOrEqual(float aValue)`
`boolean`	`isGreaterOrEqual(int aValue)`
`boolean`	`isGreaterOrEqual(long aValue)`
`boolean`	`isGreaterOrEqual(short aValue)`
`boolean`	`isGreaterOrEqualToPrimitive(SealedPrimitive<?> aPrimitive)`
`boolean`	`isGreaterOrEqualToText(CharSequence aValue)`
`boolean`	`isGreaterThanPrimitive(SealedPrimitive<?> aPrimitive)`
`boolean`	`isGreaterThanText(CharSequence aValue)`
`boolean`	`isHighSurrogate()`
`boolean`	`isIdentifierIgnorable()` Determine if this `char`-width or `int`-width character ignorable character in a Java identifier or a Unicode identifier
`boolean`	`isIdeographic()`
`boolean`	`isImaginary()` Answer `true` if this value represents the magnitude of a vector into the set of imaginary numbers.
`boolean`	`isInfinity()`
`boolean`	`isInvalid()`
`boolean`	`isISOControl()` Determine if this `char`-width or `int`-width character is an ISO control character within Unicode
`boolean`	`isJavaIdentifierPart()` Determine if this `char`-width or `int`-width character is a part of a Java identifier as other than the first character
`boolean`	`isJavaIdentifierStart()` Determine if this `char`-width or `int`-width character is permissible as the first character in a Java identifier
`boolean`	`isLess(BigDecimal aValue)`
`boolean`	`isLess(BigInteger aValue)`
`boolean`	`isLess(boolean aValue)`
`boolean`	`isLess(byte aValue)`
`boolean`	`isLess(char aValue)`
`boolean`	`isLess(double aValue)`
`boolean`	`isLess(float aValue)`
`boolean`	`isLess(int aValue)`
`boolean`	`isLess(long aValue)`
`boolean`	`isLess(short aValue)`
`boolean`	`isLessOrEqual(BigDecimal aValue)`
`boolean`	`isLessOrEqual(BigInteger aValue)`
`boolean`	`isLessOrEqual(boolean aValue)`
`boolean`	`isLessOrEqual(byte aValue)`
`boolean`	`isLessOrEqual(char aValue)`
`boolean`	`isLessOrEqual(double aValue)`
`boolean`	`isLessOrEqual(float aValue)`
`boolean`	`isLessOrEqual(int aValue)`
`boolean`	`isLessOrEqual(long aValue)`
`boolean`	`isLessOrEqual(short aValue)`
`boolean`	`isLessOrEqualToPrimitive(SealedPrimitive<?> aPrimitive)`
`boolean`	`isLessOrEqualToText(CharSequence aValue)`
`boolean`	`isLessThanPrimitive(SealedPrimitive<?> aPrimitive)`
`boolean`	`isLessThanText(CharSequence aValue)`
`boolean`	`isLetter()` Determine if this `char`-width or `int`-width character is a letter within Unicode
`boolean`	`isLetterOrDigit()` Determine if this `char`-width or `int`-width character is a letter or digit within Unicode
`boolean`	`isLowerCase()` Determine if this `char`-width or `int`-width character is a lower case character within Unicode
`boolean`	`isLowSurrogate()`
`boolean`	`isMaximum()`
`boolean`	`isMinimum()`
`boolean`	`isMirrored()` Determine if this `char`-width or `int`-width character is "mirrored" within Unicode
`boolean`	`isModulo()` Answer `true` if this value represents the magnitude of a vector into a modulo set, or finite ring.
`boolean`	`isMutable()`
`boolean`	`isNegative()`
`boolean`	`isNegativeFinite()`
`boolean`	`isNegativeInfinity()`
`boolean`	`isNotEqual(BigDecimal aValue)`
`boolean`	`isNotEqual(BigInteger aValue)`
`boolean`	`isNotEqual(boolean aValue)`
`boolean`	`isNotEqual(byte aValue)`
`boolean`	`isNotEqual(char aValue)`
`boolean`	`isNotEqual(double aValue)`
`boolean`	`isNotEqual(float aValue)`
`boolean`	`isNotEqual(int aValue)`
`boolean`	`isNotEqual(long aValue)`
`boolean`	`isNotEqual(short aValue)`
`boolean`	`isNotEqualToPrimitive(SealedPrimitive<?> aPrimitive)`
`boolean`	`isNotEqualToText(CharSequence aValue)`
`boolean`	`isOrdered()` Answer `true` if the elements of this structure necessarily share a partial or total order between each other within the context of this structure.
`boolean`	`isPositive()`
`boolean`	`isPositiveFinite()`
`boolean`	`isPositiveInfinity()`
`boolean`	`isReal()` Answer `true` if this value represents the magnitude of a vector into the set of real numbers.
`boolean`	`isReducible()` Answer `true` if this structure, in principle, can be reduced via element removal.
`boolean`	`isSupplementaryCodePoint()`
`boolean`	`isSurrogate()`
`boolean`	`isText()`
`boolean`	`isTitleCase()` Determine if this `char`-width or `int`-width character is a title case character within Unicode
`boolean`	`isUnicode()` Determine if this `char`-width or `int`-width character is defined within Unicode
`boolean`	`isUnicodeIdentifierPart()` Determine if this `char`-width or `int`-width character is a part of a Unicode identifier as other than the first character
`boolean`	`isUnicodeIdentifierStart()` Determine if this `char`-width or `int`-width character is permissible as the first character in a Unicode identifier
`boolean`	`isUnique()`
`boolean`	`isUnity()` Answer `true` if this value represents the multiplicative identity in its arithmetic domain.
`boolean`	`isUpperCase()` Determine if this `char`-width or `int`-width character is an upper case character within Unicode
`boolean`	`isValidCodePoint()`
`boolean`	`isWhitespace()` Determine if this `char`-width or `int`-width character is whitespace within Unicode
`boolean`	`isZero()` Answer `true` if this value represents the additive identity in its algebraic group.
`int`	`length()`
`long`	`longPostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`long`	`longPostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`long`	`longSize()` Returns the number of elements in this algebraic structure as a `long` scalar.
`long`	`longValue()`
`PRIMITIVE`	`lowerCase()` For text-based objects, convert all characters in the text to lower case.
`PRIMITIVE`	`milliseconds()` Set the value of this object to the current millisecond-precision system `time`
`PRIMITIVE`	`mod(BigDecimal aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(BigInteger aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(boolean aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(byte aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(char aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(double aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(float aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(int aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(long aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`mod(short aValue)` Set the value of this scalar to its current value modulo of the specified value
`PRIMITIVE`	`nanoseconds()` Set the value of this object to the current nanosecond-precision system `time`
`PRIMITIVE`	`naturalLog()` Replace the current value with its base e (Napier's constant) logarithm (log_e(`n`))
`PRIMITIVE`	`naturalLogPlusOne()` Replace the current value, plus 1, with its base e (Napier's constant) logarithm (log_e(`n`+1))
`PRIMITIVE`	`negate()` Replace the current value with the additive inverse (sign negation) of itself, that is transform it into a number that when added to the original yields zero.
`PRIMITIVE`	`not()` Replace the current integral binary vector with its one's complement.
`PRIMITIVE`	`or(BigInteger aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`or(boolean aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`or(byte aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`or(char aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`or(int aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`or(long aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`or(short aValue)` Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`power(double n)` Set this value to the current value, x, raised to the specified exponent, n, or xⁿ
`PRIMITIVE`	`power(int n)` Set this value to the current value, x, raised to the specified exponent, n, or xⁿ
`PRIMITIVE`	`prepend(boolean aValue)`
`PRIMITIVE`	`prepend(char aValue)`
`PRIMITIVE`	`prepend(char[] content)`
`PRIMITIVE`	`prepend(char[] content, int contentIndex)`
`PRIMITIVE`	`prepend(char[] content, int contentIndex, int contentLength)`
`PRIMITIVE`	`prepend(CharSequence content)`
`PRIMITIVE`	`prepend(CharSequence content, int contentIndex)`
`PRIMITIVE`	`prepend(CharSequence content, int contentStartIndex, int contentEndIndexPlusOne)`
`PRIMITIVE`	`prepend(double aValue)`
`PRIMITIVE`	`prepend(float aValue)`
`PRIMITIVE`	`prepend(int aValue)`
`PRIMITIVE`	`prepend(long aValue)`
`PRIMITIVE`	`prepend(Object aValue)`
`PRIMITIVE`	`product(BigDecimal aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(BigInteger aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(boolean aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(byte aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(char aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(double aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(float aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(int aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(long aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`product(short aValue)` Set the value of this scalar to the mathematical product of its current value and the specified value
`PRIMITIVE`	`promoteTo(NumericPrecision prec)` If this object's implementation is less `precise` than the specified numeric precision, then convert this implementation to the closest available match for the proposed precision.
`PRIMITIVE`	`quotient(BigDecimal aValue)` Set the value of this scalar to the mathematical quotient between its current value and the specified value
`PRIMITIVE`	`quotient(BigInteger aValue)` Set the value of this scalar to the mathematical quotient between its current value and the specified value
`PRIMITIVE`	`quotient(boolean aValue)` Set the value of this scalar to the mathematical quotient between its current value and the specified value
`PRIMITIVE`	`quotient(byte aValue)` Set the value of this scalar to the mathematical quotient of its current value and the specified value
`PRIMITIVE`	`quotient(char aValue)` Set the value of this scalar to the mathematical quotient between its current value and the specified value
`PRIMITIVE`	`quotient(double aValue)` Set the value of this scalar to the mathematical quotient of its current value and the specified value
`PRIMITIVE`	`quotient(float aValue)` Set the value of this scalar to the mathematical quotient of its current value and the specified value
`PRIMITIVE`	`quotient(int aValue)` Set the value of this scalar to the mathematical quotient of its current value and the specified value
`PRIMITIVE`	`quotient(long aValue)` Set the value of this scalar to the mathematical quotient of its current value and the specified value
`PRIMITIVE`	`quotient(short aValue)` Set the value of this scalar to the mathematical quotient of its current value and the specified value
`PRIMITIVE`	`radians()` Replace the current value, assumed to be an angle in degrees, to its equivalent angle in radians
`PRIMITIVE`	`random()` Replace the current value with an evenly-distributed `random` value between zero (inclusive) and unity (exclusive for floating point, inclusive for integrals)
`PRIMITIVE`	`replace(CharSequence target, CharSequence replacement)`
`PRIMITIVE`	`replace(int start, int end, String str)`
`PRIMITIVE`	`replaceAll(String regex, String replacement)`
`PRIMITIVE`	`replaceCharacter(char oldChar, char newChar)`
`PRIMITIVE`	`replaceFirst(String regex, String replacement)`
`PRIMITIVE`	`reverse()`
`PRIMITIVE`	`round(RoundingStrategy aRoundingStrategy)` Round the current value using the specified rounding `strategy`
`PRIMITIVE`	`setBoolean(Boolean aValue)` Set this property to the specified system-supported `Boolean` and answer this object (facilitates chaining)
`PRIMITIVE`	`setCharacter(Character aValue)` Set this property to the specified system-supported `Character` and answer this object (facilitates chaining)
`PRIMITIVE`	`setCharAt(int index, char ch)`
`PRIMITIVE`	`setE()` Replace the current value with e, or Napier's constant
`<E extends Enum<E>> PRIMITIVE`	`setEnumeration(E aValue)` Match the value of this object with the identity of the specified `enumeration` instance, then answer this object (facilitates chaining)
`PRIMITIVE`	`setFalse()` Set this property to its equivalent of `true` and answer this object (facilitates chaining)
`PRIMITIVE`	`setLength(int newLength)`
`PRIMITIVE`	`setMaximum()` Replace the current value with maximum value available for the implementation's numeric `precision`.
`PRIMITIVE`	`setMinimum()` Replace the current value with minimum value available for the implementation's numeric `precision`.
`PRIMITIVE`	`setNegativeInfinity()` Replace the current value with a representation of negative infinity, if available, otherwise replace with the implementation's `minimum` value
`PRIMITIVE`	`setPi()` Replace the current value with Pi
`PRIMITIVE`	`setPositiveInfinity()` Replace the current value with a representation of positive infinity, if available, otherwise replace with the implementation's `maximum` value
`PRIMITIVE`	`setPrimitive(SealedPrimitive<?> aValue)` Set this property to the specified primitive
`PRIMITIVE`	`setReal(BigDecimal aValue)` Set this property to the specified unlimited `decimal` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setReal(BigInteger aValue)` Set this property to the specified unlimited `integer` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(boolean aValue)` Set this property to the specified `boolean` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(byte aValue)` Set this property to the specified `byte` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(char aValue)` Set this property to the specified `char` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(double aValue)` Set this property to the specified `double` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(float aValue)` Set this property to the specified `float` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(int aValue)` Set this property to the specified `int` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(long aValue)` Set this property to the specified `long` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setScalar(SealedScalar<?> aValue)` Set this object to the specified scalar
`PRIMITIVE`	`setScalar(short aValue)` Set this property to the specified `short` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setText(CharSequence content)` Set this property to the specified `text` value and answer this object (facilitates chaining)
`PRIMITIVE`	`setTrue()` Set this property to its equivalent of `true` and answer this object (facilitates chaining)
`PRIMITIVE`	`setUnity()` Replace the current value with the multiplicative identity appropriate for the implementation (one)
`PRIMITIVE`	`setZero()` Replace the current value with the additive identity appropriate for the implementation (zero)
`PRIMITIVE`	`shiftLeft(int count)` Attempt to shift the elements of this tuple to the "left" the specified number of ordinal positions.
`PRIMITIVE`	`shiftRight(int count)` Attempt to shift the elements of this tuple to the "right" the specified number of ordinal positions.
`PRIMITIVE`	`shiftRightExtendZero(int count)` Attempt to shift the elements of this tuple to the "right" the specified number of ordinal positions without sign extension.
`short`	`shortPostDecrement()` Decrement the scalar value of this object then return the original value prior to decrementing
`short`	`shortPostIncrement()` Increment the scalar value of this object then return the original value prior to incrementing
`short`	`shortValue()`
`int`	`signum()`
`PRIMITIVE`	`sine()` Replace the current value, assumed to be an angle in radians, to its `sine`
`int`	`size()` Returns the number of elements in this algebraic structure.
`PRIMITIVE`	`square()` Replace the current value with the square of itself
`PRIMITIVE`	`squareRoot()` Replace the current value with the square root of itself
`CharSequence`	`subSequence(int start, int end)`
`String`	`substring(int beginIndex)`
`String`	`substring(int beginIndex, int endIndex)`
`PRIMITIVE`	`sum(BigDecimal aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(BigInteger aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(boolean aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(byte aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(char aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(double aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(float aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(int aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(long aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`sum(short aValue)` Set the value of this scalar to the mathematical sum of its current value and the specified value
`PRIMITIVE`	`swapPrimitives(Primitive<?> aValue)` Swap the value of this primitive for the specified one and set the specified primitive's value to the current value of this primitive
`PRIMITIVE`	`tangent()` Replace the current value, assumed to be an angle in radians, to its `tangent`
`String`	`textPostDecrement()` Decrement the real value of this text then return the original text prior to decrementing
`String`	`textPostIncrement()` Increment the real value of this text then return the original text prior to incrementing
`PRIMITIVE`	`titleCase()` For text-based objects, convert all characters in the text to `title` case.
`Boolean`	`toBoolean()`
`Character`	`toCharacter()`
`int`	`toCodePoint()` Represent the value of this object as a code point
`<E extends Enum<E>> E`	`toEnumeration(Class<E> anEnumerationClass)` Represent the value of this object as an appropriate member of the class of the specified `enumeration`
`Number`	`toNumber()`
`Primitive<?>`	`toPrimitive()` If this object is already `primitive` then simply call its `Replicator.copy()` function, otherwise convert it to a new Primitive instance
`Real<?>`	`toReal()` If this real is already a `real` number real then simply call its `Replicator.copy()` function, otherwise produce a new real number real
`Scalar<?>`	`toScalar()` If this scalar is already a `scalar` then simply call its `Replicator.copy()` function, otherwise produce a new scalar with scalar precision
`String`	`toString()`
`BigDecimal`	`toUnlimitedDecimal()`
`BigInteger`	`toUnlimitedInteger()`
`PRIMITIVE`	`trim()` Remove both leading and trailing `whitespace`
`BigDecimal`	`unlimitedDecimalPostDecrement()` Decrement the real value of this object then return the original value prior to decrementing
`BigDecimal`	`unlimitedDecimalPostIncrement()` Increment the real value of this object then return the original value prior to incrementing
`BigInteger`	`unlimitedIntegerPostDecrement()` Decrement the real value of this object then return the original value prior to decrementing
`BigInteger`	`unlimitedIntegerPostIncrement()` Increment the real value of this object then return the original value prior to incrementing
`PRIMITIVE`	`upperCase()` For text-based objects, convert all characters in the text to upper case.
`PRIMITIVE`	`xor(BigInteger aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`xor(boolean aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`xor(byte aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`xor(char aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`xor(int aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`xor(long aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
`PRIMITIVE`	`xor(short aValue)` Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector

Methods inherited from class net.sf.jaccumulator.primitives.AbstractPrimitive
andOfPrimitive, angleWithPrimitive, differenceOfPrimitive, hypotenuseWithPrimitive, modOfPrimitive, orOfPrimitive, powerOfPrimitive, productOfPrimitive, quotientOfPrimitive, sumOfPrimitive, xorOfPrimitive

Methods inherited from class net.sf.jaccumulator.scalars.AbstractScalar
andOfScalar, angleWithNumber, angleWithScalar, boundsCheck, byteMaskAt, byteNotMaskAt, byteValue, ceiling, charMaskAt, charNotMaskAt, charValue, clearByteBitAt, clearCharBitAt, clearDoubleBitAt, clearFloatBitAt, clearIntBitAt, clearLongBitAt, clearShortBitAt, clearUnlimitedDecimalBitAt, clearUnlimitedIntegerBitAt, compareTo, compareTo, compareTo, compareTo, compareTo, compareTo, compareTo, compareTo, compareTo, compareTo, compareTo, compareToScalar, differenceOfScalar, divideByZero, down, floor, gcdOfScalar, getBooleanBitAt, getByteBitAt, getCharBitAt, getDoubleBitAt, getFloatBitAt, getIntBitAt, getLongBitAt, getShortBitAt, getUnlimitedDecimalBitAt, getUnlimitedIntegerBitAt, halfDown, halfEven, halfUp, hashCode, hashCode, hashCode, hashCode, hashCode, hashCode, hashCode, hashCode, hypotenuseWith, hypotenuseWithNumber, hypotenuseWithScalar, indexOutOfBoundsAt, intGCD, intMaskAt, intModularInverse, intModularQuotient, intNotMaskAt, intValue, isEqualToScalar, isFalse, isGreaterOrEqualToScalar, isGreaterThanScalar, isLessOrEqualToScalar, isLessThanScalar, isNotEqualToScalar, isTrue, isValid, longGCD, longMaskAt, longModularInverse, longModularQuotient, longNotMaskAt, longValue, modOfScalar, orOfScalar, powerOfNumber, powerOfScalar, productOfScalar, quotientOfScalar, setByteBitAt, setCharBitAt, setDoubleBitAt, setFloatBitAt, setIntBitAt, setLongBitAt, setShortBitAt, setUnlimitedDecimalBitAt, setUnlimitedIntegerBitAt, shortMaskAt, shortNotMaskAt, shortValue, sumOfScalar, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toByteArray, toUnlimitedInteger, unlimitedIntegerMaskAt, unlimitedIntegerNotMaskAt, up, xorOfScalar

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.sf.jaccumulator.primitives.PrimitiveReplicator
copyUsingPrimitive, copyUsingText

Methods inherited from interface net.sf.jaccumulator.primitives.MutablePrimitive
andOfPrimitive, angleWithPrimitive, differenceOfPrimitive, hypotenuseWithPrimitive, modOfPrimitive, orOfPrimitive, powerOfPrimitive, productOfPrimitive, quotientOfPrimitive, sumOfPrimitive, xorOfPrimitive

Methods inherited from interface net.sf.jaccumulator.reals.SealedReal
compareToReal, compareToReal, compareToReal, isEqualToReal, isGreaterOrEqualToReal, isGreaterThanReal, isLessOrEqualToReal, isLessThanReal, isNotEqualToReal

Methods inherited from interface net.sf.jaccumulator.scalars.SealedScalar
compareToNumber, compareToScalar, isEqualToNumber, isEqualToScalar, isFalse, isGreaterOrEqualToNumber, isGreaterOrEqualToScalar, isGreaterThanNumber, isGreaterThanScalar, isLessOrEqualToNumber, isLessOrEqualToScalar, isLessThanNumber, isLessThanScalar, isNotEqualToNumber, isNotEqualToScalar, isTrue

Methods inherited from interface net.sf.jaccumulator.scalars.NumericProperties
isValid

Methods inherited from interface net.sf.jaccumulator.reals.RealReplicator
copyUsing, copyUsing, copyUsingReal

Methods inherited from interface net.sf.jaccumulator.scalars.ScalarReplicator
copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsingScalar

Methods inherited from interface net.sf.jaccumulator.Replicator
copy

Methods inherited from interface net.sf.jaccumulator.reals.MutableReal
andOfReal, angleWithReal, differenceOfReal, gcdOfReal, hypotenuseWithReal, modOfReal, orOfReal, powerOfReal, productOfReal, quotientOfReal, setReal, sumOfReal, xorOfReal

Methods inherited from interface net.sf.jaccumulator.scalars.MutableScalar
andOfNumber, andOfScalar, angleWithNumber, angleWithScalar, ceiling, differenceOfNumber, differenceOfScalar, down, floor, gcdOfNumber, gcdOfScalar, halfDown, halfEven, halfUp, hypotenuseWith, hypotenuseWithNumber, hypotenuseWithScalar, modOfNumber, modOfScalar, orOfNumber, orOfScalar, powerOfNumber, powerOfScalar, productOfNumber, productOfScalar, quotientOfNumber, quotientOfScalar, setNumber, sumOfNumber, sumOfScalar, up, xorOfNumber, xorOfScalar

Methods inherited from interface net.sf.jaccumulator.texts.TextReplicator
copyUsingText

- Constructor Detail
 - AbstractPrimitiveWrapper
```
public AbstractPrimitiveWrapper()
```
- Method Detail
 - getTarget
```
protected abstract Primitive<?> getTarget()
```
 - absoluteValue
```
public PRIMITIVE absoluteValue()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the absolute value of itself
 
 Specified by:
 
 absoluteValue in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 absoluteValue in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 - and
```
public PRIMITIVE and(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - and
```
public PRIMITIVE and(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - and
```
public PRIMITIVE and(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - and
```
public PRIMITIVE and(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - and
```
public PRIMITIVE and(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - and
```
public PRIMITIVE and(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - and
```
public PRIMITIVE and(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit and of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 and in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 and in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - angleWith
```
public PRIMITIVE angleWith(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the angle formed by the rectangular coordinates given by the current value, x, and the specified value, y. In other words returns the angle theta from the conversion of rectangular coordinates (x,y) to polar coordinates (r,theta).
 
 Specified by:
 
 angleWith in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 angleWith in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a y coordinate value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 See Also:
 Math.atan2(double, double)
 - append
```
public PRIMITIVE append(boolean aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(char c)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface Appendable
 
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(char[] content)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(char[] content,
 int contentIndex)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(char[] content,
 int contentIndex,
 int contentLength)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(CharSequence s)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface Appendable
 
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(CharSequence content,
 int contentStartIndex)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(CharSequence s,
 int start,
 int end)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface Appendable
 
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(double aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(float aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(int aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(long aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(Object aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - append
```
public PRIMITIVE append(StringBuffer sb)
 throws UnsupportedOperationException
```
 Specified by:
 
 append in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - appendCodePoint
```
public PRIMITIVE appendCodePoint(int codePoint)
 throws UnsupportedOperationException
```
 Specified by:
 
 appendCodePoint in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - arcCosine
```
public PRIMITIVE arcCosine()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with its arc cosine
 
 Specified by:
 
 arcCosine in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 arcCosine in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - arcSine
```
public PRIMITIVE arcSine()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with its arc sine
 
 Specified by:
 
 arcSine in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 arcSine in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - arcTangent
```
public PRIMITIVE arcTangent()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with its arc tangent
 
 Specified by:
 
 arcTangent in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 arcTangent in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - assertDomain
```
public PRIMITIVE assertDomain(Domain aDomain)
```
 Description copied from interface: MutableAlgebraicStructure
 
 Attempt to convert the implementation domain of this structure to the closest available match for the proposed domain. Note that the domain of this implementation may not change as a result of calling this function if an available internal conversion is not available.
 
 Specified by:
 
 assertDomain in interface MutableAlgebraicStructure<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 assertDomain in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aDomain - the proposed domain
 
 Returns:
 this object (facilitates operation chaining)
 See Also:
 StructureProperties.isConfigurable()
 - assertPrecision
```
public PRIMITIVE assertPrecision(NumericPrecision prec)
```
 Description copied from interface: MutableScalarDomain
 
 Convert the numeric precision of this implementation to the closest available match for the proposed precision. Note that the precision of this implementation may not change as a result of calling this function if this structure is not configurable.
 
 Specified by:
 
 assertPrecision in interface MutableScalarDomain<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 assertPrecision in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 prec - the proposed precision
 
 Returns:
 this object (facilitates operation chaining)
 - base10Log
```
public PRIMITIVE base10Log()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with its base 10 logarithm
 
 Specified by:
 
 base10Log in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 base10Log in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - booleanPostDecrement
```
public boolean booleanPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableBooleanValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 booleanPostDecrement in interface MutableBooleanValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - booleanPostIncrement
```
public boolean booleanPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableBooleanValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 booleanPostIncrement in interface MutableBooleanValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - booleanValue
```
public boolean booleanValue()
```
 Specified by:
 
 booleanValue in interface SealedBooleanValue
 
 Returns:
 the property value as a system boolean
 - bytePostDecrement
```
public byte bytePostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableByteValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 bytePostDecrement in interface MutableByteValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - bytePostIncrement
```
public byte bytePostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableByteValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 bytePostIncrement in interface MutableByteValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - byteValue
```
public byte byteValue()
```
 Specified by:
 
 byteValue in interface SealedByteValue
 
 Overrides:
 
 byteValue in class Number
 
 Returns:
 the property value as a system byte
 - charAt
```
public char charAt(int index)
```
 Specified by:
 
 charAt in interface CharSequence
 - charPostDecrement
```
public char charPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableCharacterValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 charPostDecrement in interface MutableCharacterValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - charPostIncrement
```
public char charPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableCharacterValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 charPostIncrement in interface MutableCharacterValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - charValue
```
public char charValue()
```
 Specified by:
 
 charValue in interface SealedCharacterValue
 
 Returns:
 the property value as a system char
 - clear
```
public void clear()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableTextValue
 
 Same as Collection.clear(). So as to maintain compatibility, this function will not return the customary reference back to this primitive. In text primitives, this function will clear the current text contents
 
 Specified by:
 
 clear in interface MutableAlgebraicStructure<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Specified by:
 
 clear in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException - if this text cannot be cleared
 See Also:
 MutableTextValue.clearText();, Collection.clear(), MutableAlgebraicStructure.clearContents()
 - clearContents
```
public PRIMITIVE clearContents()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableAlgebraicStructure
 
 Clear all elements of this structure and answer this object (facilitates chaining}.
 
 For text primitives all characters will be removed in an exact analog to clear(). For bit tuples such as scalar primitives, this will reset all bits zero since those elements cannot be removed. For unlimited primitives all bytes in the representation will be removed, producing zero.
 
 Primarily, this function is provided as an alternative to clear(), which does not return a value. This function, in answering this object, facilitates operation chaining.
 
 Specified by:
 
 clearContents in interface MutableAlgebraicStructure<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 See Also:
 MutableAlgebraicStructure.clear(), Collection.clear(), MutableTextValue.clearText();
 - clearText
```
public PRIMITIVE clearText()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableTextValue
 
 Clear all characters from this primitive and re-interpret/re-set
 
 Specified by:
 
 clearText in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's text cannot be changed
 See Also:
 MutableTextValue.clear();, Collection.clear(), MutableAlgebraicStructure.clearContents()
 - codePointAt
```
public int codePointAt(int index)
```
 Specified by:
 
 codePointAt in interface SealedTextValue
 - codePointBefore
```
public int codePointBefore(int index)
```
 Specified by:
 
 codePointBefore in interface SealedTextValue
 - codePointCount
```
public int codePointCount(int beginIndex,
 int endIndex)
```
 Specified by:
 
 codePointCount in interface SealedTextValue
 - compareTo
```
public int compareTo(SealedPrimitive<?> o)
```
 Specified by:
 
 compareTo in interface Comparable<SealedPrimitive<?>>
 - compareToPrimitive
```
public int compareToPrimitive(SealedPrimitive<?> aPrimitive)
```
 Description copied from interface: SealedPrimitive
 
 Compares this object with the specified object for order
 
 Specified by:
 
 compareToPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aPrimitive - an object to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified object.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(boolean aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(byte aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(char aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(double aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(float aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(int aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(long aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToScalar
```
public int compareToScalar(short aValue)
```
 Description copied from interface: SealedScalar
 
 Compares this object with the specified scalar for order
 
 Specified by:
 
 compareToScalar in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar to be compared to
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than the specified scalar.
 See Also:
 Comparable.compareTo(Object)
 - compareToText
```
public int compareToText(CharSequence text)
```
 Description copied from interface: SealedText
 
 Compares this object's text equivalent with the specified text for order
 
 Specified by:
 
 compareToText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToText in class AbstractPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 text - text to compare against
 
 Returns:
 a negative integer, zero, or a positive integer if this object's text equivalent is less than, equal to, or greater than the specified text.
 See Also:
 Comparable.compareTo(Object)
 - compareToZero
```
public int compareToZero()
```
 Description copied from interface: SealedScalar
 
 Compares this object with zero for order
 
 Specified by:
 
 compareToZero in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 compareToZero in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 a negative integer, zero, or a positive integer if this object is less than, equal to, or greater than zero
 See Also:
 Comparable.compareTo(Object)
 - cosine
```
public PRIMITIVE cosine()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its cosine
 
 Specified by:
 
 cosine in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 cosine in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - cube
```
public PRIMITIVE cube()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the cube of itself
 
 Specified by:
 
 cube in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - cubeRoot
```
public PRIMITIVE cubeRoot()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the cube root of itself
 
 Specified by:
 
 cubeRoot in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 cubeRoot in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - decrement
```
public PRIMITIVE decrement()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the current value minus unity (one)
 
 Specified by:
 
 decrement in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - degrees
```
public PRIMITIVE degrees()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its equivalent angle in degrees
 
 Specified by:
 
 degrees in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 degrees in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - delete
```
public PRIMITIVE delete(int start,
 int end)
 throws UnsupportedOperationException
```
 Specified by:
 
 delete in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - deleteCharAt
```
public PRIMITIVE deleteCharAt(int anIndex)
 throws UnsupportedOperationException
```
 Specified by:
 
 deleteCharAt in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - difference
```
public PRIMITIVE difference(BigDecimal aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(float aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - difference
```
public PRIMITIVE difference(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical difference between its current value and the specified value
 
 Specified by:
 
 difference in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 difference in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a subtrahend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - doublePostDecrement
```
public double doublePostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableDoubleValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 doublePostDecrement in interface MutableDoubleValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - doublePostIncrement
```
public double doublePostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableDoubleValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 doublePostIncrement in interface MutableDoubleValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - doubleValue
```
public double doubleValue()
```
 Specified by:
 
 doubleValue in interface SealedDoubleValue
 
 Specified by:
 
 doubleValue in class Number
 
 Returns:
 the property value as a system double
 - equals
```
public boolean equals(Object anObject)
```
 Specified by:
 
 equals in interface SealedKernel
 
 Overrides:
 
 equals in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - exponential
```
public PRIMITIVE exponential()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with e (Napier's constant) raised to the current value (eⁿ)
 
 Specified by:
 
 exponential in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 exponential in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 See Also:
 e (Wikipedia)
 - exponentialLessOne
```
public PRIMITIVE exponentialLessOne()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with e (Napier's constant) raised to the current value, less 1 (eⁿ-1)
 
 Specified by:
 
 exponentialLessOne in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 exponentialLessOne in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 See Also:
 e (Wikipedia)
 - floatPostDecrement
```
public float floatPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableFloatValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 floatPostDecrement in interface MutableFloatValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - floatPostIncrement
```
public float floatPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableFloatValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 floatPostIncrement in interface MutableFloatValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - floatValue
```
public float floatValue()
```
 Specified by:
 
 floatValue in interface SealedFloatValue
 
 Specified by:
 
 floatValue in class Number
 
 Returns:
 the property value as a system float
 - gcd
```
public PRIMITIVE gcd(BigInteger aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableReal
 
 Replace the current value with the greatest common denonimator between this value and the specific one
 
 Specified by:
 
 gcd in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 gcd in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - gcd
```
public PRIMITIVE gcd(byte aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the greatest common factor between this value and the specific one
 
 Specified by:
 
 gcd in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 gcd in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - gcd
```
public PRIMITIVE gcd(char aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the greatest common factor between this value and the specific one
 
 Specified by:
 
 gcd in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 gcd in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - gcd
```
public PRIMITIVE gcd(int aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the greatest common factor between this value and the specific one
 
 Specified by:
 
 gcd in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 gcd in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - gcd
```
public PRIMITIVE gcd(long aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the greatest common factor between this value and the specific one
 
 Specified by:
 
 gcd in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 gcd in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - gcd
```
public PRIMITIVE gcd(short aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the greatest common factor between this value and the specific one
 
 Specified by:
 
 gcd in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 gcd in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - getConcurrency
```
public ConcurrencyStrategy getConcurrency()
```
 Specified by:
 
 getConcurrency in interface SealedKernel
 
 Returns:
 the supported threading strategy
 - getDomain
```
public Domain getDomain()
```
 Specified by:
 
 getDomain in interface SealedAlgebraicStructure
 
 Overrides:
 
 getDomain in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the general semantic interpretation strategy of the configuration of elements in this structure
 - getPrecision
```
public NumericPrecision getPrecision()
```
 Specified by:
 
 getPrecision in interface SealedScalarDomain
 
 Overrides:
 
 getPrecision in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the relative size of the implementation's boolean bit tuple
 - getStructureStrategy
```
public StructureStrategy getStructureStrategy()
```
 Specified by:
 
 getStructureStrategy in interface SealedAlgebraicStructure
 
 Returns:
 a lemma defining the general implementation approach for this structure
 - hashCode
```
public int hashCode()
```
 Specified by:
 
 hashCode in interface SealedKernel
 
 Overrides:
 
 hashCode in class Object
 - hyperbolicCosine
```
public PRIMITIVE hyperbolicCosine()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its hyperbolic cosine
 
 Specified by:
 
 hyperbolicCosine in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 hyperbolicCosine in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - hyperbolicSine
```
public PRIMITIVE hyperbolicSine()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its hyperbolic sine
 
 Specified by:
 
 hyperbolicSine in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 hyperbolicSine in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - hyperbolicTangent
```
public PRIMITIVE hyperbolicTangent()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its hyperbolic tangent
 
 Specified by:
 
 hyperbolicTangent in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 hyperbolicTangent in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - increment
```
public PRIMITIVE increment()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the current value plus unity (one)
 
 Specified by:
 
 increment in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - indexOfText
```
public int indexOfText(CharSequence str)
```
 Specified by:
 
 indexOfText in interface SealedTextValue
 - indexOfText
```
public int indexOfText(CharSequence str,
 int beginIndex)
```
 Specified by:
 
 indexOfText in interface SealedTextValue
 - inducePostDecrement
```
public > P inducePostDecrement(P aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: PrimitiveInductor
 
 Decrement the value of this Primitive then induce its original value into the specified target
 
 Specified by:
 
 inducePostDecrement in interface PrimitiveInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 P - the target type
 Parameters:
 aTarget - a target into which the current value of this Primitive will be induced, prior to decrementing
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target Primitive cannot be changed
 
 IllegalStateException - this target Primitive cannot be changed at this time
 - inducePostDecrement
```
public <R extends Real<?>> R inducePostDecrement(R aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: RealInductor
 
 Decrement the value of this real then induce its original value into the specified target
 
 Specified by:
 
 inducePostDecrement in interface RealInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - a target into which the current value of this real will be induced, prior to decrementing
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target primitive cannot be changed
 
 IllegalStateException - this target primitive cannot be changed at this time
 - inducePostDecrement
```
public <S extends Scalar<?>> S inducePostDecrement(S aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: ScalarInductor
 
 Decrement the value of this scalar then induce its original value into the specified target
 
 Specified by:
 
 inducePostDecrement in interface ScalarInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 S - the target type
 Parameters:
 aTarget - a target into which the current value of this scalar will be induced, prior to decrementing
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target primitive cannot be changed
 
 IllegalStateException - this target primitive cannot be changed at this time
 - inducePostIncrement
```
public > P inducePostIncrement(P aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: PrimitiveInductor
 
 Increment the value of this Primitive then induce its original value into the specified target
 
 Specified by:
 
 inducePostIncrement in interface PrimitiveInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 P - the target type
 Parameters:
 aTarget - a target into which the current value of this Primitive will be induced, prior to incrementing
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target Primitive cannot be changed
 
 IllegalStateException - this target Primitive cannot be changed at this time
 - inducePostIncrement
```
public <R extends Real<?>> R inducePostIncrement(R aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: RealInductor
 
 Increment the value of this real then induce its original value into the specified target
 
 Specified by:
 
 inducePostIncrement in interface RealInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - a target into which the current value of this real will be induced, prior to incrementing
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target primitive cannot be changed
 
 IllegalStateException - this target primitive cannot be changed at this time
 - inducePostIncrement
```
public <S extends Scalar<?>> S inducePostIncrement(S aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: ScalarInductor
 
 Increment the value of this scalar then induce its original value into the specified target
 
 Specified by:
 
 inducePostIncrement in interface ScalarInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 S - the target type
 Parameters:
 aTarget - a target into which the current value of this scalar will be induced, prior to incrementing
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target primitive cannot be changed
 
 IllegalStateException - this target primitive cannot be changed at this time
 - inducePrimitiveMaximum
```
public > P inducePrimitiveMaximum(P aTarget)
```
 Description copied from interface: PrimitiveInductor
 
 Induce the maximum numeric value of the Primitive into the specified target
 
 Specified by:
 
 inducePrimitiveMaximum in interface PrimitiveInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 inducePrimitiveMaximum in class AbstractPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 P - the target type
 Parameters:
 aTarget - a target into which the maximum numeric value of the Primitive will be induced
 
 Returns:
 the target
 - inducePrimitiveMinimum
```
public > P inducePrimitiveMinimum(P aTarget)
```
 Description copied from interface: PrimitiveInductor
 
 Induce the minimum numeric value of the Primitive into the specified target
 
 Specified by:
 
 inducePrimitiveMinimum in interface PrimitiveInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 inducePrimitiveMinimum in class AbstractPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 P - the target type
 Parameters:
 aTarget - a target into which the minimum numeric value of the Primitive will be induced
 
 Returns:
 the target
 - inducePrimitiveValue
```
public > P inducePrimitiveValue(P aTarget)
```
 Description copied from interface: PrimitiveInductor
 
 Induce the current value of this Primitive into the specified target
 
 Specified by:
 
 inducePrimitiveValue in interface PrimitiveInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 P - the target type
 Parameters:
 aTarget - a target into which the current value of this Primitive will be induced
 
 Returns:
 the target
 - induceRealMaximum
```
public <R extends Real<?>> R induceRealMaximum(R aTarget)
```
 Description copied from interface: SealedRealDomain
 
 Induce the maximum domain value into the target
 
 Specified by:
 
 induceRealMaximum in interface SealedRealDomain
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - a target into which this domain's maximum value will be induced
 
 Returns:
 the target
 - induceRealMinimum
```
public <R extends Real<?>> R induceRealMinimum(R aTarget)
```
 Description copied from interface: SealedRealDomain
 
 Induce the minimum domain value into the target
 
 Specified by:
 
 induceRealMinimum in interface SealedRealDomain
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - a target into which this domain's minimum value will be induced
 
 Returns:
 the target
 - induceRealSize
```
public <R extends Real<?>> R induceRealSize(R aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: SealedRealBag
 
 Update the target scalar with the element count in this structure
 
 Specified by:
 
 induceRealSize in interface SealedRealBag
 
 Overrides:
 
 induceRealSize in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - the target to update
 
 Returns:
 the target scalar (facilitates operation chaining)
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target cannot be changed
 
 IllegalStateException - this target cannot be changed at this time
 - induceRealValue
```
public <R extends Real<?>> R induceRealValue(R aTarget)
```
 Description copied from interface: RealInductor
 
 Induce the current value of this real into the specified target
 
 Specified by:
 
 induceRealValue in interface RealInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - a target into which the current value of this real will be induced
 
 Returns:
 the target
 - induceScalarMaximum
```
public <S extends Scalar<?>> S induceScalarMaximum(S aTarget)
```
 Description copied from interface: SealedScalarDomain
 
 Induce the maximum domain value into the target
 
 Specified by:
 
 induceScalarMaximum in interface SealedScalarDomain
 
 Type Parameters:
 S - the target type
 Parameters:
 aTarget - a target into which this domain's maximum value will be induced
 
 Returns:
 the target
 - induceScalarMinimum
```
public <S extends Scalar<?>> S induceScalarMinimum(S aTarget)
```
 Description copied from interface: SealedScalarDomain
 
 Induce the minimum domain value into the target
 
 Specified by:
 
 induceScalarMinimum in interface SealedScalarDomain
 
 Type Parameters:
 S - the target type
 Parameters:
 aTarget - a target into which this domain's minimum value will be induced
 
 Returns:
 the target
 - induceScalarSize
```
public <R extends Scalar<?>> R induceScalarSize(R aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: SealedScalarBag
 
 Update the target scalar with the element count in this structure
 
 Specified by:
 
 induceScalarSize in interface SealedScalarBag
 
 Overrides:
 
 induceScalarSize in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 R - the target type
 Parameters:
 aTarget - the target to update
 
 Returns:
 the target scalar (facilitates operation chaining)
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target cannot be changed
 
 IllegalStateException - this target cannot be changed at this time
 - induceScalarValue
```
public <S extends Scalar<?>> S induceScalarValue(S aTarget)
```
 Description copied from interface: ScalarInductor
 
 Induce the current value of this scalar into the specified target
 
 Specified by:
 
 induceScalarValue in interface ScalarInductor<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 S - the target type
 Parameters:
 aTarget - a target into which the current value of this scalar will be induced
 
 Returns:
 the target
 - induceTextSize
```
public <SCALAR extends Scalar<?>> SCALAR induceTextSize(SCALAR aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: TextInductor
 
 Induce the current value of this text into the scalar target
 
 Specified by:
 
 induceTextSize in interface TextInductor
 
 Overrides:
 
 induceTextSize in class AbstractPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Type Parameters:
 SCALAR - the scalar target type
 Parameters:
 aTarget - a scalar target into which the current size of this text will be induced
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target primitive cannot be changed
 
 IllegalStateException - this target primitive cannot be changed at this time
 - induceTextValue
```
public <TEXT extends Text<?>> TEXT induceTextValue(TEXT aTarget)
 throws NullPointerException,
 NoSuchElementException,
 UnsupportedOperationException,
 IllegalStateException
```
 Description copied from interface: TextInductor
 
 Induce the current value of this text into the specified target
 
 Specified by:
 
 induceTextValue in interface TextInductor
 
 Type Parameters:
 TEXT - the target type
 Parameters:
 aTarget - a target into which the current value of this text will be induced
 
 Returns:
 the target
 
 Throws:
 
 NullPointerException - a null value was provided when none was expected
 
 NoSuchElementException - an expected parameter was not found in the parameter source
 
 UnsupportedOperationException - this target primitive cannot be changed
 
 IllegalStateException - this target primitive cannot be changed at this time
 - insert
```
public PRIMITIVE insert(int anIndex,
 boolean aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 char aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 char[] content)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int targetIndex,
 char[] content,
 int contentIndex,
 int contentLength)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 CharSequence content)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int targetIndex,
 CharSequence content,
 int contentIndex)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int targetIndex,
 CharSequence content,
 int contentStartIndex,
 int contentEndIndexPlusOne)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 double aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 float aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 int aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 long aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - insert
```
public PRIMITIVE insert(int anIndex,
 Object aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 insert in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - intPostDecrement
```
public int intPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableIntegerValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 intPostDecrement in interface MutableIntegerValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - intPostIncrement
```
public int intPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableIntegerValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 intPostIncrement in interface MutableIntegerValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - intValue
```
public int intValue()
```
 Specified by:
 
 intValue in interface SealedIntegerValue
 
 Specified by:
 
 intValue in class Number
 
 Returns:
 the property value as a system int
 - invalidate
```
public PRIMITIVE invalidate()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value an invalid value such INVALID if possible, otherwise replace it with zero
 
 Specified by:
 
 invalidate in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 invalidate in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - inverse
```
public PRIMITIVE inverse()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value its multiplicative inverse (1/x)
 
 Specified by:
 
 inverse in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - isAlphabetic
```
public boolean isAlphabetic()
```
 Specified by:
 
 isAlphabetic in interface CharacterProperties
 
 Overrides:
 
 isAlphabetic in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the int value of this object is a proper alphabetical value in Unicode
 See Also:
 Character.isAlphabetic(int)
 - isBmpCodePoint
```
public boolean isBmpCodePoint()
```
 Specified by:
 
 isBmpCodePoint in interface CharacterProperties
 
 Overrides:
 
 isBmpCodePoint in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the int value of this object is a BMP (Basic Multi-lingual Plane) code point in Unicode
 See Also:
 Character.isBmpCodePoint(int)
 - isConfigurable
```
public boolean isConfigurable()
```
 Description copied from interface: StructureProperties
 
 Answer true if the implementation of this object can be changed.
 
 A configurable object has a structure that can be expanded, or reduced, or has replaceable components. Configurable structures are necessarily mutable; in fact, "configurability" can be used as a strict definition of mutability. This predicate however overrides #isMutable in the respect that, for some types of objects such as Variants, mutability can be changed by switching from a non-mutable implementation to a mutable one (e.g., via assertPrecision).
 
 Specified by:
 
 isConfigurable in interface StructureProperties
 
 Overrides:
 
 isConfigurable in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the implementation of this object can be changed
 - isCountable
```
public boolean isCountable()
```
 Description copied from interface: StructureProperties
 
 Answer true if this structure contains a countable number of elements. A countable set is a set with the same cardinality as some subset of the set of natural numbers. A set that is not countable contains an infinite number of elements.
 
 Specified by:
 
 isCountable in interface StructureProperties
 
 Overrides:
 
 isCountable in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this structure contains a countable number of elements, otherwise false if it contains an infinite number of elements
 See Also:
 Countable set (Wikipedia)
 - isDigit
```
public boolean isDigit()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a digit within Unicode
 
 Specified by:
 
 isDigit in interface CharacterProperties
 
 Overrides:
 
 isDigit in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a digit in Unicode
 See Also:
 Character.isDigit(char), Character.isDigit(int)
 - isElastic
```
public boolean isElastic()
```
 Description copied from interface: StructureProperties
 
 Answer true if this structure, in principle, can be reduced via element removal or expanded via element addition. Empty collections are, in principle, reducible, but read-only collections are neither reducible or expandable.
 
 Specified by:
 
 isElastic in interface StructureProperties
 
 Overrides:
 
 isElastic in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this structure can be either reduced or expanded
 - isEmpty
```
public boolean isEmpty()
```
 Description copied from interface: StructureProperties
 
 Answer true if this structure contains no elements. For strings this would indicate an empty string (no characters in an empty array). For scalars this would indicate an empty set, or a zero bit count, which would be the case of null values. Note that, although the null constant technically contains zero elements, its string value evaluates to "null", which from a String perspective is not empty.
 
 Specified by:
 
 isEmpty in interface StructureProperties
 
 Specified by:
 
 isEmpty in interface TextProperties
 
 Overrides:
 
 isEmpty in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this structure contains no elements
 - isEqual
```
public boolean isEqual(BigDecimal aValue)
```
 Specified by:
 
 isEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(BigInteger aValue)
```
 Specified by:
 
 isEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(boolean aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(byte aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(char aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(double aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(float aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(int aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(long aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqual
```
public boolean isEqual(short aValue)
```
 Specified by:
 
 isEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqualToPrimitive
```
public boolean isEqualToPrimitive(SealedPrimitive<?> aPrimitive)
```
 Specified by:
 
 isEqualToPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isEqualToText
```
public boolean isEqualToText(CharSequence aValue)
```
 Specified by:
 
 isEqualToText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isExpandable
```
public boolean isExpandable()
```
 Specified by:
 
 isExpandable in interface StructureProperties
 
 Overrides:
 
 isExpandable in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this structure can be expanded via element insertion
 - isFinite
```
public boolean isFinite()
```
 Specified by:
 
 isFinite in interface NumericProperties
 
 Overrides:
 
 isFinite in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this value represents a valid and finite value
 - isGreater
```
public boolean isGreater(BigDecimal aValue)
```
 Specified by:
 
 isGreater in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(BigInteger aValue)
```
 Specified by:
 
 isGreater in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(boolean aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(byte aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(char aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(double aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(float aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(int aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(long aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreater
```
public boolean isGreater(short aValue)
```
 Specified by:
 
 isGreater in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreater in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(BigDecimal aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(BigInteger aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(boolean aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(byte aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(char aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(double aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(float aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(int aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(long aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqual
```
public boolean isGreaterOrEqual(short aValue)
```
 Specified by:
 
 isGreaterOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isGreaterOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqualToPrimitive
```
public boolean isGreaterOrEqualToPrimitive(SealedPrimitive<?> aPrimitive)
```
 Specified by:
 
 isGreaterOrEqualToPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterOrEqualToText
```
public boolean isGreaterOrEqualToText(CharSequence aValue)
```
 Specified by:
 
 isGreaterOrEqualToText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterThanPrimitive
```
public boolean isGreaterThanPrimitive(SealedPrimitive<?> aPrimitive)
```
 Specified by:
 
 isGreaterThanPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isGreaterThanText
```
public boolean isGreaterThanText(CharSequence aValue)
```
 Specified by:
 
 isGreaterThanText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isHighSurrogate
```
public boolean isHighSurrogate()
```
 Specified by:
 
 isHighSurrogate in interface CharacterProperties
 
 Overrides:
 
 isHighSurrogate in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the char value of this object is a high surrogate in UTF-16 Unicode encoding
 See Also:
 Character.isHighSurrogate(char)
 - isIdentifierIgnorable
```
public boolean isIdentifierIgnorable()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character ignorable character in a Java identifier or a Unicode identifier
 
 Specified by:
 
 isIdentifierIgnorable in interface CharacterProperties
 
 Overrides:
 
 isIdentifierIgnorable in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, ignorable character in a Java identifier or a Unicode identifier as other than the first character
 See Also:
 Character.isIdentifierIgnorable(char), Character.isIdentifierIgnorable(int)
 - isIdeographic
```
public boolean isIdeographic()
```
 Specified by:
 
 isIdeographic in interface CharacterProperties
 
 Overrides:
 
 isIdeographic in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the int value of this object is a Unicode ideographic symbol
 See Also:
 Character.isIdeographic(int)
 - isImaginary
```
public boolean isImaginary()
```
 Description copied from interface: NumericProperties
 
 Answer true if this value represents the magnitude of a vector into the set of imaginary numbers. This is not the same as testing whether this object's implementation resembles the specification for the IMAGINARY domain, since that is too specific to implementation machinery. This more general test also includes imaginary modulo values in its specification.
 
 Specified by:
 
 isImaginary in interface NumericProperties
 
 Overrides:
 
 isImaginary in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this value represents the magnitude of a vector into the set of imaginary numbers
 - isInfinity
```
public boolean isInfinity()
```
 Specified by:
 
 isInfinity in interface NumericProperties
 
 Returns:
 true if this number represents either positive or negative infinity
 - isInvalid
```
public boolean isInvalid()
```
 Specified by:
 
 isInvalid in interface NumericProperties
 
 Returns:
 true if this value does not represent a valid number, such as 0/0 (INVALID)
 See Also:
 INVALID at Wikipedia
 - isISOControl
```
public boolean isISOControl()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is an ISO control character within Unicode
 
 Specified by:
 
 isISOControl in interface CharacterProperties
 
 Overrides:
 
 isISOControl in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is an ISO control character in Unicode
 See Also:
 Character.isISOControl(char), Character.isISOControl(int)
 - isJavaIdentifierPart
```
public boolean isJavaIdentifierPart()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a part of a Java identifier as other than the first character
 
 Specified by:
 
 isJavaIdentifierPart in interface CharacterProperties
 
 Overrides:
 
 isJavaIdentifierPart in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a part of a Java identifier as other than the first character
 See Also:
 Character.isJavaIdentifierPart(char), Character.isJavaIdentifierPart(int)
 - isJavaIdentifierStart
```
public boolean isJavaIdentifierStart()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is permissible as the first character in a Java identifier
 
 Specified by:
 
 isJavaIdentifierStart in interface CharacterProperties
 
 Overrides:
 
 isJavaIdentifierStart in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is permissible as the first character in a Java identifier
 See Also:
 Character.isJavaIdentifierStart(char), Character.isJavaIdentifierStart(int)
 - isLess
```
public boolean isLess(BigDecimal aValue)
```
 Specified by:
 
 isLess in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(BigInteger aValue)
```
 Specified by:
 
 isLess in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(boolean aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(byte aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(char aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(double aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(float aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(int aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(long aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLess
```
public boolean isLess(short aValue)
```
 Specified by:
 
 isLess in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLess in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(BigDecimal aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(BigInteger aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(boolean aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(byte aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(char aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(double aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(float aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(int aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(long aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqual
```
public boolean isLessOrEqual(short aValue)
```
 Specified by:
 
 isLessOrEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isLessOrEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqualToPrimitive
```
public boolean isLessOrEqualToPrimitive(SealedPrimitive<?> aPrimitive)
```
 Specified by:
 
 isLessOrEqualToPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessOrEqualToText
```
public boolean isLessOrEqualToText(CharSequence aValue)
```
 Specified by:
 
 isLessOrEqualToText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessThanPrimitive
```
public boolean isLessThanPrimitive(SealedPrimitive<?> aPrimitive)
```
 Specified by:
 
 isLessThanPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLessThanText
```
public boolean isLessThanText(CharSequence aValue)
```
 Specified by:
 
 isLessThanText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isLetter
```
public boolean isLetter()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a letter within Unicode
 
 Specified by:
 
 isLetter in interface CharacterProperties
 
 Overrides:
 
 isLetter in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a letter in Unicode
 See Also:
 Character.isLetter(char), Character.isLetter(int)
 - isLetterOrDigit
```
public boolean isLetterOrDigit()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a letter or digit within Unicode
 
 Specified by:
 
 isLetterOrDigit in interface CharacterProperties
 
 Overrides:
 
 isLetterOrDigit in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a letter or digit in Unicode
 See Also:
 Character.isLetterOrDigit(char), Character.isLetterOrDigit(int)
 - isLowerCase
```
public boolean isLowerCase()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a lower case character within Unicode
 
 Specified by:
 
 isLowerCase in interface CharacterProperties
 
 Overrides:
 
 isLowerCase in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a lower case character in Unicode
 See Also:
 Character.isLowerCase(char), Character.isLowerCase(int)
 - isLowSurrogate
```
public boolean isLowSurrogate()
```
 Specified by:
 
 isLowSurrogate in interface CharacterProperties
 
 Overrides:
 
 isLowSurrogate in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the char value of this object is a low surrogate in UTF-16 Unicode encoding
 See Also:
 Character.isLowSurrogate(char)
 - isMaximum
```
public boolean isMaximum()
```
 Specified by:
 
 isMaximum in interface NumericProperties
 
 Returns:
 true if this value represents the maximum rational value in the totally ordered set it represents
 - isMinimum
```
public boolean isMinimum()
```
 Specified by:
 
 isMinimum in interface NumericProperties
 
 Returns:
 true if this value represents the minimum rational value in the totally ordered set it represents
 - isMirrored
```
public boolean isMirrored()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is "mirrored" within Unicode
 
 Specified by:
 
 isMirrored in interface CharacterProperties
 
 Overrides:
 
 isMirrored in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is "mirrored" in Unicode
 See Also:
 Character.isMirrored(char), Character.isMirrored(int)
 - isModulo
```
public boolean isModulo()
```
 Description copied from interface: NumericProperties
 
 Answer true if this value represents the magnitude of a vector into a modulo set, or finite ring. This is not the same as testing whether this object's implementation resembles the specification for the MODULO domain, since that is too specific to implementation machinery. Modulo values, for instance can either be real or imaginary.
 
 Specified by:
 
 isModulo in interface NumericProperties
 
 Returns:
 true if this value represents the magnitude of a vector into a modulo set, or finite ring
 - isMutable
```
public boolean isMutable()
```
 Specified by:
 
 isMutable in interface Mutable
 
 Overrides:
 
 isMutable in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if modification of the implementation is allowed and that none of the modification functions will, in principle, throw UnsupportedOperationExceptions
 - isNegative
```
public boolean isNegative()
```
 Specified by:
 
 isNegative in interface NumericProperties
 
 Returns:
 true if this value represents a negative value
 - isNegativeFinite
```
public boolean isNegativeFinite()
```
 Specified by:
 
 isNegativeFinite in interface NumericProperties
 
 Overrides:
 
 isNegativeFinite in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this value represents a valid, finite and negative value
 - isNegativeInfinity
```
public boolean isNegativeInfinity()
```
 Specified by:
 
 isNegativeInfinity in interface NumericProperties
 
 Returns:
 true if this value represents negative infinity
 - isNotEqual
```
public boolean isNotEqual(BigDecimal aValue)
```
 Specified by:
 
 isNotEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(BigInteger aValue)
```
 Specified by:
 
 isNotEqual in interface SealedReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(boolean aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(byte aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(char aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(double aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(float aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(int aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(long aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqual
```
public boolean isNotEqual(short aValue)
```
 Specified by:
 
 isNotEqual in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 isNotEqual in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqualToPrimitive
```
public boolean isNotEqualToPrimitive(SealedPrimitive<?> aPrimitive)
```
 Specified by:
 
 isNotEqualToPrimitive in interface SealedPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isNotEqualToText
```
public boolean isNotEqualToText(CharSequence aValue)
```
 Specified by:
 
 isNotEqualToText in interface SealedText<PRIMITIVE extends Primitive<PRIMITIVE>>
 - isOrdered
```
public boolean isOrdered()
```
 Description copied from interface: StructureProperties
 
 Answer true if the elements of this structure necessarily share a partial or total order between each other within the context of this structure. Ordering does not necessarily imply a simple sequencing between randomly selected elements, but rather a necessary sorting order between elements independent of the sets they are related by. A SortedSet is ordered, not merely because its elements are de facto sorted, but because the SortedSet defines a universe in which only sortable elements can exist and it defines a sorting function which places those elements in their sorted order at the time of iteration. An ordered set has elements with values that are reflexive, antisymmetric, and transitive relative to each other. Necessarily empty sets are not considered ordered.
 
 Specified by:
 
 isOrdered in interface StructureProperties
 
 Overrides:
 
 isOrdered in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the structure has either a partial or total order over its elements
 See Also:
 order theory (Wikipedia)
 - isPositive
```
public boolean isPositive()
```
 Specified by:
 
 isPositive in interface NumericProperties
 
 Returns:
 true if this value represents a positive value
 - isPositiveFinite
```
public boolean isPositiveFinite()
```
 Specified by:
 
 isPositiveFinite in interface NumericProperties
 
 Overrides:
 
 isPositiveFinite in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this value represents a valid, finite and negative value
 - isPositiveInfinity
```
public boolean isPositiveInfinity()
```
 Specified by:
 
 isPositiveInfinity in interface NumericProperties
 
 Returns:
 true if this value represents positive infinity
 - isReal
```
public boolean isReal()
```
 Description copied from interface: NumericProperties
 
 Answer true if this value represents the magnitude of a vector into the set of real numbers. This is not the same as testing whether this object's implementation resembles the specification for the REAL domain, since that is too specific to implementation machinery. This more general test also includes real modulo values in its specification.
 
 Specified by:
 
 isReal in interface NumericProperties
 
 Returns:
 true if this value represents the magnitude of a vector into the set of real numbers
 - isReducible
```
public boolean isReducible()
```
 Description copied from interface: StructureProperties
 
 Answer true if this structure, in principle, can be reduced via element removal. Empty collections are, in principle, reducible, but read-only collections are not.
 
 Specified by:
 
 isReducible in interface StructureProperties
 
 Overrides:
 
 isReducible in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if this structure, in principle, can be reduced via element removal
 - isSupplementaryCodePoint
```
public boolean isSupplementaryCodePoint()
```
 Specified by:
 
 isSupplementaryCodePoint in interface CharacterProperties
 
 Overrides:
 
 isSupplementaryCodePoint in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the int value of this object is a supplementary code point in Unicode
 See Also:
 Character.isSupplementaryCodePoint(int)
 - isSurrogate
```
public boolean isSurrogate()
```
 Specified by:
 
 isSurrogate in interface CharacterProperties
 
 Overrides:
 
 isSurrogate in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the char value of this object is a surrogate value (high or low) in Unicode
 See Also:
 Character.isSurrogate(char)
 - isText
```
public boolean isText()
```
 Specified by:
 
 isText in interface TextProperties
 
 Returns:
 true if this object utilizes a text-based implementation
 - isTitleCase
```
public boolean isTitleCase()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a title case character within Unicode
 
 Specified by:
 
 isTitleCase in interface CharacterProperties
 
 Overrides:
 
 isTitleCase in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a title case character in Unicode
 See Also:
 Character.isTitleCase(char), Character.isTitleCase(int)
 - isUnicode
```
public boolean isUnicode()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is defined within Unicode
 
 Specified by:
 
 isUnicode in interface CharacterProperties
 
 Overrides:
 
 isUnicode in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is defined in Unicode
 See Also:
 Character.isDefined(char), Character.isDefined(int)
 - isUnicodeIdentifierPart
```
public boolean isUnicodeIdentifierPart()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is a part of a Unicode identifier as other than the first character
 
 Specified by:
 
 isUnicodeIdentifierPart in interface CharacterProperties
 
 Overrides:
 
 isUnicodeIdentifierPart in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is a part of a Unicode identifier as other than the first character
 See Also:
 Character.isUnicodeIdentifierPart(char), Character.isUnicodeIdentifierPart(int)
 - isUnicodeIdentifierStart
```
public boolean isUnicodeIdentifierStart()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is permissible as the first character in a Unicode identifier
 
 Specified by:
 
 isUnicodeIdentifierStart in interface CharacterProperties
 
 Overrides:
 
 isUnicodeIdentifierStart in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is permissible as the first character in a Unicode identifier
 See Also:
 Character.isUnicodeIdentifierStart(char), Character.isUnicodeIdentifierStart(int)
 - isUnique
```
public boolean isUnique()
```
 Specified by:
 
 isUnique in interface StructureProperties
 
 Overrides:
 
 isUnique in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the elements in this structure are, by definition of the structure's algebra, unique (e.g., sets)
 - isUnity
```
public boolean isUnity()
```
 Description copied from interface: NumericProperties
 
 Answer true if this value represents the multiplicative identity in its arithmetic domain. For real numbers this is 1, for matrices it would be the identity matrix and for functions this would be a pass-through.
 
 Specified by:
 
 isUnity in interface NumericProperties
 
 Returns:
 true if this value represents the multiplicative identity in its domain
 - isUpperCase
```
public boolean isUpperCase()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is an upper case character within Unicode
 
 Specified by:
 
 isUpperCase in interface CharacterProperties
 
 Overrides:
 
 isUpperCase in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is an upper case character in Unicode
 See Also:
 Character.isUpperCase(char), Character.isUpperCase(int)
 - isValidCodePoint
```
public boolean isValidCodePoint()
```
 Specified by:
 
 isValidCodePoint in interface CharacterProperties
 
 Overrides:
 
 isValidCodePoint in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the int value of this object is a valid code point in Unicode
 See Also:
 Character.isValidCodePoint(int)
 - isWhitespace
```
public boolean isWhitespace()
```
 Description copied from interface: CharacterProperties
 
 Determine if this char-width or int-width character is whitespace within Unicode
 
 Specified by:
 
 isWhitespace in interface CharacterProperties
 
 Overrides:
 
 isWhitespace in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 true if the scalar value of this object, as appropriate for this objects's precision, is whitespace in Unicode
 See Also:
 Character.isWhitespace(char), Character.isWhitespace(int)
 - isZero
```
public boolean isZero()
```
 Description copied from interface: NumericProperties
 
 Answer true if this value represents the additive identity in its algebraic group. For real numbers this is 0, for matrices this would be the zero matrix and for functions this would map every parameter to zero.
 
 Specified by:
 
 isZero in interface NumericProperties
 
 Returns:
 true if this value represents the additive identity in its algebraic group
 - length
```
public int length()
```
 Specified by:
 
 length in interface CharSequence
 - longPostDecrement
```
public long longPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableLongValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 longPostDecrement in interface MutableLongValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - longPostIncrement
```
public long longPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableLongValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 longPostIncrement in interface MutableLongValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - longSize
```
public long longSize()
```
 Description copied from interface: SealedAlgebraicStructure
 
 Returns the number of elements in this algebraic structure as a long scalar. If the structure contains more than Long.MAX_VALUE elements, returns Long.MAX_VALUE.
 
 Specified by:
 
 longSize in interface SealedAlgebraicStructure
 
 Overrides:
 
 longSize in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the number of elements in this algebraic structure as a long scalar
 See Also:
 Collection.size(), SealedAlgebraicStructure.size()
 - longValue
```
public long longValue()
```
 Specified by:
 
 longValue in interface SealedLongValue
 
 Specified by:
 
 longValue in class Number
 
 Returns:
 the property value as a system long
 - lowerCase
```
public PRIMITIVE lowerCase()
```
 Description copied from interface: MutableTextValue
 
 For text-based objects, convert all characters in the text to lower case. For numeric objects, convert their character (BMP) or integer value (Unicode) to lower case, depending on the object's precision level
 
 Specified by:
 
 lowerCase in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 - milliseconds
```
public PRIMITIVE milliseconds()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableScalar
 
 Set the value of this object to the current millisecond-precision system time
 
 Specified by:
 
 milliseconds in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 milliseconds in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 - mod
```
public PRIMITIVE mod(BigDecimal aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(float aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - mod
```
public PRIMITIVE mod(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to its current value modulo of the specified value
 
 Specified by:
 
 mod in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 mod in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a modulus
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - nanoseconds
```
public PRIMITIVE nanoseconds()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableScalar
 
 Set the value of this object to the current nanosecond-precision system time
 
 Specified by:
 
 nanoseconds in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 nanoseconds in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 - naturalLog
```
public PRIMITIVE naturalLog()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with its base e (Napier's constant) logarithm (log_e(n))
 
 Specified by:
 
 naturalLog in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 naturalLog in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 See Also:
 e (Wikipedia)
 - naturalLogPlusOne
```
public PRIMITIVE naturalLogPlusOne()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, plus 1, with its base e (Napier's constant) logarithm (log_e(n+1))
 
 Specified by:
 
 naturalLogPlusOne in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 naturalLogPlusOne in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 See Also:
 e (Wikipedia)
 - negate
```
public PRIMITIVE negate()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the additive inverse (sign negation) of itself, that is transform it into a number that when added to the original yields zero. (Though additive inverses for non-zero boolean and char values do not exist, these implementations will simply fail silently.)
 
 Specified by:
 
 negate in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object (optional)
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification (optional)
 - not
```
public PRIMITIVE not()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current integral binary vector with its one's complement. Decimal values, such as double, will be first converted to unlimited integers before their bits are reversed.
 
 Specified by:
 
 not in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - or
```
public PRIMITIVE or(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 or in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 or in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - power
```
public PRIMITIVE power(double n)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the current value, x, raised to the specified exponent, n, or xⁿ
 
 Specified by:
 
 power in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 power in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 n - an exponent
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - power
```
public PRIMITIVE power(int n)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the current value, x, raised to the specified exponent, n, or xⁿ
 
 Specified by:
 
 power in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 power in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 n - an exponent
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - prepend
```
public PRIMITIVE prepend(boolean aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(char aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(char[] content)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(char[] content,
 int contentIndex)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(char[] content,
 int contentIndex,
 int contentLength)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(CharSequence content)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(CharSequence content,
 int contentIndex)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(CharSequence content,
 int contentStartIndex,
 int contentEndIndexPlusOne)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(double aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(float aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(int aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(long aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - prepend
```
public PRIMITIVE prepend(Object aValue)
 throws UnsupportedOperationException
```
 Specified by:
 
 prepend in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - product
```
public PRIMITIVE product(BigDecimal aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(float aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - product
```
public PRIMITIVE product(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical product of its current value and the specified value
 
 Specified by:
 
 product in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 product in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a multiplicand
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - promoteTo
```
public PRIMITIVE promoteTo(NumericPrecision prec)
```
 Description copied from interface: MutableScalarDomain
 
 If this object's implementation is less precise than the specified numeric precision, then convert this implementation to the closest available match for the proposed precision. Note that the precision of this implementation may not change as a result of calling this function if the proposed precision is less precise than the this object's current precision level or if this structure is not {@link StructureProperties#isConfigurable() configurable).
 
 Specified by:
 
 promoteTo in interface MutableScalarDomain<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 promoteTo in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 prec - the proposed precision
 
 Returns:
 this object (facilitates operation chaining)
 See Also:
 StructureProperties.isConfigurable()
 - quotient
```
public PRIMITIVE quotient(BigDecimal aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical quotient between its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical quotient between its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient between its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient of its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient between its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient of its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(float aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient of its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient of its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient of its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - quotient
```
public PRIMITIVE quotient(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical quotient of its current value and the specified value
 
 Specified by:
 
 quotient in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 quotient in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a divisor
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - radians
```
public PRIMITIVE radians()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in degrees, to its equivalent angle in radians
 
 Specified by:
 
 radians in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 radians in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - random
```
public PRIMITIVE random()
 throws UnsupportedOperationException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with an evenly-distributed random value between zero (inclusive) and unity (exclusive for floating point, inclusive for integrals)
 
 Specified by:
 
 random in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 random in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 - replace
```
public PRIMITIVE replace(CharSequence target,
 CharSequence replacement)
```
 Specified by:
 
 replace in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 - replace
```
public PRIMITIVE replace(int start,
 int end,
 String str)
 throws UnsupportedOperationException
```
 Specified by:
 
 replace in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - replaceAll
```
public PRIMITIVE replaceAll(String regex,
 String replacement)
```
 Specified by:
 
 replaceAll in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 - replaceCharacter
```
public PRIMITIVE replaceCharacter(char oldChar,
 char newChar)
```
 Specified by:
 
 replaceCharacter in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 - replaceFirst
```
public PRIMITIVE replaceFirst(String regex,
 String replacement)
```
 Specified by:
 
 replaceFirst in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 - reverse
```
public PRIMITIVE reverse()
 throws UnsupportedOperationException
```
 Specified by:
 
 reverse in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - round
```
public PRIMITIVE round(RoundingStrategy aRoundingStrategy)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutableScalar
 
 Round the current value using the specified rounding strategy
 
 Specified by:
 
 round in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 NullPointerException
 - setBoolean
```
public PRIMITIVE setBoolean(Boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutablePrimitive
 
 Set this property to the specified system-supported Boolean and answer this object (facilitates chaining)
 
 Specified by:
 
 setBoolean in interface MutablePrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a system-supported Boolean
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setCharacter
```
public PRIMITIVE setCharacter(Character aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutablePrimitive
 
 Set this property to the specified system-supported Character and answer this object (facilitates chaining)
 
 Specified by:
 
 setCharacter in interface MutablePrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a system-supported Character
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setCharAt
```
public PRIMITIVE setCharAt(int index,
 char ch)
 throws UnsupportedOperationException
```
 Specified by:
 
 setCharAt in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - setE
```
public PRIMITIVE setE()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with e, or Napier's constant
 
 Specified by:
 
 setE in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setE in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 See Also:
 e (Wikipedia)
 - setEnumeration
```
public <E extends Enum<E>> PRIMITIVE setEnumeration(E aValue)
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException,
 NullPointerException
```
 Description copied from interface: MutableScalar
 
 Match the value of this object with the identity of the specified enumeration instance, then answer this object (facilitates chaining)
 
 Specified by:
 
 setEnumeration in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setEnumeration in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a system-supported enumeration
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setFalse
```
public PRIMITIVE setFalse()
 throws UnsupportedOperationException,
 ArithmeticException
```
 Description copied from interface: MutableBooleanValue
 
 Set this property to its equivalent of true and answer this object (facilitates chaining)
 
 Specified by:
 
 setFalse in interface MutableBooleanValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setFalse in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new value was incompatible with with algebraic interpretation of this object
 - setLength
```
public PRIMITIVE setLength(int newLength)
 throws UnsupportedOperationException
```
 Specified by:
 
 setLength in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Throws:
 
 UnsupportedOperationException
 - setMaximum
```
public PRIMITIVE setMaximum()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with maximum value available for the implementation's numeric precision. Unlimited values will be replaced with the maximum value available for the most precise system scalar appropriate for the implementation, that is unlimited integer primitives will set themselves to the maximum long value and unlimited decimal primitives will set themselves to the maximum double value.
 
 Specified by:
 
 setMaximum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - setMinimum
```
public PRIMITIVE setMinimum()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with minimum value available for the implementation's numeric precision. Unlimited values will be replaced with the minimum value available for the most precise system scalar appropriate for the implementation, that is unlimited integer primitives will set themselves to the minimum long value and unlimited decimal primitives will set themselves to the minimum double value.
 
 Specified by:
 
 setMinimum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - setNegativeInfinity
```
public PRIMITIVE setNegativeInfinity()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with a representation of negative infinity, if available, otherwise replace with the implementation's minimum value
 
 Specified by:
 
 setNegativeInfinity in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setNegativeInfinity in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - setPi
```
public PRIMITIVE setPi()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with Pi
 
 Specified by:
 
 setPi in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setPi in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - setPositiveInfinity
```
public PRIMITIVE setPositiveInfinity()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with a representation of positive infinity, if available, otherwise replace with the implementation's maximum value
 
 Specified by:
 
 setPositiveInfinity in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setPositiveInfinity in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - setPrimitive
```
public final PRIMITIVE setPrimitive(SealedPrimitive<?> aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutablePrimitive
 
 Set this property to the specified primitive
 
 Specified by:
 
 setPrimitive in interface MutablePrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a primitive
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setReal
```
public PRIMITIVE setReal(BigDecimal aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutableUnlimitedDecimalValue
 
 Set this property to the specified unlimited decimal value and answer this object (facilitates chaining)
 
 Specified by:
 
 setReal in interface MutableUnlimitedDecimalValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an unlimited decimal value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setReal
```
public PRIMITIVE setReal(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutableUnlimitedIntegerValue
 
 Set this property to the specified unlimited integer value and answer this object (facilitates chaining)
 
 Specified by:
 
 setReal in interface MutableUnlimitedIntegerValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an unlimited integer value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setScalar
```
public PRIMITIVE setScalar(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableBooleanValue
 
 Set this property to the specified boolean value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableBooleanValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a boolean value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableByteValue
 
 Set this property to the specified byte value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableByteValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a byte value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableCharacterValue
 
 Set this property to the specified char value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableCharacterValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a char value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableDoubleValue
 
 Set this property to the specified double value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableDoubleValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a double value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(float aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableFloatValue
 
 Set this property to the specified float value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableFloatValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a float value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableIntegerValue
 
 Set this property to the specified int value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableIntegerValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an int value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableLongValue
 
 Set this property to the specified long value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableLongValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a long value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setScalar
```
public PRIMITIVE setScalar(SealedScalar<?> aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException,
 NullPointerException
```
 Description copied from interface: MutableScalar
 
 Set this object to the specified scalar
 
 Specified by:
 
 setScalar in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a scalar
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 NullPointerException - a null value was provided though this object does not accept null values
 - setScalar
```
public PRIMITIVE setScalar(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableShortValue
 
 Set this property to the specified short value and answer this object (facilitates chaining)
 
 Specified by:
 
 setScalar in interface MutableShortValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - a short value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 - setText
```
public PRIMITIVE setText(CharSequence content)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 NullPointerException
```
 Description copied from interface: MutableTextValue
 
 Set this property to the specified text value and answer this object (facilitates chaining)
 
 Specified by:
 
 setText in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 content - a text value
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 NullPointerException - a null value was provided and this implementation does not accept null values
 - setTrue
```
public PRIMITIVE setTrue()
 throws UnsupportedOperationException,
 ArithmeticException
```
 Description copied from interface: MutableBooleanValue
 
 Set this property to its equivalent of true and answer this object (facilitates chaining)
 
 Specified by:
 
 setTrue in interface MutableBooleanValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setTrue in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new value was incompatible with with algebraic interpretation of this object
 - setUnity
```
public PRIMITIVE setUnity()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the multiplicative identity appropriate for the implementation (one)
 
 Specified by:
 
 setUnity in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setUnity in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - setZero
```
public PRIMITIVE setZero()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the additive identity appropriate for the implementation (zero)
 
 Specified by:
 
 setZero in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 setZero in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - shiftLeft
```
public PRIMITIVE shiftLeft(int count)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Attempt to shift the elements of this tuple to the "left" the specified number of ordinal positions. In a bit sequence this functions resorts to the familiar "left shift" process (e.g., Java <<). In other sequences, the specified number of default values will be prepended to the beginning of the sequence, increasing the ordinal position of all existing elements by the specified count.
 
 Specified by:
 
 shiftLeft in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 count - the number of default values to be prepended to this sequence
 
 Returns:
 this structure (facilitates chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed or if this structure is not an algebraic tuple
 
 IllegalArgumentException - if the specified value was incommensurate with this structure's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this structure
 - shiftRight
```
public PRIMITIVE shiftRight(int count)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Attempt to shift the elements of this tuple to the "right" the specified number of ordinal positions. In a bit sequence this functions resorts to the familiar "right shift" process, with sign extension (e.g., the Java >> operator). In other sequences, the specified number of values will be removed from the beginning of the sequence, decreasing the ordinal position of all remaining elements by the specified count.
 
 Specified by:
 
 shiftRight in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 count - the number of values to be removed from the beginning of this sequence
 
 Returns:
 this structure (facilitates chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed or if this structure is not an algebraic tuple
 
 IllegalArgumentException - if the specified value was incommensurate with this structure's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this structure
 - shiftRightExtendZero
```
public PRIMITIVE shiftRightExtendZero(int count)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Attempt to shift the elements of this tuple to the "right" the specified number of ordinal positions without sign extension. In a bit sequence this functions resorts to the familiar "right shift" process, with zero extension (e.g., the Java >>> operator). In other sequences, the specified number of values will be removed from the beginning of the sequence, decreasing the ordinal position of all remaining elements by the specified count.
 
 Specified by:
 
 shiftRightExtendZero in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 shiftRightExtendZero in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 count - the number of values to be removed from the beginning of this sequence
 
 Returns:
 this structure (facilitates chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed or if this structure is not an algebraic tuple
 
 IllegalArgumentException - if the specified value was incommensurate with this structure's specification
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this structure
 - shortPostDecrement
```
public short shortPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableShortValue
 
 Decrement the scalar value of this object then return the original value prior to decrementing
 
 Specified by:
 
 shortPostDecrement in interface MutableShortValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - shortPostIncrement
```
public short shortPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableShortValue
 
 Increment the scalar value of this object then return the original value prior to incrementing
 
 Specified by:
 
 shortPostIncrement in interface MutableShortValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this scalar
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - shortValue
```
public short shortValue()
```
 Specified by:
 
 shortValue in interface SealedShortValue
 
 Overrides:
 
 shortValue in class Number
 
 Returns:
 the property value as a system short
 - signum
```
public int signum()
```
 Specified by:
 
 signum in interface NumericProperties
 
 Overrides:
 
 signum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 zero if this number is zero, -1 if this number is negative or +1 if it is positive
 - sine
```
public PRIMITIVE sine()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its sine
 
 Specified by:
 
 sine in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sine in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - size
```
public int size()
```
 Description copied from interface: SealedAlgebraicStructure
 
 Returns the number of elements in this algebraic structure. If the structure contains more than Integer.MAX_VALUE elements, returns Integer.MAX_VALUE.
 
 Specified by:
 
 size in interface SealedAlgebraicStructure
 
 Overrides:
 
 size in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the number of elements in this algebraic structure
 See Also:
 Collection.size()
 - square
```
public PRIMITIVE square()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the square of itself
 
 Specified by:
 
 square in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - squareRoot
```
public PRIMITIVE squareRoot()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value with the square root of itself
 
 Specified by:
 
 squareRoot in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 squareRoot in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - subSequence
```
public CharSequence subSequence(int start,
 int end)
```
 Specified by:
 
 subSequence in interface CharSequence
 - substring
```
public String substring(int beginIndex)
 throws IndexOutOfBoundsException
```
 Specified by:
 
 substring in interface SealedTextValue
 
 Throws:
 
 IndexOutOfBoundsException
 - substring
```
public String substring(int beginIndex,
 int endIndex)
 throws IndexOutOfBoundsException
```
 Specified by:
 
 substring in interface SealedTextValue
 
 Throws:
 
 IndexOutOfBoundsException
 - sum
```
public PRIMITIVE sum(BigDecimal aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(double aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(float aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - sum
```
public PRIMITIVE sum(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set the value of this scalar to the mathematical sum of its current value and the specified value
 
 Specified by:
 
 sum in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 sum in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an addend
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - swapPrimitives
```
public PRIMITIVE swapPrimitives(Primitive<?> aValue)
```
 Description copied from interface: Primitive
 
 Swap the value of this primitive for the specified one and set the specified primitive's value to the current value of this primitive
 
 Specified by:
 
 swapPrimitives in interface Primitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - the primitive to swap with
 
 Returns:
 this primitive
 - tangent
```
public PRIMITIVE tangent()
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Replace the current value, assumed to be an angle in radians, to its tangent
 
 Specified by:
 
 tangent in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 tangent in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - textPostDecrement
```
public String textPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableTextValue
 
 Decrement the real value of this text then return the original text prior to decrementing
 
 Specified by:
 
 textPostDecrement in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this text
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - textPostIncrement
```
public String textPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableTextValue
 
 Increment the real value of this text then return the original text prior to incrementing
 
 Specified by:
 
 textPostIncrement in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this text
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - titleCase
```
public PRIMITIVE titleCase()
```
 Description copied from interface: MutableTextValue
 
 For text-based objects, convert all characters in the text to title case. For numeric objects, convert their character (BMP) or integer value (Unicode) to title case, depending on the object's precision level
 
 Specified by:
 
 titleCase in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 - toBoolean
```
public Boolean toBoolean()
```
 Specified by:
 
 toBoolean in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toBoolean in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object as a best-match, system-supported Boolean object
 - toCharacter
```
public Character toCharacter()
```
 Specified by:
 
 toCharacter in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toCharacter in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object as a best-match, system-supported Boolean object
 - toCodePoint
```
public int toCodePoint()
```
 Description copied from interface: SealedScalar
 
 Represent the value of this object as a code point
 
 Specified by:
 
 toCodePoint in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toCodePoint in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the value of this object represented as a single code point
 - toEnumeration
```
public <E extends Enum<E>> E toEnumeration(Class<E> anEnumerationClass)
 throws ArithmeticException,
 IllegalArgumentException,
 NullPointerException
```
 Description copied from interface: SealedScalar
 
 Represent the value of this object as an appropriate member of the class of the specified enumeration
 
 Specified by:
 
 toEnumeration in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toEnumeration in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 anEnumerationClass - the class of enumeration to convert to
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 ArithmeticException - the numeric value provided was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the specified value was incommensurate with this object's specification
 
 NullPointerException - a null value was provided though this object does not accept null values
 - toNumber
```
public Number toNumber()
```
 Specified by:
 
 toNumber in interface SealedScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object as a best-match, system-supported Number object
 - toPrimitive
```
public Primitive<?> toPrimitive()
```
 Description copied from interface: PrimitiveReplicator
 
 If this object is already primitive then simply call its Replicator.copy() function, otherwise convert it to a new Primitive instance
 
 Specified by:
 
 toPrimitive in interface PrimitiveReplicator<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toPrimitive in class AbstractPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 a new Primitive
 - toReal
```
public Real<?> toReal()
```
 Description copied from interface: RealReplicator
 
 If this real is already a real number real then simply call its Replicator.copy() function, otherwise produce a new real number real
 
 Specified by:
 
 toReal in interface RealReplicator<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toReal in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 a new real number real
 - toScalar
```
public Scalar<?> toScalar()
```
 Description copied from interface: ScalarReplicator
 
 If this scalar is already a scalar then simply call its Replicator.copy() function, otherwise produce a new scalar with scalar precision
 
 Specified by:
 
 toScalar in interface ScalarReplicator<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 toScalar in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 a new scalar scalar
 - toString
```
public String toString()
```
 Specified by:
 
 toString in interface CharSequence
 
 Specified by:
 
 toString in interface SealedKernel
 
 Overrides:
 
 toString in class Object
 - toUnlimitedDecimal
```
public BigDecimal toUnlimitedDecimal()
```
 Specified by:
 
 toUnlimitedDecimal in interface SealedUnlimitedDecimalValue
 
 Returns:
 the property value as an unlimited decimal property value
 - toUnlimitedInteger
```
public BigInteger toUnlimitedInteger()
```
 Specified by:
 
 toUnlimitedInteger in interface SealedUnlimitedIntegerValue
 
 Returns:
 the property value as an unlimited integer property value
 - trim
```
public PRIMITIVE trim()
```
 Description copied from interface: MutableTextValue
 
 Remove both leading and trailing whitespace
 
 Specified by:
 
 trim in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 - unlimitedDecimalPostDecrement
```
public BigDecimal unlimitedDecimalPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableUnlimitedDecimalValue
 
 Decrement the real value of this object then return the original value prior to decrementing
 
 Specified by:
 
 unlimitedDecimalPostDecrement in interface MutableUnlimitedDecimalValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this real
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - unlimitedDecimalPostIncrement
```
public BigDecimal unlimitedDecimalPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableUnlimitedDecimalValue
 
 Increment the real value of this object then return the original value prior to incrementing
 
 Specified by:
 
 unlimitedDecimalPostIncrement in interface MutableUnlimitedDecimalValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this real
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - unlimitedIntegerPostDecrement
```
public BigInteger unlimitedIntegerPostDecrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableUnlimitedIntegerValue
 
 Decrement the real value of this object then return the original value prior to decrementing
 
 Specified by:
 
 unlimitedIntegerPostDecrement in interface MutableUnlimitedIntegerValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this real
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - unlimitedIntegerPostIncrement
```
public BigInteger unlimitedIntegerPostIncrement()
 throws UnsupportedOperationException,
 ArithmeticException,
 IllegalArgumentException
```
 Description copied from interface: MutableUnlimitedIntegerValue
 
 Increment the real value of this object then return the original value prior to incrementing
 
 Specified by:
 
 unlimitedIntegerPostIncrement in interface MutableUnlimitedIntegerValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 the original value of this real
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 - upperCase
```
public PRIMITIVE upperCase()
```
 Description copied from interface: MutableTextValue
 
 For text-based objects, convert all characters in the text to upper case. For numeric objects, convert their character (BMP) or integer value (Unicode) to upper case, depending on the object's precision level
 
 Specified by:
 
 upperCase in interface MutableTextValue<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Returns:
 this object (facilitates operation chaining)
 - xor
```
public PRIMITIVE xor(BigInteger aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableReal
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - xor
```
public PRIMITIVE xor(boolean aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - xor
```
public PRIMITIVE xor(byte aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - xor
```
public PRIMITIVE xor(char aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - xor
```
public PRIMITIVE xor(int aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - xor
```
public PRIMITIVE xor(long aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object
 - xor
```
public PRIMITIVE xor(short aValue)
 throws UnsupportedOperationException,
 IllegalArgumentException,
 ArithmeticException
```
 Description copied from interface: MutableScalar
 
 Set this value to the bit exclusive-or of the integral boolean vector equivalent of this value and the specified integral boolean vector
 
 Specified by:
 
 xor in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Overrides:
 
 xor in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
 
 Parameters:
 aValue - an integral boolean vector
 
 Returns:
 this object (facilitates operation chaining)
 
 Throws:
 
 UnsupportedOperationException - if this object's value cannot be changed
 
 IllegalArgumentException - if the new value was incommensurate with this object's specification
 
 ArithmeticException - the new numeric value was incompatible with with algebraic interpretation of this object

Class AbstractPrimitiveWrapper<PRIMITIVE extends Primitive<PRIMITIVE>>

Field Summary

Fields inherited from class net.sf.jaccumulator.scalars.AbstractScalar

Constructor Summary

Method Summary

Methods inherited from class net.sf.jaccumulator.primitives.AbstractPrimitive

Methods inherited from class net.sf.jaccumulator.reals.AbstractReal

Methods inherited from class net.sf.jaccumulator.scalars.AbstractScalar

Methods inherited from class java.lang.Object

Methods inherited from interface net.sf.jaccumulator.primitives.PrimitiveReplicator

Methods inherited from interface net.sf.jaccumulator.primitives.MutablePrimitive

Methods inherited from interface net.sf.jaccumulator.reals.SealedReal

Methods inherited from interface net.sf.jaccumulator.scalars.SealedScalar

Methods inherited from interface net.sf.jaccumulator.scalars.NumericProperties

Methods inherited from interface net.sf.jaccumulator.reals.RealReplicator

Methods inherited from interface net.sf.jaccumulator.scalars.ScalarReplicator

Methods inherited from interface net.sf.jaccumulator.Replicator

Methods inherited from interface net.sf.jaccumulator.reals.MutableReal

Methods inherited from interface net.sf.jaccumulator.scalars.MutableScalar

Methods inherited from interface net.sf.jaccumulator.texts.TextReplicator

Constructor Detail

AbstractPrimitiveWrapper

Method Detail

getTarget

absoluteValue

and

and

and

and

and

and

and

angleWith

append

append

append

append

append

append

append

append

append

append

append

append

append

append

appendCodePoint

arcCosine

arcSine

arcTangent

assertDomain

assertPrecision

base10Log

booleanPostDecrement

booleanPostIncrement

booleanValue

bytePostDecrement

bytePostIncrement

byteValue

charAt

charPostDecrement

charPostIncrement

charValue

clear

clearContents

clearText

codePointAt

codePointBefore

codePointCount

compareTo

compareToPrimitive

compareToScalar

compareToScalar

compareToScalar

compareToScalar

compareToScalar

compareToScalar

compareToScalar

compareToScalar