com.rpl.rama

Interface Path.Impl

All Superinterfaces:

Path

Enclosing interface:

Path

public static interface Path.Impl
extends Path

Nested Class Summary

Nested classes/interfaces inherited from interface com.rpl.rama.Path

Path.Impl

Method Summary

Modifier and Type	Method and Description
Path.Impl	afterElem() Navigates on a list to void element at end.
Path.Impl	all() Navigates to every element of a collection.
Path.Impl	beforeElem() Navigates on a list to void element at beginning.
Path.Impl	beforeIndex(java.lang.Object argIndex) Navigates on list to void element before an index.
Path.Impl	beginning() Navigates on a list to empty subsequence at beginning.
Path.Impl	collect(Path path) Collects a list of values selected with given path from current point.
Path.Impl	collectOne(Path path) Collects a single value selected with given path from current point.
Path.Impl	customNav(Navigator nav) Adds custom navigator implementation to Path
Path.Impl	customNavBuilder(RamaFunction0<Navigator> builderFunction) Adds a custom navigator built dynamically with the provided function of zero arguments.
<T0> Path.Impl	customNavBuilder(RamaFunction1<T0,Navigator> builderFunction, java.lang.Object arg0) Adds a custom navigator built dynamically with the provided function of one argument.
<T0,T1> Path.Impl	customNavBuilder(RamaFunction2<T0,T1,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1) Adds a custom navigator built dynamically with the provided function of two arguments.
<T0,T1,T2> Path.Impl	customNavBuilder(RamaFunction3<T0,T1,T2,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2) Adds a custom navigator built dynamically with the provided function of three arguments.
<T0,T1,T2,T3> Path.Impl	customNavBuilder(RamaFunction4<T0,T1,T2,T3,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3) Adds a custom navigator built dynamically with the provided function of four arguments.
<T0,T1,T2,T3,T4> Path.Impl	customNavBuilder(RamaFunction5<T0,T1,T2,T3,T4,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4) Adds a custom navigator built dynamically with the provided function of five arguments.
<T0,T1,T2,T3,T4,T5> Path.Impl	customNavBuilder(RamaFunction6<T0,T1,T2,T3,T4,T5,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5) Adds a custom navigator built dynamically with the provided function of six arguments.
<T0,T1,T2,T3,T4,T5,T6> Path.Impl	customNavBuilder(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6) Adds a custom navigator built dynamically with the provided function of seven arguments.
<T0,T1,T2,T3,T4,T5,T6,T7> Path.Impl	customNavBuilder(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,Navigator> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6, java.lang.Object arg7) Adds a custom navigator built dynamically with the provided function of eight arguments.
Path.Impl	dispenseCollected() Drops all collected values from subsequent navigation
Path.Impl	end() Navigates on a list to empty subsequence at end.
Path.Impl	filteredList(Path path) Navigates to sublist of elements filtered based on given Path.
Path.Impl	filterEqual(java.lang.Object argVal) Continues navigation if current value is equal to provided value.
Path.Impl	filterGreaterThan(java.lang.Object argVal) Continues navigation if current value is greater than provided value.
Path.Impl	filterGreaterThanOrEqual(java.lang.Object argVal) Continues navigation if current value is greater than or equal to provided value.
Path.Impl	filterLessThan(java.lang.Object argVal) Continues navigation if current value is less than provided value.
Path.Impl	filterLessThanOrEqual(java.lang.Object argVal) Continues navigation if current value is less than or equal to provided value.
Path.Impl	filterNotEqual(java.lang.Object argVal) Continues navigation if current value is not equal to provided value.
Path.Impl	filterNotSelected(Path path) Continues navigation if provided path executed on current value navigates to zero values.
<T0,R0> Path.Impl	filterPred(RamaFunction1<T0,R0> pred) Continues navigation if provided function returns true on current value.
Path.Impl	filterSelected(Path path) Continues navigation if provided path executed on current value navigates to at least one value.
Path.Impl	first() Navigates on list to first element if not empty.
Path.Impl	ifPath(Path conditionPath, Path thenPath) Tests condition against current point and continues navigating with thenPath if condition passes.
Path.Impl	ifPath(Path conditionPath, Path thenPath, Path elsePath) Tests condition against current point and continues navigating with thenPath if condition passes.
Path.Impl	index(java.lang.Object argIndex) Navigates to the index of a list if it exists.
Path.Impl	indexedVals() Navigates to pairs of [index, value] for every element of list.
<T0,R0> Path.Impl	isCollected(RamaFunction1<T0,R0> predicate) Stops navigation if given function on collected values returns false.
Path.Impl	key(java.lang.Object... argKeys) Navigates to value for a key in a map.
Path.Impl	last() Navigates on list to last element if not empty.
Path.Impl	mapKey(java.lang.Object argKey) Navigates to a key in a map if it exists.
Path.Impl	mapKeys() Navigates to every key of a map.
Path.Impl	mapVals() Navigates to every value of a map.
Path.Impl	multiPath(Path... paths) Navigates to each provided path in order, all starting from this point.
Path.Impl	must(java.lang.Object... argKeys) Navigates to value for a key in a map only if key exists.
Path.Impl	nth(java.lang.Object argIndex) Navigates to value for index in a list.
Path.Impl	nullToList() Navigates to empty list if currently navigated to null.
Path.Impl	nullToSet() Navigates to empty set if currently navigated to null.
Path.Impl	nullToVal(java.lang.Object argVal) Navigates to given value if currently navigated to null.
Path.Impl	pathBuilder(RamaFunction0<Path> builderFunction) Concatenates a path to the current path constructed with the provided function of zero arguments.
<T0> Path.Impl	pathBuilder(RamaFunction1<T0,Path> builderFunction, java.lang.Object arg0) Concatenates a path to the current path constructed with the provided function of one argument.
<T0,T1> Path.Impl	pathBuilder(RamaFunction2<T0,T1,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1) Concatenates a path to the current path constructed with the provided function of two arguments.
<T0,T1,T2> Path.Impl	pathBuilder(RamaFunction3<T0,T1,T2,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2) Concatenates a path to the current path constructed with the provided function of three arguments.
<T0,T1,T2,T3> Path.Impl	pathBuilder(RamaFunction4<T0,T1,T2,T3,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3) Concatenates a path to the current path constructed with the provided function of four arguments.
<T0,T1,T2,T3,T4> Path.Impl	pathBuilder(RamaFunction5<T0,T1,T2,T3,T4,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4) Concatenates a path to the current path constructed with the provided function of five arguments.
<T0,T1,T2,T3,T4,T5> Path.Impl	pathBuilder(RamaFunction6<T0,T1,T2,T3,T4,T5,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5) Concatenates a path to the current path constructed with the provided function of six arguments.
<T0,T1,T2,T3,T4,T5,T6> Path.Impl	pathBuilder(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6) Concatenates a path to the current path constructed with the provided function of seven arguments.
<T0,T1,T2,T3,T4,T5,T6,T7> Path.Impl	pathBuilder(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,Path> builderFunction, java.lang.Object arg0, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6, java.lang.Object arg7) Concatenates a path to the current path constructed with the provided function of eight arguments.
Path.Impl	putCollected(java.lang.Object argVal) Adds given value to collected values.
Path.Impl	setElem(java.lang.Object argVal) Navigates to element of set if it exists.
Path.Impl	sortedMapRange(java.lang.Object argKeyStart, java.lang.Object argKeyEnd) Navigates on a sorted map to a sorted map of all elements in that map between a range of keys.
Path.Impl	sortedMapRange(java.lang.Object argKeyStart, java.lang.Object argKeyEnd, java.lang.Object argOptions) Navigates on a sorted map to a sorted map of all elements in that map between a range of keys, with options to change inclusive/exclusive status of start and end keys.
Path.Impl	sortedMapRangeFrom(java.lang.Object argKeyStart) Navigates on a sorted map to a sorted map of all elements in that map after a key.
Path.Impl	sortedMapRangeFrom(java.lang.Object argKeyStart, java.lang.Object argAmtOrOptions) Navigates on a sorted map to a sorted map starting from a specified key, with options to read a fixed number of elements or configure whether start key is inclusive or exclusive.
Path.Impl	sortedMapRangeFromStart(java.lang.Object argMaxAmt) Navigates on a sorted map to a sorted map of all elements in that map from the start up to the provided max amount.
Path.Impl	sortedMapRangeTo(java.lang.Object argKeyTo) Navigates on a sorted map to a sorted map of all values in that map up to a key.
Path.Impl	sortedMapRangeTo(java.lang.Object argKeyTo, java.lang.Object argAmtOrOptions) Navigates on a sorted map to a sorted map up to a specified key, with options to read a fixed number of elements or configure whether end key is inclusive or exclusive.
Path.Impl	sortedMapRangeToEnd(java.lang.Object argMaxAmt) Navigates on a sorted map to a sorted map of all elements in that map from the end up to the provided max amount.
Path.Impl	sortedSetRange(java.lang.Object argElemStart, java.lang.Object argElemEnd) Navigates on a sorted set to a sorted set of all values in that set between a range.
Path.Impl	sortedSetRange(java.lang.Object argElemStart, java.lang.Object argElemEnd, java.lang.Object argOptions) Navigates on a sorted set to a sorted set of all values in that set between a range, with options to change inclusive/exclusive status of start and end elements.
Path.Impl	sortedSetRangeFrom(java.lang.Object argElemStart) Navigates on a sorted set to a sorted set of all values in that set after an element.
Path.Impl	sortedSetRangeFrom(java.lang.Object argElemStart, java.lang.Object argAmtOrOptions) Navigates on a sorted set to a sorted set starting from a specified element, with options to read a fixed number of elements or configure whether start element is inclusive or exclusive.
Path.Impl	sortedSetRangeFromStart(java.lang.Object argMaxAmt) Navigates on a sorted set to a sorted set of all values in that set after the start up to the provided max amount.
Path.Impl	sortedSetRangeTo(java.lang.Object argElemTo) Navigates on a sorted set to a sorted set of all values in that set up to an element.
Path.Impl	sortedSetRangeTo(java.lang.Object argElemTo, java.lang.Object argAmtOrOptions) Navigates on a sorted set to a sorted set up to a specified element, with options to read a fixed number of elements or configure whether end element is inclusive or exclusive.
Path.Impl	sortedSetRangeToEnd(java.lang.Object argMaxAmt) Navigates on a sorted set to a sorted set of all values in that set from the end, up to the provided max amount.
Path.Impl	stay() No-op that stays navigated at current point.
Path.Impl	stop() Stops current branch of navigation.
Path.Impl	sublist(java.lang.Object argStartIndex, java.lang.Object argEndIndex) Navigates to sublist bounded by two indexes.
<T0,R0,T1,T2,R1> Path.Impl	sublistDynamic(RamaFunction1<T0,R0> startFunction, RamaFunction2<T1,T2,R1> endFunction) Navigates to sublist bounded by indexes chosen by functions.
Path.Impl	subMap(java.lang.Object... argKeys) Navigates to a map containing subset of keys/values of starting map.
Path.Impl	subselect(Path path) Navigates to list of values navigated by provided path.
Path.Impl	subset(java.lang.Object... argVals) Navigates to subset of starting set with given elements.
<T0,R0> Path.Impl	term(RamaFunction1<T0,R0> termFunction) Terminal point of a transform path that updates navigated value with the provided function of one argument.
<T0,T1,R0> Path.Impl	term(RamaFunction2<T0,T1,R0> termFunction, java.lang.Object arg1) Terminal point of a transform path that updates navigated value with the provided function of two arguments.
<T0,T1,T2,R0> Path.Impl	term(RamaFunction3<T0,T1,T2,R0> termFunction, java.lang.Object arg1, java.lang.Object arg2) Terminal point of a transform path that updates navigated value with the provided function of three arguments.
<T0,T1,T2,T3,R0> Path.Impl	term(RamaFunction4<T0,T1,T2,T3,R0> termFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3) Terminal point of a transform path that updates navigated value with the provided function of four arguments.
<T0,T1,T2,T3,T4,R0> Path.Impl	term(RamaFunction5<T0,T1,T2,T3,T4,R0> termFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4) Terminal point of a transform path that updates navigated value with the provided function of five arguments.
<T0,T1,T2,T3,T4,T5,R0> Path.Impl	term(RamaFunction6<T0,T1,T2,T3,T4,T5,R0> termFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5) Terminal point of a transform path that updates navigated value with the provided function of six arguments.
<T0,T1,T2,T3,T4,T5,T6,R0> Path.Impl	term(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,R0> termFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6) Terminal point of a transform path that updates navigated value with the provided function of seven arguments.
<T0,T1,T2,T3,T4,T5,T6,T7,R0> Path.Impl	term(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,R0> termFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6, java.lang.Object arg7) Terminal point of a transform path that updates navigated value with the provided function of eight arguments.
Path.Impl	termVal(java.lang.Object argVal) Terminal point of a transform path that overrides navigated value to provided value
Path.Impl	termVoid() Terminal point of a transform path that sets navigated value to void, causing it to be removed.
Path.Impl	transformed(Path path) Navigates to transformation of current value with given path.
<T0,R0> Path.Impl	view(RamaFunction1<T0,R0> viewFunction) Navigates to result of applying given function to current value.
<T0,T1,R0> Path.Impl	view(RamaFunction2<T0,T1,R0> viewFunction, java.lang.Object arg1) Navigates to result of applying given function to current value and provided arguments.
<T0,T1,T2,R0> Path.Impl	view(RamaFunction3<T0,T1,T2,R0> viewFunction, java.lang.Object arg1, java.lang.Object arg2) Navigates to result of applying given function to current value and provided arguments.
<T0,T1,T2,T3,R0> Path.Impl	view(RamaFunction4<T0,T1,T2,T3,R0> viewFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3) Navigates to result of applying given function to current value and provided arguments.
<T0,T1,T2,T3,T4,R0> Path.Impl	view(RamaFunction5<T0,T1,T2,T3,T4,R0> viewFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4) Navigates to result of applying given function to current value and provided arguments.
<T0,T1,T2,T3,T4,T5,R0> Path.Impl	view(RamaFunction6<T0,T1,T2,T3,T4,T5,R0> viewFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5) Navigates to result of applying given function to current value and provided arguments.
<T0,T1,T2,T3,T4,T5,T6,R0> Path.Impl	view(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,R0> viewFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6) Navigates to result of applying given function to current value and provided arguments.
<T0,T1,T2,T3,T4,T5,T6,T7,R0> Path.Impl	view(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,R0> viewFunction, java.lang.Object arg1, java.lang.Object arg2, java.lang.Object arg3, java.lang.Object arg4, java.lang.Object arg5, java.lang.Object arg6, java.lang.Object arg7) Navigates to result of applying given function to current value and provided arguments.
Path.Impl	voidSetElem() Navigates to void element of set.
Path.Impl	withPageSize(java.lang.Object argPageSize, Path path) Pagination done by navigators in subpath use the specified page size.

