## `depth_first_visit`

    template <class IncidenceGraph, class DFSVisitor, class ColorMap>
    void depth_first_visit(IncidenceGraph& g,
      typename graph_traits<IncidenceGraph>::vertex_descriptor s,
      DFSVisitor& vis, ColorMap color)

この関数は depth-first pattern を使って、始点 `s` と同じ連結成分中にある全ての頂点を 訪れる。時々単独で有用ではあるが、この関数の主な目的は `depth_first_search()` の実装のためにある。

ユーザによって提供される `DFSVisitor` はアルゴリズムの内側の 各イベント・ポイントで行われるアクションを決定する。

`ColorMap` は訪れられた頂点の過程を保持するためにアルゴリズムに よって使われる。

### Where Defined:

`boost/graph/depth_first_search.hpp`

### Parameters

IN `IncidenceGraph& g`

> 有向グラフまたは無向グラフ。グラフの型は Incidence Graph のモデルでなければならない。

IN: `vertex_descriptor s`

> 探索が開始される始点。

IN: `DFSVisitor visitor`

> アルゴリズムの内側で DFS Visitor コンセプトで指定されるイベント・ポイントで呼び出される ビジタ・オブジェクト。ビジタ・オブジェクトは値渡しされる [1]。

UTIL: `ColorMap color`

> これはグラフを通る進行過程を保持するためにアルゴリズムによって使われる。 `ColorMap` の型は Read/Write Property Map のモデルでなければならず、かつキー型はグラフの頂点記述子型 でなければならず、またカラー・マップの値型は Color Value をモデルとしなければならない。

### Complexity

時間複雑性は O(E) である。

### Notes

[1] ビジタのパラメータは値渡しされるので、もしビジタが状態を持っているなら、 アルゴリズムの間のいかなる状態の変更も、送ったビジタ・オブジェクトには行われず ビジタ・オブジェクトのコピーに対して行われる。それゆえポインタまたは リファレンスによってこの状態をビジタに保持させる事を望むかもしれない。

Copyright © 2000-2001 | Jeremy Siek, Indiana University (jsiek@osl.iu.edu)

Japanese Translation Copyright © 2003 Takashi Itou
オリジナルの、及びこの著作権表示が全ての複製の中に現れる限り、この文書の複製、利用、変更、販売そして配布を認める。このドキュメントは「あるがまま」に提供されており、いかなる明示的、暗黙的保証も行わない。また、いかなる目的に対しても、その利用が適していることを関知しない。

このドキュメントの対象: Boost Version 1.30.0
最新版ドキュメント (英語)