Class ImmutableValueGraph<N,V>
- java.lang.Object
-
- com.google.common.graph.AbstractGraph<N>
-
- com.google.common.graph.ImmutableGraph<N>
-
- com.google.common.graph.ImmutableValueGraph<N,V>
-
- Type Parameters:
N- Node parameter typeV- Value parameter type
- All Implemented Interfaces:
Graph<N>,ValueGraph<N,V>
@Beta public final class ImmutableValueGraph<N,V> extends ImmutableGraph<N> implements ValueGraph<N,V>
AValueGraphwhose elements and structural relationships will never change. Instances of this class may be obtained withcopyOf(ValueGraph).See the Guava User's Guide's discussion of the
Immutable*types for more information on the properties and guarantees provided by this class.- Since:
- 20.0
-
-
Field Summary
Fields Modifier and Type Field Description protected ValueGraph<N,V>backingValueGraph
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description java.util.Set<N>adjacentNodes(java.lang.Object node)Returns the nodes which have an incident edge in common withnodein this graph.booleanallowsSelfLoops()Returns true if this graph allows self-loops (edges that connect a node to itself).static <N,V>
ImmutableValueGraph<N,V>copyOf(ImmutableValueGraph<N,V> graph)Deprecated.no need to use thisstatic <N,V>
ImmutableValueGraph<N,V>copyOf(ValueGraph<N,V> graph)Returns an immutable copy ofgraph.intdegree(java.lang.Object node)Returns the count ofnode's incident edges, counting self-loops twice (equivalently, the number of times an edge touchesnode).protected Graph<N>delegate()java.util.Set<EndpointPair<N>>edges()A reasonable default implementation ofGraph.edges()defined in terms ofGraph.nodes()andGraph.successors(Object).VedgeValue(java.lang.Object nodeU, java.lang.Object nodeV)If there is an edge connectingnodeUtonodeV, returns the non-null value associated with that edge.VedgeValueOrDefault(java.lang.Object nodeU, java.lang.Object nodeV, V defaultValue)If there is an edge connectingnodeUtonodeV, returns the non-null value associated with that edge; otherwise, returnsdefaultValue.intinDegree(java.lang.Object node)Returns the count ofnode's incoming edges (equal topredecessors(node).size()) in a directed graph.booleanisDirected()Returns true if the edges in this graph are directed.ElementOrder<N>nodeOrder()Returns the order of iteration for the elements ofGraph.nodes().java.util.Set<N>nodes()Returns all nodes in this graph, in the order specified byGraph.nodeOrder().intoutDegree(java.lang.Object node)Returns the count ofnode's outgoing edges (equal tosuccessors(node).size()) in a directed graph.java.util.Set<N>predecessors(java.lang.Object node)Returns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's incoming edges against the direction (if any) of the edge.java.util.Set<N>successors(java.lang.Object node)Returns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's outgoing edges in the direction (if any) of the edge.java.lang.StringtoString()Returns a string representation of this graph.-
Methods inherited from class com.google.common.graph.ImmutableGraph
copyOf, copyOf
-
Methods inherited from class com.google.common.graph.AbstractGraph
edgeCount
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.google.common.graph.Graph
adjacentNodes, allowsSelfLoops, degree, edges, inDegree, isDirected, nodeOrder, nodes, outDegree, predecessors, successors
-
Methods inherited from interface com.google.common.graph.ValueGraph
equals, hashCode
-
-
-
-
Field Detail
-
backingValueGraph
protected final ValueGraph<N,V> backingValueGraph
-
-
Method Detail
-
copyOf
public static <N,V> ImmutableValueGraph<N,V> copyOf(ValueGraph<N,V> graph)
Returns an immutable copy ofgraph.
-
copyOf
@Deprecated public static <N,V> ImmutableValueGraph<N,V> copyOf(ImmutableValueGraph<N,V> graph)
Deprecated.no need to use thisSimply returns its argument.
-
edgeValue
public V edgeValue(java.lang.Object nodeU, java.lang.Object nodeV)
Description copied from interface:ValueGraphIf there is an edge connectingnodeUtonodeV, returns the non-null value associated with that edge.In an undirected graph, this is equal to
edgeValue(nodeV, nodeU).- Specified by:
edgeValuein interfaceValueGraph<N,V>
-
edgeValueOrDefault
public V edgeValueOrDefault(java.lang.Object nodeU, java.lang.Object nodeV, @Nullable V defaultValue)
Description copied from interface:ValueGraphIf there is an edge connectingnodeUtonodeV, returns the non-null value associated with that edge; otherwise, returnsdefaultValue.In an undirected graph, this is equal to
edgeValueOrDefault(nodeV, nodeU, defaultValue).- Specified by:
edgeValueOrDefaultin interfaceValueGraph<N,V>
-
toString
public java.lang.String toString()
Description copied from class:AbstractGraphReturns a string representation of this graph.- Overrides:
toStringin classAbstractGraph<N>
-
delegate
protected Graph<N> delegate()
-
nodes
public java.util.Set<N> nodes()
Description copied from interface:GraphReturns all nodes in this graph, in the order specified byGraph.nodeOrder().
-
edges
public java.util.Set<EndpointPair<N>> edges()
Description copied from class:AbstractGraphA reasonable default implementation ofGraph.edges()defined in terms ofGraph.nodes()andGraph.successors(Object).- Specified by:
edgesin interfaceGraph<N>- Overrides:
edgesin classAbstractGraph<N>
-
isDirected
public boolean isDirected()
Description copied from interface:GraphReturns true if the edges in this graph are directed. Directed edges connect asource nodeto atarget node, while undirected edges connect a pair of nodes to each other.
-
allowsSelfLoops
public boolean allowsSelfLoops()
Description copied from interface:GraphReturns true if this graph allows self-loops (edges that connect a node to itself). Attempting to add a self-loop to a graph that does not allow them will throw anUnsupportedOperationException.
-
nodeOrder
public ElementOrder<N> nodeOrder()
Description copied from interface:GraphReturns the order of iteration for the elements ofGraph.nodes().
-
adjacentNodes
public java.util.Set<N> adjacentNodes(java.lang.Object node)
Description copied from interface:GraphReturns the nodes which have an incident edge in common withnodein this graph.
-
predecessors
public java.util.Set<N> predecessors(java.lang.Object node)
Description copied from interface:GraphReturns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's incoming edges against the direction (if any) of the edge.In an undirected graph, this is equivalent to
Graph.adjacentNodes(Object).
-
successors
public java.util.Set<N> successors(java.lang.Object node)
Description copied from interface:GraphReturns all nodes in this graph adjacent tonodewhich can be reached by traversingnode's outgoing edges in the direction (if any) of the edge.In an undirected graph, this is equivalent to
Graph.adjacentNodes(Object).This is not the same as "all nodes reachable from
nodeby following outgoing edges". For that functionality, seeGraphs.reachableNodes(Graph, Object).
-
degree
public int degree(java.lang.Object node)
Description copied from interface:GraphReturns the count ofnode's incident edges, counting self-loops twice (equivalently, the number of times an edge touchesnode).For directed graphs, this is equal to
inDegree(node) + outDegree(node).For undirected graphs, this is equal to
adjacentNodes(node).size()+ (1 ifnodehas an incident self-loop, 0 otherwise).If the count is greater than
Integer.MAX_VALUE, returnsInteger.MAX_VALUE.- Specified by:
degreein interfaceGraph<N>- Overrides:
degreein classAbstractGraph<N>
-
inDegree
public int inDegree(java.lang.Object node)
Description copied from interface:GraphReturns the count ofnode's incoming edges (equal topredecessors(node).size()) in a directed graph. In an undirected graph, returns theGraph.degree(Object).If the count is greater than
Integer.MAX_VALUE, returnsInteger.MAX_VALUE.- Specified by:
inDegreein interfaceGraph<N>- Overrides:
inDegreein classAbstractGraph<N>
-
outDegree
public int outDegree(java.lang.Object node)
Description copied from interface:GraphReturns the count ofnode's outgoing edges (equal tosuccessors(node).size()) in a directed graph. In an undirected graph, returns theGraph.degree(Object).If the count is greater than
Integer.MAX_VALUE, returnsInteger.MAX_VALUE.- Specified by:
outDegreein interfaceGraph<N>- Overrides:
outDegreein classAbstractGraph<N>
-
-