Methods inherited from interface com.rpl.rama.Path

afterElem, all, beforeElem, beforeIndex, beginning, collect, collectOne, create, customNav, customNavBuilder, customNavBuilder, customNavBuilder, customNavBuilder, customNavBuilder, customNavBuilder, customNavBuilder, customNavBuilder, customNavBuilder, dispenseCollected, end, filteredList, filterEqual, filterGreaterThan, filterGreaterThanOrEqual, filterLessThan, filterLessThanOrEqual, filterNotEqual, filterNotSelected, filterPred, filterSelected, first, ifPath, ifPath, index, indexedVals, isCollected, key, last, mapKey, mapKeys, mapVals, multiPath, must, nth, nullToList, nullToSet, nullToVal, pathBuilder, pathBuilder, pathBuilder, pathBuilder, pathBuilder, pathBuilder, pathBuilder, pathBuilder, pathBuilder, putCollected, setElem, sortedMapRange, sortedMapRange, sortedMapRangeFrom, sortedMapRangeFrom, sortedMapRangeFromStart, sortedMapRangeTo, sortedMapRangeTo, sortedMapRangeToEnd, sortedSetRange, sortedSetRange, sortedSetRangeFrom, sortedSetRangeFrom, sortedSetRangeFromStart, sortedSetRangeTo, sortedSetRangeTo, sortedSetRangeToEnd, stay, stop, sublist, sublistDynamic, subMap, subselect, subset, term, term, term, term, term, term, term, term, termVal, termVoid, transformed, view, view, view, view, view, view, view, view, voidSetElem, withPageSize

Method Detail

all

Path.Impl all()

Navigates to every element of a collection. Works on lists, maps, and sets. For maps navigates to key/value pair with List interface. Value navigator.

Pseudocode example: select({"a": 1, "b": 2)}, Path.all()) -> [["a", 1], ["b", 2]]

Pseudocode example: select([1, 2, 3], Path.all()) -> [1, 2, 3]

For proxies transforms with this navigator produce diffs according to the type of data structure involved. For sequences produces SequenceIndexChangesDiff, SequenceIndexRemoveDiff, or a combination. For sets produces SetAddDiff, SetRemoveDiff, or a combination. For maps produces KeyDiff, KeyRemoveDiff, or a combination. When multiple diffs are produces they are combined with MultiDiff.

mapKeys

Path.Impl mapKeys()

Navigates to every key of a map. In transforms, changing a key is the same as removing the original key and then adding the updated key with the original value. Value navigator.

Pseudocode example: select({"a": 1, "b": 2)}, Path.mapKeys()) -> ["a", "b"]

For proxies transforms with this navigator produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff.

mapVals

Path.Impl mapVals()

Navigates to every value of a map. Value navigator.

Pseudocode example: select({"a": 1, "b": 2)}, Path.mapVals()) -> [1, 2]

For proxies transforms with this navigator produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff.

mapKey

Path.Impl mapKey(java.lang.Object argKey)

Navigates to a key in a map if it exists. In transforms, changing the key is the same as removing the original key and then adding the updated key with the original value. This navigator is generally only useful in transforms. Value navigator.

Pseudocode example: select({"a": 1, "b": 2)}, Path.mapKey("a")) -> ["a"]

Pseudocode example: select({"a": 1, "b": 2)}, Path.mapKey("c")) -> []

For proxies transforms with this navigator produce KeyChangeDiff or KeyRemoveDiff.

Parameters:

argKey - Key to navigate to

subMap

Path.Impl subMap(java.lang.Object... argKeys)

Navigates to a map containing subset of keys/values of starting map. Substructure navigator.

Pseudocode example: select({"a": 1, "b": 2, "c": 3)}, Path.subMap("a", "c", "d")) -> [{"a": 1, "c": 3}]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeys - Keys to select in starting map. Non-existing keys are ignored.

must

Path.Impl must(java.lang.Object... argKeys)

Navigates to value for a key in a map only if key exists. If key does not exist, stops navigation. For convenience, can navigate into further nested maps by providing multiple key arguments. Value navigator.

Example: Path.must("a", "b") is same as Path.must("a").must("b")

Pseudocode example: select({"a": 1, "b": 2)}, Path.must("a")) -> [1]

Pseudocode example: select({"a": 1, "b": 2)}, Path.must("c")) -> []

For proxies transforms with this navigator produce KeyDiff or KeyRemoveDiff.

Parameters:

argKeys - Keys to navigate in order

key

Path.Impl key(java.lang.Object... argKeys)

Navigates to value for a key in a map. For convenience, can navigate into further nested maps by providing multiple key arguments. Value navigator. Example: Path.key("a", "b") is same as Path.key("a").key("b")

Pseudocode example: select({"a": 1, "b": 2)}, Path.key("a")) -> [1]

Pseudocode example: select({"a": 1, "b": 2)}, Path.key("c")) -> [null]

For proxies transforms with this navigator produce KeyDiff or KeyRemoveDiff.

Parameters:

argKeys - Keys to navigate in order

sortedSetRange

Path.Impl sortedSetRange(java.lang.Object argElemStart,
                         java.lang.Object argElemEnd)

Navigates on a sorted set to a sorted set of all values in that set between a range. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRange("a", "d")) -> [sortedSet("a", "b")]

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRange("b", "e")) -> [sortedSet("b", "d")]

Parameters:

argElemStart - Start of range, inclusive

argElemEnd - End of range, exclusive

sortedSetRange

Path.Impl sortedSetRange(java.lang.Object argElemStart,
                         java.lang.Object argElemEnd,
                         java.lang.Object argOptions)

Navigates on a sorted set to a sorted set of all values in that set between a range, with options to change inclusive/exclusive status of start and end elements. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRange("a", "d", SortedRangeOptions.excludeStart())) -> [sortedSet("b")]

Pseudocode example: select(sortedSet{"a", "b", "d", "e"}, Path.sortedSetRange("b", "e", SortedRangeOptions.includeEnd())) -> [sortedSet("b", "d", "e")]

Parameters:

argElemStart - Start element of range, inclusive unless modified by options

argElemEnd - End element of range, exclusive unless modified by options

argOptions - Instance of SortedRangeOptions

sortedSetRangeFrom

Path.Impl sortedSetRangeFrom(java.lang.Object argElemStart)

Navigates on a sorted set to a sorted set of all values in that set after an element. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRangeFrom("b")) -> [sortedSet("b", "d")]

Parameters:

argElemStart - Start of range, inclusive

sortedSetRangeFrom

Path.Impl sortedSetRangeFrom(java.lang.Object argElemStart,
                             java.lang.Object argAmtOrOptions)

Navigates on a sorted set to a sorted set starting from a specified element, with options to read a fixed number of elements or configure whether start element is inclusive or exclusive. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRangeFrom("a", 2)) -> [sortedSet("a", "b")]

Pseudocode example: select(sortedSet{"a", "b", "d", "e"}, Path.sortedSetRangeFrom("a", SortedRangeFromOptions.excludeStart().maxAmt(2))) -> [sortedSet("b", "d")]

Parameters:

argElemStart - Start of range, inclusive unless modified by options

argAmtOrOptions - Either a number indicating maximum number of elements to include in result or an instance of SortedRangeFromOptions

sortedSetRangeFromStart

Path.Impl sortedSetRangeFromStart(java.lang.Object argMaxAmt)

Navigates on a sorted set to a sorted set of all values in that set after the start up to the provided max amount. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRangeFromStart(2)) -> [sortedSet("a", "b")]

Parameters:

argMaxAmt - Maximum number of entries to return

sortedSetRangeTo

Path.Impl sortedSetRangeTo(java.lang.Object argElemTo)

Navigates on a sorted set to a sorted set of all values in that set up to an element. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRangeTo("d")) -> [sortedSet("a", "b")]

Parameters:

argElemTo - End of range, exclusive

sortedSetRangeTo

Path.Impl sortedSetRangeTo(java.lang.Object argElemTo,
                           java.lang.Object argAmtOrOptions)

Navigates on a sorted set to a sorted set up to a specified element, with options to read a fixed number of elements or configure whether end element is inclusive or exclusive. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d", "e"}, Path.sortedSetRangeTo("e", 2)) -> [sortedSet("b", "d")]

Pseudocode example: select(sortedSet{"a", "b", "d", "e"}, Path.sortedSetRangeTo("e", SortedRangeToOptions.includeEnd().maxAmt(2))) -> [sortedSet("d", "e")]

Pseudocode example: select(sortedSet{"a", "b", "d", "e"}, Path.sortedSetRangeTo("b", SortedRangeToOptions.includeEnd())) -> [sortedSet("a", "b")]

Parameters:

argElemTo - End of range, exclusive unless modified by options

argAmtOrOptions - Either a number indicating maximum number of elements to include in result or an instance of SortedRangeToOptions

sortedSetRangeToEnd

Path.Impl sortedSetRangeToEnd(java.lang.Object argMaxAmt)

Navigates on a sorted set to a sorted set of all values in that set from the end, up to the provided max amount. Useful on subindexed sets. Substructure navigator.

Pseudocode example: select(sortedSet{"a", "b", "d"}, Path.sortedSetRangeToEnd(2)) -> [sortedSet("b", "d")]

Parameters:

argMaxAmt - Maximum number of entries to return

sortedMapRange

Path.Impl sortedMapRange(java.lang.Object argKeyStart,
                         java.lang.Object argKeyEnd)

Navigates on a sorted map to a sorted map of all elements in that map between a range of keys. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRange("a", "d")) -> [sortedMap("a": 1, "b": 2)]

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRange("b", "e")) -> [sortedMap{"b": 2, "d": 4})]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeyStart - Start key of range, inclusive

argKeyEnd - End key of range, exclusive

sortedMapRange

Path.Impl sortedMapRange(java.lang.Object argKeyStart,
                         java.lang.Object argKeyEnd,
                         java.lang.Object argOptions)

Navigates on a sorted map to a sorted map of all elements in that map between a range of keys, with options to change inclusive/exclusive status of start and end keys. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRange("a", "d", SortedRangeOptions.excludeStart())) -> [sortedMap("b": 2)]

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRange("b", "d", SortedRangeOptions.includeEnd())) -> [sortedMap{"b": 2, "d": 4})]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeyStart - Start key of range, inclusive unless modified by options

argKeyEnd - End key of range, exclusive unless modified by options

argOptions - Instance of SortedRangeOptions

sortedMapRangeFrom

Path.Impl sortedMapRangeFrom(java.lang.Object argKeyStart)

Navigates on a sorted map to a sorted map of all elements in that map after a key. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRangeFrom("b")) -> [sortedMap("b": 2, "d": 4)]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeyStart - Start key of range, inclusive

sortedMapRangeFrom

Path.Impl sortedMapRangeFrom(java.lang.Object argKeyStart,
                             java.lang.Object argAmtOrOptions)

Navigates on a sorted map to a sorted map starting from a specified key, with options to read a fixed number of elements or configure whether start key is inclusive or exclusive. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRangeFrom("a", 2)) -> [sortedMap("a": 1, "b": 2)]

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4, "e": 5}, Path.sortedMapRangeFrom("a", SortedRangeFromOptions.excludeStart().maxAmt(2))) -> [sortedMap("b": 2, "d": 4)]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeyStart - Start key of range, inclusive

argAmtOrOptions - Either a number indicating maximum number of elements to include in result or an instance of SortedRangeFromOptions

sortedMapRangeFromStart

Path.Impl sortedMapRangeFromStart(java.lang.Object argMaxAmt)

Navigates on a sorted map to a sorted map of all elements in that map from the start up to the provided max amount. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRangeFromStart(2)) -> [sortedMap("a": 1, "b": 2)]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argMaxAmt - Maximum number of entries to return

sortedMapRangeTo

Path.Impl sortedMapRangeTo(java.lang.Object argKeyTo)

Navigates on a sorted map to a sorted map of all values in that map up to a key. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRangeTo("d")) -> [sortedMap("a": 1, "b": 2)]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeyTo - End key of range, exclusive

sortedMapRangeTo

Path.Impl sortedMapRangeTo(java.lang.Object argKeyTo,
                           java.lang.Object argAmtOrOptions)

Navigates on a sorted map to a sorted map up to a specified key, with options to read a fixed number of elements or configure whether end key is inclusive or exclusive. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4, "e": 5}, Path.sortedMapRangeTo("e", 2)) -> [sortedMap("b": 2, "d": 4)]

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4, "e": 5}, Path.sortedMapRangeTo("e", SortedRangeToOptions.includeEnd().maxAmt(2))) -> [sortedMap("d": 4, "e": 5)]

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4, "e": 5}, Path.sortedMapRangeTo("b", SortedRangeToOptions.includeEnd())) -> [sortedMap("a": 1, "b": 2)]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argKeyTo - End key of range, exclusive unless modified by options

argAmtOrOptions - Either a number indicating maximum number of elements to include in result or an instance of SortedRangeToOptions

sortedMapRangeToEnd

Path.Impl sortedMapRangeToEnd(java.lang.Object argMaxAmt)

Navigates on a sorted map to a sorted map of all elements in that map from the end up to the provided max amount. Useful on subindexed maps. Substructure navigator.

