PRIMITIVE
- this primitive type (used to facilitate operation chaining on write
operations)public abstract class AbstractNumericPrimitive<PRIMITIVE extends Primitive<PRIMITIVE>> extends AbstractPrimitive<PRIMITIVE>
real
number explicitly implemented either as a boolean
vector into
the real number domain, or any unlimited
arrayNaN, ONEI, ZERO_DOUBLE_LONG_BITS, ZERO_FLOAT_INT_BITS, ZEROI
Constructor and Description |
---|
AbstractNumericPrimitive() |
AbstractNumericPrimitive(Domain aDomain,
NumericPrecision aPrecision) |
AbstractNumericPrimitive(NumericPrecision aPrecision) |
Modifier and Type | Method and Description |
---|---|
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 s,
int start) |
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) |
char |
charAt(int index) |
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<?> aComparable) |
int |
compareToPrimitive(SealedPrimitive<?> aComparable)
Compares this object with the specified object for order
|
PRIMITIVE |
copyUsingText(CharSequence aValue)
Using this primitive as a factory, produce a new primitive of the same
type but initialized with the value specified
|
PRIMITIVE |
delete(int start,
int end) |
PRIMITIVE |
deleteCharAt(int anIndex) |
boolean |
equals(Object anObject) |
StructureStrategy |
getStructureStrategy() |
int |
indexOfText(CharSequence str) |
int |
indexOfText(CharSequence str,
int beginIndex) |
<P extends Primitive<?>> |
inducePostDecrement(P aTarget)
Decrement the value of this Primitive then induce its original value into
the specified target
|
<R extends Real<?>> |
inducePostDecrement(R aTarget)
Decrement the value of this real then induce its original value into
the specified target
|
<P extends Primitive<?>> |
inducePostIncrement(P aTarget)
Increment the value of this Primitive then induce its original value into
the specified target
|
<R extends Real<?>> |
inducePostIncrement(R aTarget)
Increment the value of this real then induce its original value into
the specified target
|
<P extends Primitive<?>> |
inducePrimitiveValue(P aTarget)
Induce the current value of this Primitive into the specified target
|
<TEXT extends 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) |
boolean |
isEmpty()
Answer
true if this structure contains no elements. |
boolean |
isEqualToPrimitive(SealedPrimitive<?> aValue) |
boolean |
isEqualToText(CharSequence aValue) |
boolean |
isGreaterOrEqualToPrimitive(SealedPrimitive<?> aValue) |
boolean |
isGreaterOrEqualToText(CharSequence aValue) |
boolean |
isGreaterThanPrimitive(SealedPrimitive<?> aValue) |
boolean |
isGreaterThanText(CharSequence aValue) |
boolean |
isLessOrEqualToPrimitive(SealedPrimitive<?> aValue) |
boolean |
isLessOrEqualToText(CharSequence aValue) |
boolean |
isLessThanPrimitive(SealedPrimitive<?> aValue) |
boolean |
isLessThanText(CharSequence aValue) |
boolean |
isNotEqualToPrimitive(SealedPrimitive<?> aValue) |
boolean |
isNotEqualToText(CharSequence aValue) |
boolean |
isText() |
int |
length() |
PRIMITIVE |
lowerCase()
For text-based objects, convert all characters in the text to lower case.
|
PRIMITIVE |
prepend(boolean aValue) |
PRIMITIVE |
prepend(char c) |
PRIMITIVE |
prepend(char[] content) |
PRIMITIVE |
prepend(char[] content,
int contentIndex) |
PRIMITIVE |
prepend(char[] content,
int contentIndex,
int contentLength) |
PRIMITIVE |
prepend(CharSequence s) |
PRIMITIVE |
prepend(CharSequence s,
int start) |
PRIMITIVE |
prepend(CharSequence s,
int start,
int end) |
PRIMITIVE |
prepend(double aValue) |
PRIMITIVE |
prepend(float aValue) |
PRIMITIVE |
prepend(int aValue) |
PRIMITIVE |
prepend(long aValue) |
PRIMITIVE |
prepend(Object aValue) |
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 |
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 |
setLength(int newLength) |
PRIMITIVE |
setNumber(Number aValue)
Set this object to the specified system-supported
Number and
answer this object (facilitates chaining) |
PRIMITIVE |
setPrimitive(SealedPrimitive<?> aValue)
Set this property to the specified primitive
|
PRIMITIVE |
setReal(SealedReal<?> aValue)
Set this property to the specified numeric
primitive and answer this object (facilitates chaining) |
PRIMITIVE |
setText(CharSequence content)
Set this property to the specified
text value and answer
this object (facilitates chaining) |
CharSequence |
subSequence(int start,
int end) |
String |
substring(int start) |
String |
substring(int start,
int end) |
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. |
static Primitive<?> |
toPrimitive(SealedReal<?> aReal) |
static Primitive<?> |
toPrimitive(SealedScalar<?> aScalar) |
PRIMITIVE |
trim()
Remove both leading and trailing
whitespace |
PRIMITIVE |
upperCase()
For text-based objects, convert all characters in the text to upper case.
|
andOfPrimitive, angleWithPrimitive, compareToText, differenceOfPrimitive, hypotenuseWithPrimitive, inducePrimitiveMaximum, inducePrimitiveMinimum, induceTextSize, modOfPrimitive, orOfPrimitive, powerOfPrimitive, productOfPrimitive, quotientOfPrimitive, sumOfPrimitive, toPrimitive, xorOfPrimitive
and, andOfNumber, andOfReal, angleWithReal, compareToNumber, compareToReal, compareToReal, compareToReal, difference, difference, differenceOfNumber, differenceOfReal, gcd, gcdOfNumber, gcdOfReal, hypotenuseWithReal, induceRealSize, isEqual, isEqual, isEqualToNumber, isEqualToReal, isGreater, isGreater, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqualToNumber, isGreaterOrEqualToReal, isGreaterThanNumber, isGreaterThanReal, isLess, isLess, isLessOrEqual, isLessOrEqual, isLessOrEqualToNumber, isLessOrEqualToReal, isLessThanNumber, isLessThanReal, isNotEqual, isNotEqual, isNotEqualToNumber, isNotEqualToReal, mod, mod, modOfNumber, modOfReal, or, orOfNumber, orOfReal, powerOfReal, product, product, productOfNumber, productOfReal, quotient, quotient, quotientOfNumber, quotientOfReal, sum, sum, sumOfNumber, sumOfReal, toReal, unlimitedIntegerModularInverse, xor, xorOfNumber, xorOfReal
absoluteValue, and, and, and, and, and, and, andOfScalar, angleWith, angleWithNumber, angleWithScalar, arcCosine, arcSine, arcTangent, assertDomain, assertPrecision, base10Log, 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, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToZero, cosine, cubeRoot, degrees, difference, difference, difference, difference, difference, difference, difference, difference, differenceOfScalar, divideByZero, down, exponential, exponentialLessOne, floor, gcd, gcd, gcd, gcd, gcd, gcdOfScalar, getBooleanBitAt, getByteBitAt, getCharBitAt, getDomain, getDoubleBitAt, getFloatBitAt, getIntBitAt, getLongBitAt, getPrecision, getShortBitAt, getUnlimitedDecimalBitAt, getUnlimitedIntegerBitAt, halfDown, halfEven, halfUp, hashCode, hashCode, hashCode, hashCode, hashCode, hashCode, hashCode, hashCode, hyperbolicCosine, hyperbolicSine, hyperbolicTangent, hypotenuseWith, hypotenuseWithNumber, hypotenuseWithScalar, indexOutOfBoundsAt, induceScalarSize, intGCD, intMaskAt, intModularInverse, intModularQuotient, intNotMaskAt, intValue, invalidate, isAlphabetic, isBmpCodePoint, isConfigurable, isCountable, isDigit, isElastic, isEqual, isEqual, isEqual, isEqual, isEqual, isEqual, isEqual, isEqual, isEqualToScalar, isExpandable, isFalse, isFinite, isGreater, isGreater, isGreater, isGreater, isGreater, isGreater, isGreater, isGreater, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqualToScalar, isGreaterThanScalar, isHighSurrogate, isIdentifierIgnorable, isIdeographic, isImaginary, isISOControl, isJavaIdentifierPart, isJavaIdentifierStart, isLess, isLess, isLess, isLess, isLess, isLess, isLess, isLess, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqualToScalar, isLessThanScalar, isLetter, isLetterOrDigit, isLowerCase, isLowSurrogate, isMirrored, isMutable, isNegativeFinite, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqualToScalar, isOrdered, isPositiveFinite, isReducible, isSupplementaryCodePoint, isSurrogate, isTitleCase, isTrue, isUnicode, isUnicodeIdentifierPart, isUnicodeIdentifierStart, isUnique, isUpperCase, isValid, isValidCodePoint, isWhitespace, longGCD, longMaskAt, longModularInverse, longModularQuotient, longNotMaskAt, longSize, longValue, milliseconds, mod, mod, mod, mod, mod, mod, mod, mod, modOfScalar, nanoseconds, naturalLog, naturalLogPlusOne, or, or, or, or, or, or, orOfScalar, power, power, powerOfNumber, powerOfScalar, product, product, product, product, product, product, product, product, productOfScalar, promoteTo, quotient, quotient, quotient, quotient, quotient, quotient, quotient, quotient, quotientOfScalar, radians, random, setByteBitAt, setCharBitAt, setDoubleBitAt, setE, setEnumeration, setFalse, setFloatBitAt, setIntBitAt, setLongBitAt, setNegativeInfinity, setPi, setPositiveInfinity, setScalar, setShortBitAt, setTrue, setUnity, setUnlimitedDecimalBitAt, setUnlimitedIntegerBitAt, setZero, shiftRightExtendZero, shortMaskAt, shortNotMaskAt, shortValue, signum, sine, size, squareRoot, sum, sum, sum, sum, sum, sum, sum, sum, sumOfScalar, tangent, toBoolean, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toBooleanArray, toByteArray, toCharacter, toCodePoint, toEnumeration, toScalar, toUnlimitedInteger, unlimitedIntegerMaskAt, unlimitedIntegerNotMaskAt, up, xor, xor, xor, xor, xor, xor, xorOfScalar
byteValue, doubleValue, floatValue, intValue, longValue, shortValue
clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
swapPrimitives
copyUsingPrimitive
induceRealValue
inducePostDecrement, inducePostIncrement, induceScalarValue
compareToReal, compareToReal, compareToReal, isEqual, isEqual, isEqualToReal, isGreater, isGreater, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqualToReal, isGreaterThanReal, isLess, isLess, isLessOrEqual, isLessOrEqual, isLessOrEqualToReal, isLessThanReal, isNotEqual, isNotEqual, isNotEqualToReal
compareToNumber, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToScalar, compareToZero, isEqual, isEqual, isEqual, isEqual, isEqual, isEqual, isEqual, isEqual, isEqualToNumber, isEqualToScalar, isFalse, isGreater, isGreater, isGreater, isGreater, isGreater, isGreater, isGreater, isGreater, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqual, isGreaterOrEqualToNumber, isGreaterOrEqualToScalar, isGreaterThanNumber, isGreaterThanScalar, isLess, isLess, isLess, isLess, isLess, isLess, isLess, isLess, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqual, isLessOrEqualToNumber, isLessOrEqualToScalar, isLessThanNumber, isLessThanScalar, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqual, isNotEqualToNumber, isNotEqualToScalar, isTrue, toBoolean, toCharacter, toCodePoint, toEnumeration, toNumber
getConcurrency, hashCode, toString
isFinite, isImaginary, isInfinity, isInvalid, isMaximum, isMinimum, isModulo, isNegative, isNegativeFinite, isNegativeInfinity, isPositive, isPositiveFinite, isPositiveInfinity, isReal, isUnity, isValid, isZero, signum
isAlphabetic, isBmpCodePoint, isDigit, isHighSurrogate, isIdentifierIgnorable, isIdeographic, isISOControl, isJavaIdentifierPart, isJavaIdentifierStart, isLetter, isLetterOrDigit, isLowerCase, isLowSurrogate, isMirrored, isSupplementaryCodePoint, isSurrogate, isTitleCase, isUnicode, isUnicodeIdentifierPart, isUnicodeIdentifierStart, isUpperCase, isValidCodePoint, isWhitespace
booleanValue
byteValue
charValue
doubleValue
floatValue
intValue
longValue
shortValue
induceRealMaximum, induceRealMinimum
getPrecision, induceScalarMaximum, induceScalarMinimum
induceRealSize
induceScalarSize
getDomain, longSize, size
isConfigurable, isCountable, isElastic, isExpandable, isOrdered, isReducible, isUnique
copyUsing, copyUsing, copyUsingReal, toReal
copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsing, copyUsingScalar, toScalar
copy
and, andOfReal, angleWithReal, difference, difference, differenceOfReal, gcd, gcdOfReal, hypotenuseWithReal, mod, mod, modOfReal, or, orOfReal, powerOfReal, product, product, productOfReal, quotient, quotient, quotientOfReal, sum, sum, sumOfReal, xor, xorOfReal
absoluteValue, and, and, and, and, and, and, andOfNumber, andOfScalar, angleWith, angleWithNumber, angleWithScalar, arcCosine, arcSine, arcTangent, base10Log, ceiling, cosine, cube, cubeRoot, decrement, degrees, difference, difference, difference, difference, difference, difference, difference, difference, differenceOfNumber, differenceOfScalar, down, exponential, exponentialLessOne, floor, gcd, gcd, gcd, gcd, gcd, gcdOfNumber, gcdOfScalar, halfDown, halfEven, halfUp, hyperbolicCosine, hyperbolicSine, hyperbolicTangent, hypotenuseWith, hypotenuseWithNumber, hypotenuseWithScalar, increment, invalidate, inverse, milliseconds, mod, mod, mod, mod, mod, mod, mod, mod, modOfNumber, modOfScalar, nanoseconds, naturalLog, naturalLogPlusOne, negate, not, or, or, or, or, or, or, orOfNumber, orOfScalar, power, power, powerOfNumber, powerOfScalar, product, product, product, product, product, product, product, product, productOfNumber, productOfScalar, quotient, quotient, quotient, quotient, quotient, quotient, quotient, quotient, quotientOfNumber, quotientOfScalar, radians, random, round, setE, setEnumeration, setMaximum, setMinimum, setNegativeInfinity, setPi, setPositiveInfinity, setScalar, setUnity, setZero, shiftLeft, shiftRight, shiftRightExtendZero, sine, square, squareRoot, sum, sum, sum, sum, sum, sum, sum, sum, sumOfNumber, sumOfScalar, tangent, up, xor, xor, xor, xor, xor, xor, xorOfNumber, xorOfScalar
booleanPostDecrement, booleanPostIncrement, setFalse, setScalar, setTrue
bytePostDecrement, bytePostIncrement, setScalar
charPostDecrement, charPostIncrement, setScalar
doublePostDecrement, doublePostIncrement, setScalar
floatPostDecrement, floatPostIncrement, setScalar
intPostDecrement, intPostIncrement, setScalar
longPostDecrement, longPostIncrement, setScalar
setScalar, shortPostDecrement, shortPostIncrement
assertPrecision, promoteTo
assertDomain
toUnlimitedInteger
setReal, unlimitedIntegerPostDecrement, unlimitedIntegerPostIncrement
toUnlimitedDecimal
setReal, unlimitedDecimalPostDecrement, unlimitedDecimalPostIncrement
toString
public AbstractNumericPrimitive()
public AbstractNumericPrimitive(Domain aDomain, NumericPrecision aPrecision)
public AbstractNumericPrimitive(NumericPrecision aPrecision)
public PRIMITIVE append(CharSequence s)
public PRIMITIVE append(CharSequence s, int start)
public PRIMITIVE append(CharSequence s, int start, int end)
public PRIMITIVE append(StringBuffer sb)
public PRIMITIVE appendCodePoint(int codePoint)
public char charAt(int index)
public void clear()
MutableAlgebraicStructure
Collection.clear()
. So as to maintain compatibility, this
function will not return the customary reference back to this structure.public PRIMITIVE clearContents() throws UnsupportedOperationException
MutableAlgebraicStructure
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.clear()
, which does not return a value.
This function, in answering this object, facilitates operation chaining.UnsupportedOperationException
- if this object's value cannot be changedMutableAlgebraicStructure.clear()
,
Collection.clear()
,
MutableTextValue.clearText();
public PRIMITIVE clearText() throws UnsupportedOperationException
MutableTextValue
UnsupportedOperationException
- if this object's text cannot be changedMutableTextValue.clear();
,
Collection.clear()
,
MutableAlgebraicStructure.clearContents()
public int codePointAt(int index)
public int codePointBefore(int index)
public int codePointCount(int beginIndex, int endIndex)
public final int compareTo(SealedPrimitive<?> aComparable)
public final int compareToPrimitive(SealedPrimitive<?> aComparable)
SealedPrimitive
aComparable
- an object to be compared toComparable.compareTo(Object)
public PRIMITIVE copyUsingText(CharSequence aValue)
PrimitiveReplicator
aValue
- a new valuepublic PRIMITIVE deleteCharAt(int anIndex)
public boolean equals(Object anObject)
equals
in interface SealedKernel
equals
in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
public StructureStrategy getStructureStrategy()
public int indexOfText(CharSequence str)
public int indexOfText(CharSequence str, int beginIndex)
public <P extends Primitive<?>> P inducePostDecrement(P aTarget) throws NullPointerException, NoSuchElementException, UnsupportedOperationException, IllegalStateException
PrimitiveInductor
P
- the target typeaTarget
- a target into which the current value of this Primitive will be
induced, prior to decrementingNullPointerException
- a null
value was provided when none was expectedNoSuchElementException
- an expected parameter was not found in the parameter sourceUnsupportedOperationException
- this target Primitive cannot be changedIllegalStateException
- this target Primitive cannot be changed at this timepublic <R extends Real<?>> R inducePostDecrement(R aTarget) throws NullPointerException, NoSuchElementException, UnsupportedOperationException, IllegalStateException
RealInductor
R
- the target typeaTarget
- a target into which the current value of this real will be
induced, prior to decrementingNullPointerException
- a null
value was provided when none was expectedNoSuchElementException
- an expected parameter was not found in the parameter sourceUnsupportedOperationException
- this target primitive cannot be changedIllegalStateException
- this target primitive cannot be changed at this timepublic <P extends Primitive<?>> P inducePostIncrement(P aTarget) throws NullPointerException, NoSuchElementException, UnsupportedOperationException, IllegalStateException
PrimitiveInductor
P
- the target typeaTarget
- a target into which the current value of this Primitive will be
induced, prior to incrementingNullPointerException
- a null
value was provided when none was expectedNoSuchElementException
- an expected parameter was not found in the parameter sourceUnsupportedOperationException
- this target Primitive cannot be changedIllegalStateException
- this target Primitive cannot be changed at this timepublic <R extends Real<?>> R inducePostIncrement(R aTarget) throws NullPointerException, NoSuchElementException, UnsupportedOperationException, IllegalStateException
RealInductor
R
- the target typeaTarget
- a target into which the current value of this real will be
induced, prior to incrementingNullPointerException
- a null
value was provided when none was expectedNoSuchElementException
- an expected parameter was not found in the parameter sourceUnsupportedOperationException
- this target primitive cannot be changedIllegalStateException
- this target primitive cannot be changed at this timepublic <P extends Primitive<?>> P inducePrimitiveValue(P aTarget) throws NullPointerException, NoSuchElementException, UnsupportedOperationException, IllegalStateException
PrimitiveInductor
P
- the target typeaTarget
- a target into which the current value of this Primitive will be
inducedNullPointerException
- a null
value was provided when none was expectedNoSuchElementException
- an expected parameter was not found in the parameter sourceUnsupportedOperationException
- this target Primitive cannot be changedIllegalStateException
- this target Primitive cannot be changed at this timepublic <TEXT extends Text<?>> TEXT induceTextValue(TEXT aTarget) throws NullPointerException, NoSuchElementException, UnsupportedOperationException, IllegalStateException
TextInductor
TEXT
- the target typeaTarget
- a target into which the current value of this text will be
inducedNullPointerException
- a null
value was provided when none was expectedNoSuchElementException
- an expected parameter was not found in the parameter sourceUnsupportedOperationException
- this target primitive cannot be changedIllegalStateException
- this target primitive cannot be changed at this timepublic PRIMITIVE insert(int targetIndex, char[] content, int contentIndex, int contentLength)
public PRIMITIVE insert(int anIndex, CharSequence content)
public PRIMITIVE insert(int targetIndex, CharSequence content, int contentIndex)
public PRIMITIVE insert(int targetIndex, CharSequence content, int contentStartIndex, int contentEndIndexPlusOne)
public boolean isEmpty()
StructureProperties
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.isEmpty
in interface StructureProperties
isEmpty
in interface TextProperties
isEmpty
in class AbstractScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
true
if this structure contains no elementspublic final boolean isEqualToPrimitive(SealedPrimitive<?> aValue)
public final boolean isEqualToText(CharSequence aValue)
public final boolean isGreaterOrEqualToPrimitive(SealedPrimitive<?> aValue)
public final boolean isGreaterOrEqualToText(CharSequence aValue)
public final boolean isGreaterThanPrimitive(SealedPrimitive<?> aValue)
public final boolean isGreaterThanText(CharSequence aValue)
public final boolean isLessOrEqualToPrimitive(SealedPrimitive<?> aValue)
public final boolean isLessOrEqualToText(CharSequence aValue)
public final boolean isLessThanPrimitive(SealedPrimitive<?> aValue)
public final boolean isLessThanText(CharSequence aValue)
public final boolean isNotEqualToPrimitive(SealedPrimitive<?> aValue)
public final boolean isNotEqualToText(CharSequence aValue)
public boolean isText()
true
if this object utilizes a text-based implementationpublic int length()
public PRIMITIVE lowerCase()
MutableTextValue
public final PRIMITIVE prepend(CharSequence s)
public final PRIMITIVE prepend(CharSequence s, int start)
public final PRIMITIVE prepend(CharSequence s, int start, int end)
public PRIMITIVE replace(CharSequence target, CharSequence replacement)
public PRIMITIVE replaceAll(String regex, String replacement)
public PRIMITIVE replaceCharacter(char oldChar, char newChar)
public PRIMITIVE replaceFirst(String regex, String replacement)
public final PRIMITIVE setBoolean(Boolean aValue) throws UnsupportedOperationException, IllegalArgumentException, ArithmeticException, NullPointerException
MutablePrimitive
Boolean
and
answer this object (facilitates chaining)aValue
- a system-supported Boolean
UnsupportedOperationException
- if this object's value cannot be changedIllegalArgumentException
- if the specified value was incommensurate with this object's
specificationArithmeticException
- the numeric value provided was incompatible with with algebraic
interpretation of this objectNullPointerException
- a null
value was provided though this object does not
accept null
valuespublic final PRIMITIVE setCharacter(Character aValue) throws UnsupportedOperationException, IllegalArgumentException, ArithmeticException, NullPointerException
MutablePrimitive
Character
and
answer this object (facilitates chaining)aValue
- a system-supported Character
UnsupportedOperationException
- if this object's value cannot be changedIllegalArgumentException
- if the specified value was incommensurate with this object's
specificationArithmeticException
- the numeric value provided was incompatible with with algebraic
interpretation of this objectNullPointerException
- a null
value was provided though this object does not
accept null
valuespublic PRIMITIVE setNumber(Number aValue) throws UnsupportedOperationException, IllegalArgumentException, ArithmeticException, NullPointerException
MutableScalar
Number
and
answer this object (facilitates chaining)setNumber
in interface MutableScalar<PRIMITIVE extends Primitive<PRIMITIVE>>
setNumber
in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
aValue
- a system-supported Number
UnsupportedOperationException
- if this object's value cannot be changedIllegalArgumentException
- if the specified value was incommensurate with this object's
specificationArithmeticException
- the numeric value provided was incompatible with with algebraic
interpretation of this objectNullPointerException
- a null
value was provided though this object does not
accept null
valuespublic PRIMITIVE setPrimitive(SealedPrimitive<?> aValue) throws UnsupportedOperationException, IllegalArgumentException, ArithmeticException, NullPointerException
MutablePrimitive
aValue
- a primitiveUnsupportedOperationException
- if this object's value cannot be changedIllegalArgumentException
- if the specified value was incommensurate with this object's
specificationArithmeticException
- the numeric value provided was incompatible with with algebraic
interpretation of this objectNullPointerException
- a null
value was provided though this object does not
accept null
valuespublic PRIMITIVE setReal(SealedReal<?> aValue) throws UnsupportedOperationException, IllegalArgumentException, ArithmeticException, NullPointerException
MutableReal
primitive
and answer this object (facilitates chaining)setReal
in interface MutableReal<PRIMITIVE extends Primitive<PRIMITIVE>>
setReal
in class AbstractReal<PRIMITIVE extends Primitive<PRIMITIVE>>
aValue
- a numeric primitive
UnsupportedOperationException
- if this object's value cannot be changedIllegalArgumentException
- if the specified value was incommensurate with this object's
specificationArithmeticException
- the numeric value provided was incompatible with with algebraic
interpretation of this objectNullPointerException
- a null
value was provided though this object does not
accept null
valuespublic PRIMITIVE setText(CharSequence content) throws UnsupportedOperationException, NullPointerException, IllegalArgumentException
MutableTextValue
text
value and answer
this object (facilitates chaining)content
- a text
valueUnsupportedOperationException
- if this object's value cannot be changedNullPointerException
- a null
value was provided and this implementation does
not accept null
valuesIllegalArgumentException
- if the specified value was incommensurate with this object's
specificationpublic CharSequence subSequence(int start, int end)
public String textPostDecrement() throws UnsupportedOperationException, ArithmeticException, IllegalArgumentException
MutableTextValue
UnsupportedOperationException
- if this object's value cannot be changedArithmeticException
- the new numeric value was incompatible with with algebraic
interpretation of this objectIllegalArgumentException
- if the new value was incommensurate with this object's
specificationpublic String textPostIncrement() throws UnsupportedOperationException, ArithmeticException, IllegalArgumentException
MutableTextValue
UnsupportedOperationException
- if this object's value cannot be changedArithmeticException
- the new numeric value was incompatible with with algebraic
interpretation of this objectIllegalArgumentException
- if the new value was incommensurate with this object's
specificationpublic PRIMITIVE titleCase()
MutableTextValue
title
case. For numeric objects,
convert their character (BMP) or integer value (Unicode) to title case,
depending on the object's precision levelpublic PRIMITIVE trim()
MutableTextValue
whitespace
public PRIMITIVE upperCase()
MutableTextValue
public static final Primitive<?> toPrimitive(SealedReal<?> aReal)
public static final Primitive<?> toPrimitive(SealedScalar<?> aScalar)
Copyright © 2006-2012 Ware-Squared Software Development. All Rights Reserved.