summaryrefslogtreecommitdiff
path: root/BJC-Utils2/src/main
diff options
context:
space:
mode:
authorbculkin2442 <bjculkin@mix.wvu.edu>2015-09-28 22:41:55 -0400
committerbculkin2442 <bjculkin@mix.wvu.edu>2015-09-28 22:41:55 -0400
commitf8215c428f0b46b459c59d0783b4bc4dadfc38a3 (patch)
treed4891bb1f8d8193dbec02ca46854f86b34085a1c /BJC-Utils2/src/main
parentebab46a80d665a5e6c175e1dc3eaba47582ea482 (diff)
Basic data structure code.
Still importing things from the old project.
Diffstat (limited to 'BJC-Utils2/src/main')
-rw-r--r--BJC-Utils2/src/main/java/bjc/utils/data/GenHolder.java66
-rw-r--r--BJC-Utils2/src/main/java/bjc/utils/data/Pair.java54
2 files changed, 120 insertions, 0 deletions
diff --git a/BJC-Utils2/src/main/java/bjc/utils/data/GenHolder.java b/BJC-Utils2/src/main/java/bjc/utils/data/GenHolder.java
new file mode 100644
index 0000000..f969960
--- /dev/null
+++ b/BJC-Utils2/src/main/java/bjc/utils/data/GenHolder.java
@@ -0,0 +1,66 @@
+package bjc.utils.data;
+
+import java.util.function.Function;
+
+/**
+ * Holds a single value of a specific type.
+ * This is used for indirect references to data, and more specifically
+ * for accessing non-final variables from a lambda.
+ * AKA the identity monad
+ * @author ben
+ *
+ * @param <T> The type of the data being held
+ */
+public class GenHolder<T> {
+ /**
+ * The state this holder is responsible for.
+ */
+ public T held;
+
+ /**
+ * Creates a new empty holder, with its state set to null
+ */
+ public GenHolder() {
+ held = null;
+ }
+
+ /**
+ * Creates a new holder, with its state initialized to the provided value
+ *
+ * @param held The state to initialize this holder to.
+ */
+ public GenHolder(T hld) {
+ held = hld;
+ }
+
+ /**
+ * Apply the given transformation to the held value.
+ * Returns the holder for allowing chaining of transforms
+ * @param f The transform to apply to the value
+ * @return The holder
+ */
+ public GenHolder<T> transform(Function<T, T> f) {
+ held = f.apply(held);
+
+ return this;
+ }
+
+ /**
+ * Return the result of applying the given transformation to the held value
+ * Doesn't change the held value
+ * @param f The transformation to apply
+ * @return A holder with the transformed value
+ */
+ public <NewT> GenHolder<NewT> map(Function<T, NewT> f) {
+ return new GenHolder<NewT>(f.apply(held));
+ }
+
+ /**
+ * Returns a raw mapped value, not contained in a GenHolder
+ * @param f The function to use for mapping the value
+ * @return The mapped value outside of a GenHolder
+ */
+ public <E> E unwrap(Function<T, E> f) {
+ return f.apply(held);
+ }
+}
diff --git a/BJC-Utils2/src/main/java/bjc/utils/data/Pair.java b/BJC-Utils2/src/main/java/bjc/utils/data/Pair.java
new file mode 100644
index 0000000..14ac52d
--- /dev/null
+++ b/BJC-Utils2/src/main/java/bjc/utils/data/Pair.java
@@ -0,0 +1,54 @@
+package bjc.utils.data;
+
+import java.util.function.BiFunction;
+import java.util.function.Function;
+
+/**
+ * Holds a pair of values of two different types.
+ * @author ben
+ *
+ * @param <L> The type of the thing held on the left (first)
+ * @param <R> The type of the thing held on the right (second)
+ */
+public class Pair<L, R> {
+ public L l;
+ public R r;
+
+ /**
+ * Create a new pair that holds two nulls.
+ */
+ public Pair() {
+
+ }
+
+ /**
+ * Create a new pair holding the specified values.
+ * @param left The value to hold on the left.
+ * @param right The value to hold on the right.
+ */
+ public Pair(L left, R right) {
+ l = left;
+ r = right;
+ }
+
+ /**
+ * Create a new pair by applying the given functions to the left/right.
+ * Does not change the internal contents of this pair.
+ * @param lf The function to apply to the left value.
+ * @param rf The function to apply to the right value.
+ * @return A new pair containing the two modified values.
+ */
+ public <L2, R2> Pair<L2, R2> apply(Function<L, L2> lf, Function<R, R2> rf) {
+ return new Pair<L2, R2>(lf.apply(l), rf.apply(r));
+ }
+
+ /**
+ * Collapse this pair to a single value.
+ * Does not change the internal contents of this pair.
+ * @param bf The function to use to collapse the pair.
+ * @return The collapsed value.
+ */
+ public <E> E merge(BiFunction<L, R, E> bf) {
+ return bf.apply(l, r);
+ }
+}