Pseudocode example: select(sortedMap{"a": 1, "b": 2, "d": 4}, Path.sortedMapRangeFromStart(2)) -> [sortedMap("b": 1, "d": 2)]

For proxies transforms with this navigator that do fine-grained updates to the submap produce KeysRemoveDiff, KeysDiff, or a combination of the two with MultiDiff. If the submap is modified in a coarse-grained way (e.g. overridden completely with Path.termVal(java.lang.Object)), this navigator will produce a NewValueDiff.

Parameters:

argMaxAmt - Maximum number of entries to return

afterElem

Path.Impl afterElem()

Navigates on a list to void element at end. Used in transforms to append a single element. Virtual value navigator.

Pseudocode example: transform([1, 2], Path.afterElem().termVal(4)) -> [1, 2, 4]

For proxies transforms with this navigator produce SequenceInsertDiff.

beforeElem

Path.Impl beforeElem()

Navigates on a list to void element at beginning. Used in transforms to prepend a single element. Virtual value navigator.

Pseudocode example: transform([1, 2], Path.beforeElem().termVal(4)) -> [4, 1, 2]

For proxies transforms with this navigator produce SequenceInsertDiff.

beginning

Path.Impl beginning()

Navigates on a list to empty subsequence at beginning. Used in transforms to prepend multiple elements. Substructure navigator.

Pseudocode example: transform([1, 2], Path.beginning().termVal([3, 4])) -> [3, 4, 1, 2]

For proxies transforms with this navigator produce SequenceInsertsDiff.

end

Path.Impl end()

Navigates on a list to empty subsequence at end. Used in transforms to append multiple elements. Substructure navigator.

Pseudocode example: transform([1, 2], Path.end().termVal([3, 4])) -> [1, 2, 3, 4]

For proxies transforms with this navigator produce SequenceInsertsDiff.

first

Path.Impl first()

Navigates on list to first element if not empty. If empty, stops navigation. Value navigator.

Pseudocode example: select([1, 2, 3], Path.first()) -> [1]

Pseudocode example: select([], Path.first()) -> []

For proxies transforms with this navigator produce SequenceIndexChangeDiff or SequenceIndexRemoveDiff.

last

Path.Impl last()

Navigates on list to last element if not empty. If empty, stops navigation. Value navigator.

Pseudocode example: select([1, 2, 3], Path.last()) -> [3]

Pseudocode example: select([], Path.last()) -> []

For proxies transforms with this navigator produce SequenceIndexChangeDiff or SequenceIndexRemoveDiff.

indexedVals

Path.Impl indexedVals()

Navigates to pairs of [index, value] for every element of list. Pairs are represented as lists of two elements. Transforms should produce new [index, value] pairs. Changing an index in a transform will move the element in the resulting list. Value navigator.

Pseudocode example: select([1, 2, 3], Path.indexedVals()) -> [[0, 1], [1, 2], [2, 3]]

Pseudocode example: transform([1, 2, 3, 4], Path.indexedVals().first().termVal(0)) -> [4, 3, 2, 1]

beforeIndex

Path.Impl beforeIndex(java.lang.Object argIndex)

Navigates on list to void element before an index. Used in transforms to insert an element in middle of list. Virtual value navigator.

Pseudocode example: transform([1, 2, 3], Path.beforeIndex(2).termVal(0)) -> [1, 2, 0, 3]

For proxies transforms with this navigator produce SequenceInsertDiff.

Parameters:

argIndex - Index of list

filteredList

Path.Impl filteredList(Path path)

Navigates to sublist of elements filtered based on given Path. An element is included in sublist if path applied to that element navigates to at least one value. Transforms on sublist will modify the locations in the original list. Substructure navigator.

Pseudocode example: select([1, 2, 3, 4, 5], Path.filteredList(Path.filterPred(Ops.IS_ODD))) -> [1, 3, 5]

Pseudocode example: transform([1, 2, 3, 4, 5], Path.filteredList(Path.filterPred(Ops.IS_ODD)).term(Ops.INC)) -> [2, 2, 4, 4, 6]

For proxies transforms with this navigator produce diffs according to rest of transform path.

Parameters:

path - Subpath evaluated on each element of list

index

Path.Impl index(java.lang.Object argIndex)

Navigates to the index of a list if it exists. This navigates to the index, not to the value at that index. Changing the index in a transform will move the element in the resulting list. Value navigator.

Pseudocode example: select([1, 2, 3], Path.index(1)) -> [1]

Pseudocode example: select([1, 2, 3], Path.index(9)) -> []

Pseudocode example: transform([1, 2, 3], Path.index(0).termVal(2)) -> [2, 3, 1]

For proxies transforms with this navigator produce SequenceReorderDiff.

Parameters:

argIndex - Index of list

nth

Path.Impl nth(java.lang.Object argIndex)

Navigates to value for index in a list. Value navigator.

Pseudocode example: select([1, 2, 3], Path.nth(1)) -> [2]

For proxies transforms with this navigator produce SequenceIndexChangeDiff or SequenceIndexRemoveDiff.

Parameters:

argIndex - Index of list

sublist

Path.Impl sublist(java.lang.Object argStartIndex,
                  java.lang.Object argEndIndex)

Navigates to sublist bounded by two indexes. Substructure navigator.

Pseudocode example: select([1, 2, 3, 4], Path.sublist(2, 4)) -> [[2, 3]]

Pseudocode example: transform([1, 2, 3, 4], Path.sublist(2, 4).termVal(null)) -> [1, 4]

For proxies transforms with this navigator produce sequence diffs according to the rest of the transform path.

Parameters:

argStartIndex - Start index of range, inclusive

argEndIndex - End index of range, exclusive

sublistDynamic

<T0,R0,T1,T2,R1> Path.Impl sublistDynamic(RamaFunction1<T0,R0> startFunction,
                                          RamaFunction2<T1,T2,R1> endFunction)

Navigates to sublist bounded by indexes chosen by functions. Substructure navigator.

For proxies transforms with this navigator produce sequence diffs according to the rest of the transform path.

Parameters:

startFunction - Receives list as input and returns start index (inclusive)

endFunction - Receives list and start index as input and returns end index (exclusive)

voidSetElem

Path.Impl voidSetElem()

Navigates to void element of set. Used to add a single element to a set in transforms. Virtual value navigator.

For proxies transforms with this navigator produce SetAddDiff.

Pseudocode example: transform(set{1, 2}, Path.voidSetElem().termVal(5)) -> set{1, 2, 5}

setElem

Path.Impl setElem(java.lang.Object argVal)

Navigates to element of set if it exists. If element does not exist, stops navigation. Value navigator.

Pseudocode example: select(set{1, 2}, Path.setElem(1)) -> [1]

Pseudocode example: select(set{1, 2}, Path.setElem(13)) -> []

Pseudocode example: transform(set{1, 2}, Path.setElem(1).termVal(3)) -> set{2, 3}

For proxies transforms with this navigator produce SetAddDiff, SetRemoveDiff, or a combination with MultiDiff.

Parameters:

argVal - Set element

subset

Path.Impl subset(java.lang.Object... argVals)

