Cadenza
0.1.0.0
System.Object
Extension methods on .
Method
0.1.0.0
Cadenza.Maybe<T>
The type to convert into a .
A value of type to convert into a
.
Create a new instance
initialized to a specified value. The returned value will not be
.
A new instance
initialized to a specified value.
The returned value will not be
.
Use this method when you want to ensure that
instance is created in which
will not throw.
is a reference type and
is .
Method
0.1.0.0
TResult
System.ParamArray
The source type.
The result type.
A value of type to convert to
.
A
array containing the conversion routines to try, in order, to
convert into a
.
Converts the instance
into a .
A value of type , as returned by one
of the conversion delegates in .
is converted into a
instance by trying each
within .
This method returns the value of
where
for the first delegate to return a
instance
where
is .
If no
returns a
instance
where
is , then an
is thrown.
Assert.AreEqual ("foo",
"foo".Match (
s => Maybe.When (s.Length != 3, "bar!"),
s => s.Just ()));
Assert.AreEqual ("bar!",
5.Match (
v => Maybe.When (v != 3, "bar!"),
v => v.ToString ().Just()));
var m = new Func<string, Maybe<int>>[] {
v => Maybe.When (v == "bar", 1),
v => Maybe.When (v.Length == 5, 2),
v => (-1).Just (),
};
Assert.AreEqual (1, "bar".Match (m));
Assert.AreEqual (2, "12345".Match (m));
Assert.AreEqual (-1, "*default*".Match (m));
is .
None of the
delegates within returned a
instance where
was
.
Method
0.1.0.0
Cadenza.Maybe<T>
The type to convert into a .
A value of type to convert into a
.
Create a new instance
initialized to a specified value. The returned value may be
.
A new instance
initialized to a specified value.
The value returned may be
.
Use this method when you want to ensure that a possibly invalid
instance is created.
If is a reference type and
is , then
will be returned;
otherwise, a new will be
created containing the value .
Method
0.1.0.0
System.Collections.Generic.IEnumerable<TResult>
The type of the root node and intermediate nodes of the tree.
The type of the object to return.
The root of a tree to traverse.
A which is used to
convert tree nodes into instances.
A
which returns the child nodes of
and all intermediate non-leaf nodes.
Traverse a tree in a breadth-first fashion, converting each
encountered node.
A
containing the result of applying
to all nodes encountered while traversing the tree
in a breadth-first fashion.
is the root node of a tree, wherein each
node is a data structure containing a value and child nodes.
The value is retrieved via ,
and the children are obtained via
.
The tree is traversed in a breadth-first fashion, each encountered
node is provided to , and the
values are returned.
Given the TreeNode<T> declaration:
class TreeNode<T>
{
public TreeNode ()
{
Children = new TreeNode<T> [0];
}
public T Value;
public IEnumerable<TreeNode<T>> Children;
}
TraverseBreadthFirst() is used as:
TreeNode<int> root = new TreeNode<int> {
Value = 1, Children = new [] {
new TreeNode<int> { Value = 2 },
new TreeNode<int> {
Value = 3, Children = new [] {
new TreeNode<int> { Value = 5 },
}
},
new TreeNode<int> { Value = 4 },
}
};
IEnumerable<int> values = root
.TraverseBreadthFirst (x => x.Value, x => x.Children);
AssertAreSame (new[]{ 1, 2, 3, 4, 5 }, values);
is .
-or-
is .
-or-
is .
Method
0.1.0.0
System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TSource,TResult>>
The type of the root node and intermediate nodes of the tree.
The type of the object to return.
The root of a tree to traverse.
A which is used to
convert tree nodes into instances.
A
which returns the child nodes of
and all intermediate non-leaf nodes.
Traverse a tree in a breadth-first fashion, converting each
encountered node.
A
in which each returned
is the result of applying to a
node, and
holds the parent of that node. If the node has no parent (e.g. for
), then
will contain default(TSource).
Returned
values come from traversing in a
breadth-first order.
is the root node of a tree, wherein each
node is a data structure containing a value and child nodes.
The value is retrieved via ,
and the children are obtained via
.
The tree is traversed in a breadth-first fashion, each encountered
node is provided to , and the
values are returned.
is .
-or-
is .
-or-
is .
Method
0.1.0.0
System.Collections.Generic.IEnumerable<TResult>
The type of the root node and intermediate nodes of the tree.
The type of the object to return.
The root of a tree to traverse.
A which is used to
convert tree nodes into instances.
A
which returns the child nodes of
and all intermediate non-leaf nodes.
Traverse a tree in a depth-first fashion, converting each
encountered node.
A
containing the result of applying
to all nodes encountered while traversing the tree
in a depth-first fashion.
is the root node of a tree, wherein each
node is a data structure containing a value and child nodes.
The value is retrieved via ,
and the children are obtained via
.
The tree is traversed in a depth-first fashion, each encountered
node is provided to , and the
values are returned.
Given the TreeNode<T> declaration:
class TreeNode<T>
{
public TreeNode ()
{
Children = new TreeNode<T> [0];
}
public T Value;
public IEnumerable<TreeNode<T>> Children;
}
TraverseDepthFirst() is used as:
TreeNode<int> root = new TreeNode<int> {
Value = 1, Children = new [] {
new TreeNode<int> { Value = 2 },
new TreeNode<int> {
Value = 3, Children = new [] {
new TreeNode<int> { Value = 5 },
}
},
new TreeNode<int> { Value = 4 },
}
};
IEnumerable<int> values = root
.TraverseDepthFirst (x => x.Value, x => x.Children);
AssertAreSame (new[]{ 1, 2, 3, 5, 4 }, values);
is .
-or-
is .
-or-
is .
Method
0.1.0.0
System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TSource,TResult>>
The type of the root node and intermediate nodes of the tree.
The type of the object to return.
The root of a tree to traverse.
A which is used to
convert tree nodes into instances.
A
which returns the child nodes of
and all intermediate non-leaf nodes.
Traverse a tree in a depth-first fashion, converting each
encountered node.
A
in which each returned
is the result of applying to a
node, and
holds the parent of that node. If the node has no parent (e.g. for
), then
will contain default(TSource).
Returned
values come from traversing in a
breadth-first order.
is the root node of a tree, wherein each
node is a data structure containing a value and child nodes.
The value is retrieved via ,
and the children are obtained via
.
The tree is traversed in a depth-first fashion, each encountered
node is provided to , and the
values are returned.
is .
-or-
is .
-or-
is .
Method
0.1.0.0
TResult
The type to operate on.
The type to return.
A containing the value to manipulate.
This value may be (unlike most other
extension methods).
A which will be
invoked with as a parameter.
Supports chaining otherwise temporary values.
The value of type returned by
.
With is useful for easily using an intermediate value within
an expression "chain" without requiring an explicit variable
declaration (which is useful for reducing in-scope variables, as no
variable is explicitly declared).
// sorts the array, then returns the
// element in the middle of the array.
Assert.AreEqual (3,
new[]{5, 4, 3, 2, 1}.Sort ()
.With (c => c.ElementAt (c.Count()/2)));
is .