Unary (BandM metatools API doc)

java.lang.Object
- eu.bandm.tools.paisley.Pattern
- - eu.bandm.tools.paisley.Unary<A,B>

Type Parameters:

A - the target type of the contained subpattern

B - the target type of the containing pattern

All Implemented Interfaces:

Serializable, Cloneable

Direct Known Subclasses:

CompiledUnary, FlatMultiTransform, Proxy, Transform
```
public abstract class Unary<A,B>
extends Pattern
```
Abstract base class for patterns that contain one subpattern. Methods have default implementations that delegate to the subpattern.
Subclasses must implement the Pattern.match(A) method.

See Also:

Serialized Form

Constructor Summary

Constructors
Modifier Constructor and Description

protected Unary()

protected Unary(Pattern<? super A> body)
Creates a new pattern.

Constructors
Modifier	Constructor and Description
`protected`	`Unary()`
`protected`	`Unary(Pattern<? super A> body)` Creates a new pattern.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`binds(Variable<?> var)` Checks whether a variable is bound by this pattern.
`void`	`clear(boolean recursively)` Disposes of all internal state related to results and nondeterminism.
`Pattern<B>`	`clone()` Makes a matching-state copy if this pattern.
`protected void`	`compileClear(eu.bandm.tools.paisley.CompilationContext context, boolean recursively)`
`protected void`	`compileCut(eu.bandm.tools.paisley.CompilationContext context, boolean recursively)`
`void`	`cut(boolean recursively)` Disposes of all internal state related to nondeterminism.
`Pattern<A>`	`getBody()`
`boolean`	`isDeterministic()` Checks whether this pattern is deterministic.
`boolean`	`matchAgain()` Attempts to re-match this pattern against a previously matched object.
`boolean`	`preserves(Variable<?> var)` Checks whether a variable is preserved by this pattern, unconditionally.
`boolean`	`preserves(Variable<?> var, boolean success)` Checks whether a variable is preserved by this pattern, conditionally on success or failure.
`protected void`	`setBody(Pattern<A> body)`
`String`	`toString()`

Methods inherited from class eu.bandm.tools.paisley.Pattern
all, all, all, all, all, and, andThen, andThen, any, any, aside, both, clear, compareTo, compile, compileClear, compileCut, compileIsDeterministic, compileMatch, compileMatchAgain, compileSubPattern, compileThis, compileUpTo, cut, DEBUG, either, enPassant, eq, eqNull, equal, filter, flatten, forInstancesOf, limit, main, match, matchOnce, matchVar, narrow, neq, neqNull, newAll, noMatch, none, or, orElse, orElse, repeat, some, some, some, some, someMatch, startCompile, test, transform, uniquely, variable, variable

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

- Constructor Detail
 - Unary
```
protected Unary(Pattern<? super A> body)
```
 Creates a new pattern.
 
 Parameters:
 
 body -
 
 Throws:
 
 IllegalArgumentException - if body is null.
 - Unary
```
protected Unary()
```
- Method Detail
 - getBody
```
public Pattern<A> getBody()
```
 - setBody
```
protected void setBody(Pattern<A> body)
```
 - clone
```
public Pattern clone()
```
 Description copied from class: Pattern
 Makes a matching-state copy if this pattern.
 Subclasses must override this method if necessary to honour the following rules for all transitively reachable patterns:
 - Subpatterns that are instances of Variable must be shared. This implies that Variable.clone() must return this.
 - Fields that do not refer to subpatterns, but to matching state (changed by invocations of Pattern.match(A), Pattern.matchAgain(), Pattern.cut() or Pattern.clear()) must be duplicated. If matching state changes are effected by modification of other objects, these must be duplicated. In summary, matching operations on this pattern and its copy must not interfere, with the exception of variable bindings.
 - Fields neither referring to subpatterns nor to matching state may be either shared or duplicated. The usage of such fields in a modifiable way (such that the distinction is relevant) is strongly deprecated.
 - Patterns whose fields need not be duplicated need not be duplicated themselves, but may return this.
 Overrides:
 
 clone in class Pattern
 - matchAgain
```
public boolean matchAgain()
```
 Description copied from class: Pattern
 
 Attempts to re-match this pattern against a previously matched object. If the class of this pattern imposes a specific order on matches, they are chosen in that order, beginning with the second one. The behaviour of this method is unspecified if the last matching attempt of this pattern has not been successful.
 Patterns classes that do not override this method are deterministic. Pattern classes that overwrite this method to provide additional matches should also override Pattern.isDeterministic().
 
 Overrides:
 
 matchAgain in class Pattern
 
 Returns:
 
 true if the matching is successful, false if it fails. Which Variables are bound by a successful match depends. The default implementation always returns false.
 
 See Also:
 
 Pattern.binds(Variable), Pattern.preserves(Variable, boolean)
 - cut
```
public void cut(boolean recursively)
```
 Description copied from class: Pattern
 
 Disposes of all internal state related to nondeterminism.
 The default implementation does nothing. Subclasses that override this method should also override Pattern.clear(boolean) and ensure that it implies the effect of cut(false).
 
 Overrides:
 
 cut in class Pattern
 
 Parameters:
 
 recursively - true if all subpatterns should be deactivated, false otherwise.
 - clear
```
public void clear(boolean recursively)
```
 Description copied from class: Pattern
 
 Disposes of all internal state related to results and nondeterminism.
 The default implementation does nothing.
 
 Overrides:
 
 clear in class Pattern
 
 Parameters:
 
 recursively - true if all subpatterns should be deactivated, false otherwise.
 - binds
```
public boolean binds(Variable<?> var)
```
 Description copied from class: Pattern
 
 Checks whether a variable is bound by this pattern.
 The default implementation returns false.
 
 Overrides:
 
 binds in class Pattern
 
 Parameters:
 
 var - a pattern variable
 
 Returns:
 
 true if the variable is guaranteed to have a meaningful value when this pattern is open, false otherwise.
 - preserves
```
public boolean preserves(Variable<?> var,
 boolean success)
```
 Description copied from class: Pattern
 
 Checks whether a variable is preserved by this pattern, conditionally on success or failure.
 The default implementation returns false.
 
 Overrides:
 
 preserves in class Pattern
 
 Parameters:
 
 var - a pattern variable
 
 success - specifies preservation on success or failure
 
 Returns:
 
 true if the variable value is guaranteed to be unaffected by a matching attempt with this pattern that returns a value equal to success.
 - preserves
```
public boolean preserves(Variable<?> var)
```
 Description copied from class: Pattern
 
 Checks whether a variable is preserved by this pattern, unconditionally.
 The default implementation returns false.
 
 Overrides:
 
 preserves in class Pattern
 
 Parameters:
 
 var - a pattern variable
 
 Returns:
 
 true if the variable value is guaranteed to be unaffected by any matching attempt with this pattern.
 - isDeterministic
```
public boolean isDeterministic()
```
 Description copied from class: Pattern
 
 Checks whether this pattern is deterministic.
 The default implementation returns true.
 
 Overrides:
 
 isDeterministic in class Pattern
 
 Returns:
 
 true if this pattern is guaranteed to match any object at most once, false otherwise.
 
 See Also:
 
 Pattern.matchAgain()
 - toString
```
public String toString()
```
 Overrides:
 
 toString in class Object
 - compileCut
```
protected void compileCut(eu.bandm.tools.paisley.CompilationContext context,
 boolean recursively)
```
 Overrides:
 
 compileCut in class Pattern
 - compileClear
```
protected void compileClear(eu.bandm.tools.paisley.CompilationContext context,
 boolean recursively)
```
 Overrides:
 
 compileClear in class Pattern

Class Unary<A,B>

Constructor Summary

Method Summary

Methods inherited from class eu.bandm.tools.paisley.Pattern

Methods inherited from class java.lang.Object

Constructor Detail

Unary

Unary

Method Detail

getBody

setBody

clone

matchAgain

cut

clear

binds

preserves

preserves

isDeterministic

toString

compileCut

compileClear