Navigates to subset of starting set with given elements. Substructure navigator.

Pseudocode example: select(set{1, 2, 3}, Path.subset(1, 3, 4)) -> [set{1, 3}]

For proxies transforms with this navigator produce SetAddDiff, SetRemoveDiff, or a combination with MultiDiff.

Parameters:

argVals - Elements to select in starting set. Non-existing elements are ignored.

nullToList

Path.Impl nullToList()

Navigates to empty list if currently navigated to null. Otherwise, stays navigated at current location. View navigator.

Pseudocode example: select(null, Path.nullToList()) -> [[]]

Pseudocode example: select(3, Path.nullToList()) -> [3]

Pseudocode example: transform(null, Path.nullToList().term(Ops.IDENTITY)) -> []

For proxies transforms with this navigator produce diffs depending on if original value was null. If null, produces NewValueDiff. Otherwise produces diffs according to rest of transform path.

nullToSet

Path.Impl nullToSet()

Navigates to empty set if currently navigated to null. Otherwise, stays navigated at current location. View navigator.

Pseudocode example: select(null, Path.nullToSet()) -> [set{}]

Pseudocode example: select(3, Path.nullToSet()) -> [3]

Pseudocode example: transform(null, Path.nullToSet().term(Ops.IDENTITY)) -> set{}

For proxies transforms with this navigator produce diffs depending on if original value was null. If null, produces NewValueDiff. Otherwise produces diffs according to rest of transform path.

nullToVal

Path.Impl nullToVal(java.lang.Object argVal)

Navigates to given value if currently navigated to null. Otherwise, stays navigated at current location. View navigator.

Pseudocode example: select(null, Path.nullToVal(1)) -> [1]

Pseudocode example: select(3, Path.nullToVal(1)) -> [3]

Pseudocode example: transform(null, Path.nullToVal(1).term(Ops.IDENTITY)) -> 1

For proxies transforms with this navigator produce diffs depending on if original value was null. If null, produces NewValueDiff. Otherwise produces diffs according to rest of transform path.

Parameters:

argVal - Value to navigate to if currently navigated to null

transformed

Path.Impl transformed(Path path)

Navigates to transformation of current value with given path. View navigator.

Pseudocode example: select([1, 2, 3], Path.transformed(Path.all().term(Ops.INC))) -> [[2, 3, 4]]

For proxies transforms with this navigator produce a combination of diffs from execution of path and the rest of the transform path.

Parameters:

path - Transform path

collect

Path.Impl collect(Path path)

Collects a list of values selected with given path from current point.

Parameters:

path - Path to use for select

See Also:

Value collection documentation

collectOne

Path.Impl collectOne(Path path)

Collects a single value selected with given path from current point. Exception if path selects zero values or more than one value.

Parameters:

path - Path to use for select

See Also:

Value collection documentation

putCollected

Path.Impl putCollected(java.lang.Object argVal)

Adds given value to collected values.

Parameters:

argVal - Value to add

See Also:

Value collection documentation

isCollected

<T0,R0> Path.Impl isCollected(RamaFunction1<T0,R0> predicate)

Stops navigation if given function on collected values returns false. Otherwise, stays navigated at current point. Filter navigator.

Parameters:

predicate - Function receiving list of collected values and returning true or false

See Also:

Value collection documentation

dispenseCollected

Path.Impl dispenseCollected()

Drops all collected values from subsequent navigation

See Also:

Value collection documentation

stay

Path.Impl stay()

No-op that stays navigated at current point. Control navigator.

Pseudocode example: select(2, Path.stay()) -> [2]

stop

Path.Impl stop()

Stops current branch of navigation. Control navigator.

Pseudocode example: select(2, Path.stop()) -> []

ifPath

Path.Impl ifPath(Path conditionPath,
                 Path thenPath)

Tests condition against current point and continues navigating with thenPath if condition passes. Condition passes if it navigates to at least one value. If condition fails, this branch of navigation stops. Control navigator.

Parameters:

conditionPath - Condition path

thenPath - Path used if condition passes

See Also:

Control navigator documentation

ifPath

Path.Impl ifPath(Path conditionPath,
                 Path thenPath,
                 Path elsePath)

Tests condition against current point and continues navigating with thenPath if condition passes. Condition passes if it navigates to at least one value. If condition fails, continues navigating with elsePath. Control navigator.

Parameters:

conditionPath - Condition path

thenPath - Path used if condition passes

elsePath - Path used if condition fails

See Also:

Control navigator documentation

multiPath

Path.Impl multiPath(Path... paths)

Navigates to each provided path in order, all starting from this point. Control navigator.

Pseudocode example: select({"a": 1, "b": 2}, Path.multiPath(Path.key("a"), Path.key("b"))) -> [1, 2]

For proxies transforms with this navigator produce MultiDiff.

Parameters:

paths - Sequence of paths to execute

See Also:

Control navigator documentation

subselect

Path.Impl subselect(Path path)

Navigates to list of values navigated by provided path. Transforms on that list will update original locations of each value, no matter how nested. Control navigator.

For proxies transforms with this navigator produce diffs according to rest of transform path.

Parameters:

path - Subpath

See Also:

Control navigator documentation

filterPred

<T0,R0> Path.Impl filterPred(RamaFunction1<T0,R0> pred)

Continues navigation if provided function returns true on current value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterPred(Ops.IS_EVEN)) -> [2]

Pseudocode example: select(1, Path.filterPred(Ops.IS_EVEN)) -> []

Parameters:

pred - Test function

filterEqual

Path.Impl filterEqual(java.lang.Object argVal)

Continues navigation if current value is equal to provided value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterEqual(2)) -> [2]

Pseudocode example: select(1, Path.filterEqual(2)) -> []

Parameters:

argVal - Test value

filterNotEqual

Path.Impl filterNotEqual(java.lang.Object argVal)

Continues navigation if current value is not equal to provided value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterNotEqual(2)) -> []

Pseudocode example: select(1, Path.filterNotEqual(2)) -> [1]

Parameters:

argVal - Test value

filterLessThan

Path.Impl filterLessThan(java.lang.Object argVal)

Continues navigation if current value is less than provided value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterLessThan(2)) -> []

Pseudocode example: select(1, Path.filterLessThan(2)) -> [1]

Parameters:

argVal - Test value

filterLessThanOrEqual

Path.Impl filterLessThanOrEqual(java.lang.Object argVal)

Continues navigation if current value is less than or equal to provided value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterLessThanOrEqual(1)) -> []

Pseudocode example: select(2, Path.filterLessThanOrEqual(2)) -> [2]

Pseudocode example: select(2, Path.filterLessThanOrEqual(4)) -> [2]

Parameters:

argVal - Test value

filterGreaterThan

Path.Impl filterGreaterThan(java.lang.Object argVal)

Continues navigation if current value is greater than provided value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterGreaterThan(2)) -> []

Pseudocode example: select(3, Path.filterGreaterThan(2)) -> [3]

Parameters:

argVal - Test value

filterGreaterThanOrEqual

Path.Impl filterGreaterThanOrEqual(java.lang.Object argVal)

Continues navigation if current value is greater than or equal to provided value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select(2, Path.filterLessThanOrEqual(1)) -> [2]

Pseudocode example: select(2, Path.filterLessThanOrEqual(2)) -> [2]

Pseudocode example: select(2, Path.filterLessThanOrEqual(4)) -> []

Parameters:

argVal - Test value

filterSelected

Path.Impl filterSelected(Path path)

Continues navigation if provided path executed on current value navigates to at least one value. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select([1, 2, 3], Path.filterSelected(Path.all().filterPred(Ops.IS_EVEN))) -> [[1, 2, 3]]

Pseudocode example: select([1, 3, 5], Path.filterSelected(Path.all().filterPred(Ops.IS_EVEN))) -> []

Parameters:

path - Condition path

filterNotSelected

Path.Impl filterNotSelected(Path path)

Continues navigation if provided path executed on current value navigates to zero values. Otherwise, stops current branch of navigation. Filter navigator.

Pseudocode example: select([1, 2, 3], Path.filterNotSelected(Path.all().filterPred(Ops.IS_EVEN))) -> []

Pseudocode example: select([1, 3, 5], Path.filterNotSelected(Path.all().filterPred(Ops.IS_EVEN))) -> [[1, 3, 5]]

Parameters:

path - Condition path

withPageSize

Path.Impl withPageSize(java.lang.Object argPageSize,
                       Path path)

Pagination done by navigators in subpath use the specified page size. Can only be used in yielding selects.

Parameters:

argPageSize - Page size

path - Subpath

termVal

Path.Impl termVal(java.lang.Object argVal)

Terminal point of a transform path that overrides navigated value to provided value

See Also:

Transform paths documentation

termVoid

Path.Impl termVoid()

Terminal point of a transform path that sets navigated value to void, causing it to be removed.

For proxies transforms with this navigator produce NewValueDiff.

See Also:

Transform paths documentation

customNav

Path.Impl customNav(Navigator nav)

Adds custom navigator implementation to Path

See Also:

Custom navigators documentation

view

<T0,R0> Path.Impl view(RamaFunction1<T0,R0> viewFunction)

Navigates to result of applying given function to current value. View navigator.

Pseudocode example: select(2, Path.view(Ops.INC)) -> [3]

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply

view

<T0,T1,R0> Path.Impl view(RamaFunction2<T0,T1,R0> viewFunction,
                          java.lang.Object arg1)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of two arguments

view

<T0,T1,T2,R0> Path.Impl view(RamaFunction3<T0,T1,T2,R0> viewFunction,
                             java.lang.Object arg1,
                             java.lang.Object arg2)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of three arguments

view

<T0,T1,T2,T3,R0> Path.Impl view(RamaFunction4<T0,T1,T2,T3,R0> viewFunction,
                                java.lang.Object arg1,
                                java.lang.Object arg2,
                                java.lang.Object arg3)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of four arguments

view

