example.MiscTypes Maven / Gradle / Ivy
/*
* Zorbage: an algebraic data hierarchy for use in numeric processing.
*
* Copyright (c) 2016-2021 Barry DeZonia All rights reserved.
*
* Redistribution and use in source and binary forms, with or without modification,
* are permitted provided that the following conditions are met:
*
* Redistributions of source code must retain the above copyright notice, this list
* of conditions and the following disclaimer.
*
* Redistributions in binary form must reproduce the above copyright notice, this
* list of conditions and the following disclaimer in the documentation and/or other
* materials provided with the distribution.
*
* Neither the name of the nor the names of its contributors may
* be used to endorse or promote products derived from this software without specific
* prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
* IN NO EVENT SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*/
package example;
import nom.bdezonia.zorbage.algebra.G;
import nom.bdezonia.zorbage.datasource.IndexedDataSource;
import nom.bdezonia.zorbage.type.bool.BooleanMember;
import nom.bdezonia.zorbage.type.character.CharAlgebra;
import nom.bdezonia.zorbage.type.character.CharMember;
import nom.bdezonia.zorbage.type.color.ArgbMember;
import nom.bdezonia.zorbage.type.color.RgbMember;
import nom.bdezonia.zorbage.type.point.Point;
import nom.bdezonia.zorbage.type.rational.RationalMember;
import nom.bdezonia.zorbage.type.string.FixedStringMember;
import nom.bdezonia.zorbage.type.string.StringMember;
/**
* @author Barry DeZonia
*/
class MiscTypes {
// Zorbage supports a few types that are neither integers nor float derived.
// Rational numbers are supported by Zorbage. They lie somewhere between an integer and
// a real. They are unlimited in their size and their decimal places of accuracy.
void example1() {
RationalMember frac = new RationalMember(52, 4007); // 52/4007
// java operations
frac.equals(frac);
frac.hashCode();
frac.toString();
// construction
G.RAT.construct();
G.RAT.construct(frac);
G.RAT.construct("4.25");
// set to zero or 1
G.RAT.zero();
G.RAT.unity();
// basic operations
G.RAT.assign();
G.RAT.add();
G.RAT.subtract();
G.RAT.multiply();
G.RAT.divide();
G.RAT.div();
G.RAT.mod();
G.RAT.divMod();
G.RAT.power();
G.RAT.abs();
G.RAT.invert();
G.RAT.negate();
G.RAT.norm();
G.RAT.within(); // is one rational within a tolerance of another rational
// comparisons
G.RAT.compare();
G.RAT.signum();
G.RAT.isEqual();
G.RAT.isGreater();
G.RAT.isGreaterEqual();
G.RAT.isLess();
G.RAT.isLessEqual();
G.RAT.isNotEqual();
G.RAT.isUnity();
G.RAT.isZero();
G.RAT.min(); // return the minimum of two values
G.RAT.max(); // return the maximum of two values
// scaling
G.RAT.scale();
G.RAT.scaleByHighPrec();
G.RAT.scaleByRational();
}
// Zorbage supports a real n-dimensional Point type. The components are doubles.
@SuppressWarnings("unused")
void example2() {
// 3d point
Point pt = new Point(3);
// Allocate 100 of them. Note the pt passed to allocator determines the dimensionality
// of all allocated points in the returned list.
IndexedDataSource points = nom.bdezonia.zorbage.storage.Storage.allocate(pt, 100);
// java operations
pt.equals(pt);
pt.hashCode();
pt.toString();
// construction
G.POINT.construct();
G.POINT.construct(pt);
G.POINT.construct("something"); // might not actually be supported
// basic operations
G.POINT.assign(); // set b = a
G.POINT.add(); // set c = a + b
G.POINT.subtract(); // set c = a - b
G.POINT.negate(); // set b = -a
G.POINT.zero(); // set to zero
G.POINT.random(); // set the coords of a point to a bunch of random doubles
G.POINT.within(); // within a tolerance of another point
G.POINT.infinite(); // set components to infinity
G.POINT.negInfinite(); // set components to negative infinity
G.POINT.nan(); // set components to nan
// comparison
G.POINT.isEqual();
G.POINT.isNotEqual();
G.POINT.isZero();
G.POINT.isInfinite();
G.POINT.isNaN();
// scaling
G.POINT.scale();
G.POINT.scaleByDouble();
G.POINT.scaleByHighPrec();
G.POINT.scaleByRational();
G.POINT.scaleByOneHalf();
G.POINT.scaleByTwo();
G.POINT.scaleComponents();
}
// Zorbage supports Boolean values.
void example3() {
BooleanMember bool = new BooleanMember(true);
// java operations
bool.equals(bool);
bool.hashCode();
bool.toString();
// construction
G.BOOL.construct();
G.BOOL.construct(bool);
G.BOOL.construct("1"); // also "true" or "T" or "+"
G.BOOL.construct("0"); // also "false" or "F" or "-"
// basic operations
G.BOOL.assign(); // set b = a
G.BOOL.unity(); // set to one / true
G.BOOL.zero(); // set to zero / false
G.BOOL.random(); // set to a random value
G.BOOL.ternary(); // emulate the (a ? b : c) ternary operator from C
// comparisons
G.BOOL.isEqual();
G.BOOL.isGreater();
G.BOOL.isGreaterEqual();
G.BOOL.isLess();
G.BOOL.isLessEqual();
G.BOOL.isNotEqual();
G.BOOL.isUnity();
G.BOOL.isZero();
G.BOOL.compare();
G.BOOL.signum();
G.BOOL.min(); // return the minimum of two values
G.BOOL.max(); // return the maximum of two values
G.BOOL.minBound(); // 0 / false
G.BOOL.maxBound(); // 1 / true
// logical operations
G.BOOL.logicalAnd();
G.BOOL.logicalAndNot();
G.BOOL.logicalNot();
G.BOOL.logicalOr();
G.BOOL.logicalXor();
}
// Zorbage supports RGB color values
void example4() {
RgbMember color = new RgbMember(255, 0, 0);
// java operations
color.equals(color);
color.hashCode();
color.toString();
// construction
G.RGB.construct();
G.RGB.construct(color);
G.RGB.construct("something"); // this may not actually be supported yet
// basic operations
G.RGB.assign(); // set b = a
G.RGB.blend(); // blend two colors into a third
G.RGB.random(); // set to a random color
G.RGB.zero(); // set to zero (minBound)
// comparisons
G.RGB.isEqual();
G.RGB.isNotEqual();
G.RGB.isZero();
G.RGB.minBound(); // (0,0,0)
G.RGB.maxBound(); // (255,255,255)
}
// Zorbage supports ARGB color values
void example5() {
ArgbMember color = new ArgbMember(0, 255, 0, 0);
// java operations
color.equals(color);
color.hashCode();
color.toString();
// construction
G.ARGB.construct();
G.ARGB.construct(color);
G.ARGB.construct("something"); // this may not actually be supported yet
// basic operations
G.ARGB.assign(); // set b = a
G.ARGB.blend(); // blend two colors into a third
G.ARGB.random(); // set to a random color
G.ARGB.zero(); // set to zero (minBound)
// comparisons
G.ARGB.isEqual();
G.ARGB.isNotEqual();
G.ARGB.isZero();
G.ARGB.minBound(); // (0,0,0,0)
G.ARGB.maxBound(); // (255,255,255,255)
}
// Zorbage supports fixed length string values. All such strings are set with a
// fixed capacity at creation time. Such a string might not use all its
// capacity while containing a string. Any operation that results in a string
// exceeding the container's capacity results in string truncation. With fixed
// capacity sized strings zorbage can easily store them in multiple kinds of
// storage containers.
void example6() {
FixedStringMember fixed = new FixedStringMember(100);
FixedStringMember other = null;
// java ops
fixed.equals(other);
fixed.hashCode();
fixed.toString();
// constructions
G.FSTRING.construct();
G.FSTRING.construct(other);
G.FSTRING.construct("how now brown cow?");
// mathematical operations
G.FSTRING.assign();
G.FSTRING.add();
G.FSTRING.subtract();
G.FSTRING.zero();
G.FSTRING.negate(); // is actually a no op procedure
G.FSTRING.length();
G.FSTRING.norm();
G.FSTRING.signum();
G.FSTRING.max();
G.FSTRING.min();
G.FSTRING.isZero(); // is string empty
// comparisons
G.FSTRING.isEqual();
G.FSTRING.isEqualIgnoreCase();
G.FSTRING.isNotEqual();
G.FSTRING.isNotEqualIgnoreCase();
G.FSTRING.isLess();
G.FSTRING.isLessIgnoreCase();
G.FSTRING.isLessEqual();
G.FSTRING.isLessEqualIgnoreCase();
G.FSTRING.isGreater();
G.FSTRING.isGreaterIgnoreCase();
G.FSTRING.isGreaterEqual();
G.FSTRING.isGreaterEqualIgnoreCase();
G.FSTRING.isEmpty();
G.FSTRING.compare();
G.FSTRING.compareIgnoreCase();
// simple string operations
G.FSTRING.concat();
G.FSTRING.contains();
G.FSTRING.contentEquals();
G.FSTRING.endsWith();
G.FSTRING.getBytes();
G.FSTRING.getBytesUsingCharset();
G.FSTRING.getBytesUsingCharsetName();
G.FSTRING.codePointAt();
G.FSTRING.codePointCount();
G.FSTRING.indexOf();
G.FSTRING.indexOfFrom();
G.FSTRING.indexOfCodePoints();
G.FSTRING.indexOfCodePointsFrom();
G.FSTRING.join();
G.FSTRING.lastIndexOf();
G.FSTRING.lastIndexOfFrom();
G.FSTRING.lastIndexOfCodePoints();
G.FSTRING.lastIndexOfCodePointsFrom();
G.FSTRING.matches();
G.FSTRING.regionMatches();
G.FSTRING.regionMatchesWithCase();
G.FSTRING.replace();
G.FSTRING.replaceAll();
G.FSTRING.replaceFirst();
G.FSTRING.replaceCodePoints();
G.FSTRING.split();
G.FSTRING.splitWithLimit();
G.FSTRING.startsWith();
G.FSTRING.subStringFromStart();
G.FSTRING.substringFromStartToEnd();
G.FSTRING.toLower();
G.FSTRING.toLowerWithLocale();
G.FSTRING.toUpper();
G.FSTRING.toUpperWithLocale();
G.FSTRING.trim();
G.FSTRING.toCharArray();
}
// Zorbage supports unlimited length string values too. All such strings are
// similar to Java strings and can contain up to Integer.MAX_VALUE chars.
// With strings like these there is little or no real worries about data
// truncation. However since they are not of fixed size they cannot be
// stored in most of zorbage's storage containers. All storage structures
// that can store such strings are memory resident and limited to no more
// than Integer.MAX_VALUE elements.
void example7() {
StringMember str = new StringMember("");
StringMember other = null;
// java ops
str.equals(other);
str.hashCode();
str.toString();
// constructions
G.STRING.construct();
G.STRING.construct(other);
G.STRING.construct("how now brown cow?");
// mathematical operations
G.STRING.assign();
G.STRING.add();
G.STRING.subtract();
G.STRING.zero();
G.STRING.negate(); // is actually a no op procedure
G.STRING.length();
G.STRING.norm();
G.STRING.signum();
G.STRING.max();
G.STRING.min();
G.STRING.isZero(); // is string empty
// comparisons
G.STRING.isEqual();
G.STRING.isEqualIgnoreCase();
G.STRING.isNotEqual();
G.STRING.isNotEqualIgnoreCase();
G.STRING.isLess();
G.STRING.isLessIgnoreCase();
G.STRING.isLessEqual();
G.STRING.isLessEqualIgnoreCase();
G.STRING.isGreater();
G.STRING.isGreaterIgnoreCase();
G.STRING.isGreaterEqual();
G.STRING.isGreaterEqualIgnoreCase();
G.STRING.isEmpty();
G.STRING.compare();
G.STRING.compareIgnoreCase();
// simple string operations
G.STRING.concat();
G.STRING.contains();
G.STRING.contentEquals();
G.STRING.endsWith();
G.STRING.getBytes();
G.STRING.getBytesUsingCharset();
G.STRING.getBytesUsingCharsetName();
G.STRING.codePointAt();
G.STRING.codePointCount();
G.STRING.indexOf();
G.STRING.indexOfFrom();
G.STRING.join();
G.STRING.lastIndexOf();
G.STRING.lastIndexOfFrom();
G.STRING.matches();
G.STRING.regionMatches();
G.STRING.regionMatchesWithCase();
G.STRING.replace();
G.STRING.replaceAll();
G.STRING.replaceFirst();
G.STRING.split();
G.STRING.splitWithLimit();
G.STRING.startsWith();
G.STRING.subStringFromStart();
G.STRING.substringFromStartToEnd();
G.STRING.toLower();
G.STRING.toLowerWithLocale();
G.STRING.toUpper();
G.STRING.toUpperWithLocale();
G.STRING.trim();
G.STRING.toCharArray();
}
// Standard Java unicode 16 characters
void example8() {
CharMember ch = new CharMember("A");
CharMember other = null;
// java ops
ch.equals(other);
ch.hashCode();
ch.toString();
// constructions
G.CHAR.construct();
G.CHAR.construct(other);
G.CHAR.construct("B");
// mathematical operations
G.CHAR.assign();
G.CHAR.signum();
G.CHAR.zero();
G.CHAR.max();
G.CHAR.min();
G.CHAR.pred();
G.CHAR.succ();
// comparisons
G.CHAR.compare();
G.CHAR.isEqual();
G.CHAR.isGreater();
G.CHAR.isGreaterEqual();
G.CHAR.isLess();
G.CHAR.isLessEqual();
G.CHAR.isNotEqual();
G.CHAR.isZero();
// misc
CharMember bound = new CharMember();
G.CHAR.maxBound().call(bound);
G.CHAR.minBound().call(bound);
G.CHAR.random().call(ch);
CharAlgebra.reverseBytes().call(ch);
CharAlgebra.valueOf().call('n');
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy