... |
... |
@@ -497,129 +497,129 @@
|
497 |
497 |
|
498 |
498 |
///Next arc to be processed.
|
499 |
499 |
|
500 |
500 |
///Next arc to be processed.
|
501 |
501 |
///
|
502 |
502 |
///\return The next arc to be processed or \c INVALID if the stack
|
503 |
503 |
///is empty.
|
504 |
504 |
OutArcIt nextArc() const
|
505 |
505 |
{
|
506 |
506 |
return _stack_head>=0?_stack[_stack_head]:INVALID;
|
507 |
507 |
}
|
508 |
508 |
|
509 |
509 |
///\brief Returns \c false if there are nodes
|
510 |
510 |
///to be processed.
|
511 |
511 |
///
|
512 |
512 |
///Returns \c false if there are nodes
|
513 |
513 |
///to be processed in the queue (stack).
|
514 |
514 |
bool emptyQueue() const { return _stack_head<0; }
|
515 |
515 |
|
516 |
516 |
///Returns the number of the nodes to be processed.
|
517 |
517 |
|
518 |
518 |
///Returns the number of the nodes to be processed in the queue (stack).
|
519 |
519 |
int queueSize() const { return _stack_head+1; }
|
520 |
520 |
|
521 |
521 |
///Executes the algorithm.
|
522 |
522 |
|
523 |
523 |
///Executes the algorithm.
|
524 |
524 |
///
|
525 |
525 |
///This method runs the %DFS algorithm from the root node
|
526 |
526 |
///in order to compute the DFS path to each node.
|
527 |
527 |
///
|
528 |
528 |
/// The algorithm computes
|
529 |
529 |
///- the %DFS tree,
|
530 |
530 |
///- the distance of each node from the root in the %DFS tree.
|
531 |
531 |
///
|
532 |
532 |
///\pre init() must be called and a root node should be
|
533 |
533 |
///added with addSource() before using this function.
|
534 |
534 |
///
|
535 |
535 |
///\note <tt>d.start()</tt> is just a shortcut of the following code.
|
536 |
536 |
///\code
|
537 |
537 |
/// while ( !d.emptyQueue() ) {
|
538 |
538 |
/// d.processNextArc();
|
539 |
539 |
/// }
|
540 |
540 |
///\endcode
|
541 |
541 |
void start()
|
542 |
542 |
{
|
543 |
543 |
while ( !emptyQueue() ) processNextArc();
|
544 |
544 |
}
|
545 |
545 |
|
546 |
546 |
///Executes the algorithm until the given target node is reached.
|
547 |
547 |
|
548 |
548 |
///Executes the algorithm until the given target node is reached.
|
549 |
549 |
///
|
550 |
550 |
///This method runs the %DFS algorithm from the root node
|
551 |
551 |
///in order to compute the DFS path to \c t.
|
552 |
552 |
///
|
553 |
553 |
///The algorithm computes
|
554 |
554 |
///- the %DFS path to \c t,
|
555 |
555 |
///- the distance of \c t from the root in the %DFS tree.
|
556 |
556 |
///
|
557 |
557 |
///\pre init() must be called and a root node should be
|
558 |
558 |
///added with addSource() before using this function.
|
559 |
559 |
void start(Node t)
|
560 |
560 |
{
|
561 |
|
while ( !emptyQueue() && G->target(_stack[_stack_head])!=t )
|
|
561 |
while ( !emptyQueue() && !(*_reached)[t] )
|
562 |
562 |
processNextArc();
|
563 |
563 |
}
|
564 |
564 |
|
565 |
565 |
///Executes the algorithm until a condition is met.
|
566 |
566 |
|
567 |
567 |
///Executes the algorithm until a condition is met.
|
568 |
568 |
///
|
569 |
569 |
///This method runs the %DFS algorithm from the root node
|
570 |
570 |
///until an arc \c a with <tt>am[a]</tt> true is found.
|
571 |
571 |
///
|
572 |
572 |
///\param am A \c bool (or convertible) arc map. The algorithm
|
573 |
573 |
///will stop when it reaches an arc \c a with <tt>am[a]</tt> true.
|
574 |
574 |
///
|
575 |
575 |
///\return The reached arc \c a with <tt>am[a]</tt> true or
|
576 |
576 |
///\c INVALID if no such arc was found.
|
577 |
577 |
///
|
578 |
578 |
///\pre init() must be called and a root node should be
|
579 |
579 |
///added with addSource() before using this function.
|
580 |
580 |
///
|
581 |
581 |
///\warning Contrary to \ref Bfs and \ref Dijkstra, \c am is an arc map,
|
582 |
582 |
///not a node map.
|
583 |
583 |
template<class ArcBoolMap>
|
584 |
584 |
Arc start(const ArcBoolMap &am)
|
585 |
585 |
{
|
586 |
586 |
while ( !emptyQueue() && !am[_stack[_stack_head]] )
|
587 |
587 |
processNextArc();
|
588 |
588 |
return emptyQueue() ? INVALID : _stack[_stack_head];
|
589 |
589 |
}
|
590 |
590 |
|
591 |
591 |
///Runs the algorithm from the given source node.
|
592 |
592 |
|
593 |
593 |
///This method runs the %DFS algorithm from node \c s
|
594 |
594 |
///in order to compute the DFS path to each node.
|
595 |
595 |
///
|
596 |
596 |
///The algorithm computes
|
597 |
597 |
///- the %DFS tree,
|
598 |
598 |
///- the distance of each node from the root in the %DFS tree.
|
599 |
599 |
///
|
600 |
600 |
///\note <tt>d.run(s)</tt> is just a shortcut of the following code.
|
601 |
601 |
///\code
|
602 |
602 |
/// d.init();
|
603 |
603 |
/// d.addSource(s);
|
604 |
604 |
/// d.start();
|
605 |
605 |
///\endcode
|
606 |
606 |
void run(Node s) {
|
607 |
607 |
init();
|
608 |
608 |
addSource(s);
|
609 |
609 |
start();
|
610 |
610 |
}
|
611 |
611 |
|
612 |
612 |
///Finds the %DFS path between \c s and \c t.
|
613 |
613 |
|
614 |
614 |
///This method runs the %DFS algorithm from node \c s
|
615 |
615 |
///in order to compute the DFS path to node \c t
|
616 |
616 |
///(it stops searching when \c t is processed)
|
617 |
617 |
///
|
618 |
618 |
///\return \c true if \c t is reachable form \c s.
|
619 |
619 |
///
|
620 |
620 |
///\note Apart from the return value, <tt>d.run(s,t)</tt> is
|
621 |
621 |
///just a shortcut of the following code.
|
622 |
622 |
///\code
|
623 |
623 |
/// d.init();
|
624 |
624 |
/// d.addSource(s);
|
625 |
625 |
/// d.start(t);
|
... |
... |
@@ -1450,129 +1450,129 @@
|
1450 |
1450 |
}
|
1451 |
1451 |
return e;
|
1452 |
1452 |
}
|
1453 |
1453 |
|
1454 |
1454 |
/// \brief Next arc to be processed.
|
1455 |
1455 |
///
|
1456 |
1456 |
/// Next arc to be processed.
|
1457 |
1457 |
///
|
1458 |
1458 |
/// \return The next arc to be processed or INVALID if the stack is
|
1459 |
1459 |
/// empty.
|
1460 |
1460 |
Arc nextArc() const {
|
1461 |
1461 |
return _stack_head >= 0 ? _stack[_stack_head] : INVALID;
|
1462 |
1462 |
}
|
1463 |
1463 |
|
1464 |
1464 |
/// \brief Returns \c false if there are nodes
|
1465 |
1465 |
/// to be processed.
|
1466 |
1466 |
///
|
1467 |
1467 |
/// Returns \c false if there are nodes
|
1468 |
1468 |
/// to be processed in the queue (stack).
|
1469 |
1469 |
bool emptyQueue() const { return _stack_head < 0; }
|
1470 |
1470 |
|
1471 |
1471 |
/// \brief Returns the number of the nodes to be processed.
|
1472 |
1472 |
///
|
1473 |
1473 |
/// Returns the number of the nodes to be processed in the queue (stack).
|
1474 |
1474 |
int queueSize() const { return _stack_head + 1; }
|
1475 |
1475 |
|
1476 |
1476 |
/// \brief Executes the algorithm.
|
1477 |
1477 |
///
|
1478 |
1478 |
/// Executes the algorithm.
|
1479 |
1479 |
///
|
1480 |
1480 |
/// This method runs the %DFS algorithm from the root node
|
1481 |
1481 |
/// in order to compute the %DFS path to each node.
|
1482 |
1482 |
///
|
1483 |
1483 |
/// The algorithm computes
|
1484 |
1484 |
/// - the %DFS tree,
|
1485 |
1485 |
/// - the distance of each node from the root in the %DFS tree.
|
1486 |
1486 |
///
|
1487 |
1487 |
/// \pre init() must be called and a root node should be
|
1488 |
1488 |
/// added with addSource() before using this function.
|
1489 |
1489 |
///
|
1490 |
1490 |
/// \note <tt>d.start()</tt> is just a shortcut of the following code.
|
1491 |
1491 |
/// \code
|
1492 |
1492 |
/// while ( !d.emptyQueue() ) {
|
1493 |
1493 |
/// d.processNextArc();
|
1494 |
1494 |
/// }
|
1495 |
1495 |
/// \endcode
|
1496 |
1496 |
void start() {
|
1497 |
1497 |
while ( !emptyQueue() ) processNextArc();
|
1498 |
1498 |
}
|
1499 |
1499 |
|
1500 |
1500 |
/// \brief Executes the algorithm until the given target node is reached.
|
1501 |
1501 |
///
|
1502 |
1502 |
/// Executes the algorithm until the given target node is reached.
|
1503 |
1503 |
///
|
1504 |
1504 |
/// This method runs the %DFS algorithm from the root node
|
1505 |
1505 |
/// in order to compute the DFS path to \c t.
|
1506 |
1506 |
///
|
1507 |
1507 |
/// The algorithm computes
|
1508 |
1508 |
/// - the %DFS path to \c t,
|
1509 |
1509 |
/// - the distance of \c t from the root in the %DFS tree.
|
1510 |
1510 |
///
|
1511 |
1511 |
/// \pre init() must be called and a root node should be added
|
1512 |
1512 |
/// with addSource() before using this function.
|
1513 |
1513 |
void start(Node t) {
|
1514 |
|
while ( !emptyQueue() && _digraph->target(_stack[_stack_head]) != t )
|
|
1514 |
while ( !emptyQueue() && !(*_reached)[t] )
|
1515 |
1515 |
processNextArc();
|
1516 |
1516 |
}
|
1517 |
1517 |
|
1518 |
1518 |
/// \brief Executes the algorithm until a condition is met.
|
1519 |
1519 |
///
|
1520 |
1520 |
/// Executes the algorithm until a condition is met.
|
1521 |
1521 |
///
|
1522 |
1522 |
/// This method runs the %DFS algorithm from the root node
|
1523 |
1523 |
/// until an arc \c a with <tt>am[a]</tt> true is found.
|
1524 |
1524 |
///
|
1525 |
1525 |
/// \param am A \c bool (or convertible) arc map. The algorithm
|
1526 |
1526 |
/// will stop when it reaches an arc \c a with <tt>am[a]</tt> true.
|
1527 |
1527 |
///
|
1528 |
1528 |
/// \return The reached arc \c a with <tt>am[a]</tt> true or
|
1529 |
1529 |
/// \c INVALID if no such arc was found.
|
1530 |
1530 |
///
|
1531 |
1531 |
/// \pre init() must be called and a root node should be added
|
1532 |
1532 |
/// with addSource() before using this function.
|
1533 |
1533 |
///
|
1534 |
1534 |
/// \warning Contrary to \ref Bfs and \ref Dijkstra, \c am is an arc map,
|
1535 |
1535 |
/// not a node map.
|
1536 |
1536 |
template <typename AM>
|
1537 |
1537 |
Arc start(const AM &am) {
|
1538 |
1538 |
while ( !emptyQueue() && !am[_stack[_stack_head]] )
|
1539 |
1539 |
processNextArc();
|
1540 |
1540 |
return emptyQueue() ? INVALID : _stack[_stack_head];
|
1541 |
1541 |
}
|
1542 |
1542 |
|
1543 |
1543 |
/// \brief Runs the algorithm from the given source node.
|
1544 |
1544 |
///
|
1545 |
1545 |
/// This method runs the %DFS algorithm from node \c s.
|
1546 |
1546 |
/// in order to compute the DFS path to each node.
|
1547 |
1547 |
///
|
1548 |
1548 |
/// The algorithm computes
|
1549 |
1549 |
/// - the %DFS tree,
|
1550 |
1550 |
/// - the distance of each node from the root in the %DFS tree.
|
1551 |
1551 |
///
|
1552 |
1552 |
/// \note <tt>d.run(s)</tt> is just a shortcut of the following code.
|
1553 |
1553 |
///\code
|
1554 |
1554 |
/// d.init();
|
1555 |
1555 |
/// d.addSource(s);
|
1556 |
1556 |
/// d.start();
|
1557 |
1557 |
///\endcode
|
1558 |
1558 |
void run(Node s) {
|
1559 |
1559 |
init();
|
1560 |
1560 |
addSource(s);
|
1561 |
1561 |
start();
|
1562 |
1562 |
}
|
1563 |
1563 |
|
1564 |
1564 |
/// \brief Finds the %DFS path between \c s and \c t.
|
1565 |
1565 |
|
1566 |
1566 |
/// This method runs the %DFS algorithm from node \c s
|
1567 |
1567 |
/// in order to compute the DFS path to node \c t
|
1568 |
1568 |
/// (it stops searching when \c t is processed).
|
1569 |
1569 |
///
|
1570 |
1570 |
/// \return \c true if \c t is reachable form \c s.
|
1571 |
1571 |
///
|
1572 |
1572 |
/// \note Apart from the return value, <tt>d.run(s,t)</tt> is
|
1573 |
1573 |
/// just a shortcut of the following code.
|
1574 |
1574 |
///\code
|
1575 |
1575 |
/// d.init();
|
1576 |
1576 |
/// d.addSource(s);
|
1577 |
1577 |
/// d.start(t);
|
1578 |
1578 |
///\endcode
|