<T0,T1,T2,T3,T4,R0> Path.Impl view(RamaFunction5<T0,T1,T2,T3,T4,R0> viewFunction,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of five arguments

view

<T0,T1,T2,T3,T4,T5,R0> Path.Impl view(RamaFunction6<T0,T1,T2,T3,T4,T5,R0> viewFunction,
                                      java.lang.Object arg1,
                                      java.lang.Object arg2,
                                      java.lang.Object arg3,
                                      java.lang.Object arg4,
                                      java.lang.Object arg5)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of six arguments

view

<T0,T1,T2,T3,T4,T5,T6,R0> Path.Impl view(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,R0> viewFunction,
                                         java.lang.Object arg1,
                                         java.lang.Object arg2,
                                         java.lang.Object arg3,
                                         java.lang.Object arg4,
                                         java.lang.Object arg5,
                                         java.lang.Object arg6)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of seven arguments

view

<T0,T1,T2,T3,T4,T5,T6,T7,R0> Path.Impl view(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,R0> viewFunction,
                                            java.lang.Object arg1,
                                            java.lang.Object arg2,
                                            java.lang.Object arg3,
                                            java.lang.Object arg4,
                                            java.lang.Object arg5,
                                            java.lang.Object arg6,
                                            java.lang.Object arg7)

Navigates to result of applying given function to current value and provided arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to view.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

viewFunction - Function to apply of eight arguments

customNavBuilder

Path.Impl customNavBuilder(RamaFunction0<Navigator> builderFunction)

Adds a custom navigator built dynamically with the provided function of zero arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of zero arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0> Path.Impl customNavBuilder(RamaFunction1<T0,Navigator> builderFunction,
                                java.lang.Object arg0)

Adds a custom navigator built dynamically with the provided function of one argument. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of one argument

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1> Path.Impl customNavBuilder(RamaFunction2<T0,T1,Navigator> builderFunction,
                                   java.lang.Object arg0,
                                   java.lang.Object arg1)

Adds a custom navigator built dynamically with the provided function of two arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of two arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1,T2> Path.Impl customNavBuilder(RamaFunction3<T0,T1,T2,Navigator> builderFunction,
                                      java.lang.Object arg0,
                                      java.lang.Object arg1,
                                      java.lang.Object arg2)

Adds a custom navigator built dynamically with the provided function of three arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of three arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1,T2,T3> Path.Impl customNavBuilder(RamaFunction4<T0,T1,T2,T3,Navigator> builderFunction,
                                         java.lang.Object arg0,
                                         java.lang.Object arg1,
                                         java.lang.Object arg2,
                                         java.lang.Object arg3)

Adds a custom navigator built dynamically with the provided function of four arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of four arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1,T2,T3,T4> Path.Impl customNavBuilder(RamaFunction5<T0,T1,T2,T3,T4,Navigator> builderFunction,
                                            java.lang.Object arg0,
                                            java.lang.Object arg1,
                                            java.lang.Object arg2,
                                            java.lang.Object arg3,
                                            java.lang.Object arg4)

Adds a custom navigator built dynamically with the provided function of five arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of five arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1,T2,T3,T4,T5> Path.Impl customNavBuilder(RamaFunction6<T0,T1,T2,T3,T4,T5,Navigator> builderFunction,
                                               java.lang.Object arg0,
                                               java.lang.Object arg1,
                                               java.lang.Object arg2,
                                               java.lang.Object arg3,
                                               java.lang.Object arg4,
                                               java.lang.Object arg5)

Adds a custom navigator built dynamically with the provided function of six arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of six arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1,T2,T3,T4,T5,T6> Path.Impl customNavBuilder(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,Navigator> builderFunction,
                                                  java.lang.Object arg0,
                                                  java.lang.Object arg1,
                                                  java.lang.Object arg2,
                                                  java.lang.Object arg3,
                                                  java.lang.Object arg4,
                                                  java.lang.Object arg5,
                                                  java.lang.Object arg6)

Adds a custom navigator built dynamically with the provided function of seven arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of seven arguments

See Also:

Custom navigators documentation

customNavBuilder

<T0,T1,T2,T3,T4,T5,T6,T7> Path.Impl customNavBuilder(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,Navigator> builderFunction,
                                                     java.lang.Object arg0,
                                                     java.lang.Object arg1,
                                                     java.lang.Object arg2,
                                                     java.lang.Object arg3,
                                                     java.lang.Object arg4,
                                                     java.lang.Object arg5,
                                                     java.lang.Object arg6,
                                                     java.lang.Object arg7)

Adds a custom navigator built dynamically with the provided function of eight arguments. Additional arguments to customNavBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Navigator builder function of eight arguments

See Also:

Custom navigators documentation

pathBuilder

Path.Impl pathBuilder(RamaFunction0<Path> builderFunction)

Concatenates a path to the current path constructed with the provided function of zero arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of zero arguments

pathBuilder

<T0> Path.Impl pathBuilder(RamaFunction1<T0,Path> builderFunction,
                           java.lang.Object arg0)

Concatenates a path to the current path constructed with the provided function of one argument. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of one argument

pathBuilder

<T0,T1> Path.Impl pathBuilder(RamaFunction2<T0,T1,Path> builderFunction,
                              java.lang.Object arg0,
                              java.lang.Object arg1)

Concatenates a path to the current path constructed with the provided function of two arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of two arguments

pathBuilder

<T0,T1,T2> Path.Impl pathBuilder(RamaFunction3<T0,T1,T2,Path> builderFunction,
                                 java.lang.Object arg0,
                                 java.lang.Object arg1,
                                 java.lang.Object arg2)

Concatenates a path to the current path constructed with the provided function of three arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of three arguments

pathBuilder

<T0,T1,T2,T3> Path.Impl pathBuilder(RamaFunction4<T0,T1,T2,T3,Path> builderFunction,
                                    java.lang.Object arg0,
                                    java.lang.Object arg1,
                                    java.lang.Object arg2,
                                    java.lang.Object arg3)

Concatenates a path to the current path constructed with the provided function of four arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of four arguments

pathBuilder

<T0,T1,T2,T3,T4> Path.Impl pathBuilder(RamaFunction5<T0,T1,T2,T3,T4,Path> builderFunction,
                                       java.lang.Object arg0,
                                       java.lang.Object arg1,
                                       java.lang.Object arg2,
                                       java.lang.Object arg3,
                                       java.lang.Object arg4)

Concatenates a path to the current path constructed with the provided function of five arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of five arguments

pathBuilder

<T0,T1,T2,T3,T4,T5> Path.Impl pathBuilder(RamaFunction6<T0,T1,T2,T3,T4,T5,Path> builderFunction,
                                          java.lang.Object arg0,
                                          java.lang.Object arg1,
                                          java.lang.Object arg2,
                                          java.lang.Object arg3,
                                          java.lang.Object arg4,
                                          java.lang.Object arg5)

Concatenates a path to the current path constructed with the provided function of six arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of six arguments

pathBuilder

<T0,T1,T2,T3,T4,T5,T6> Path.Impl pathBuilder(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,Path> builderFunction,
                                             java.lang.Object arg0,
                                             java.lang.Object arg1,
                                             java.lang.Object arg2,
                                             java.lang.Object arg3,
                                             java.lang.Object arg4,
                                             java.lang.Object arg5,
                                             java.lang.Object arg6)

Concatenates a path to the current path constructed with the provided function of seven arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of seven arguments

pathBuilder

<T0,T1,T2,T3,T4,T5,T6,T7> Path.Impl pathBuilder(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,Path> builderFunction,
                                                java.lang.Object arg0,
                                                java.lang.Object arg1,
                                                java.lang.Object arg2,
                                                java.lang.Object arg3,
                                                java.lang.Object arg4,
                                                java.lang.Object arg5,
                                                java.lang.Object arg6,
                                                java.lang.Object arg7)

Concatenates a path to the current path constructed with the provided function of eight arguments. Additional arguments to pathBuilder after the first are passed to the provided function at runtime.

Parameters:

builderFunction - Path builder function of eight arguments

term

<T0,R0> Path.Impl term(RamaFunction1<T0,R0> termFunction)

Terminal point of a transform path that updates navigated value with the provided function of one argument.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function on navigated value

See Also:

Transform paths documentation

term

<T0,T1,R0> Path.Impl term(RamaFunction2<T0,T1,R0> termFunction,
                          java.lang.Object arg1)

Terminal point of a transform path that updates navigated value with the provided function of two arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of two arguments

See Also:

Transform paths documentation

term

<T0,T1,T2,R0> Path.Impl term(RamaFunction3<T0,T1,T2,R0> termFunction,
                             java.lang.Object arg1,
                             java.lang.Object arg2)

Terminal point of a transform path that updates navigated value with the provided function of three arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of three arguments

See Also:

Transform paths documentation

term

<T0,T1,T2,T3,R0> Path.Impl term(RamaFunction4<T0,T1,T2,T3,R0> termFunction,
                                java.lang.Object arg1,
                                java.lang.Object arg2,
                                java.lang.Object arg3)

Terminal point of a transform path that updates navigated value with the provided function of four arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of four arguments

See Also:

Transform paths documentation

term

<T0,T1,T2,T3,T4,R0> Path.Impl term(RamaFunction5<T0,T1,T2,T3,T4,R0> termFunction,
                                   java.lang.Object arg1,
                                   java.lang.Object arg2,
                                   java.lang.Object arg3,
                                   java.lang.Object arg4)

Terminal point of a transform path that updates navigated value with the provided function of five arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of five arguments

See Also:

Transform paths documentation

term

<T0,T1,T2,T3,T4,T5,R0> Path.Impl term(RamaFunction6<T0,T1,T2,T3,T4,T5,R0> termFunction,
                                      java.lang.Object arg1,
                                      java.lang.Object arg2,
                                      java.lang.Object arg3,
                                      java.lang.Object arg4,
                                      java.lang.Object arg5)

Terminal point of a transform path that updates navigated value with the provided function of six arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of six arguments

See Also:

Transform paths documentation

term

<T0,T1,T2,T3,T4,T5,T6,R0> Path.Impl term(RamaFunction7<T0,T1,T2,T3,T4,T5,T6,R0> termFunction,
                                         java.lang.Object arg1,
                                         java.lang.Object arg2,
                                         java.lang.Object arg3,
                                         java.lang.Object arg4,
                                         java.lang.Object arg5,
                                         java.lang.Object arg6)

Terminal point of a transform path that updates navigated value with the provided function of seven arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of seven arguments

See Also:

Transform paths documentation

term

<T0,T1,T2,T3,T4,T5,T6,T7,R0> Path.Impl term(RamaFunction8<T0,T1,T2,T3,T4,T5,T6,T7,R0> termFunction,
                                            java.lang.Object arg1,
                                            java.lang.Object arg2,
                                            java.lang.Object arg3,
                                            java.lang.Object arg4,
                                            java.lang.Object arg5,
                                            java.lang.Object arg6,
                                            java.lang.Object arg7)

Terminal point of a transform path that updates navigated value with the provided function of eight arguments. The first argument will be the navigated value, and remaining arguments will be additional arguments provided to term.

For proxies transforms with this navigator produce NewValueDiff.

Parameters:

termFunction - Transform function of eight arguments

See Also:

Transform paths documentation