オブジェクト ID objectID を有するドキュメントを
返します。ドキュメントが、挿入可能なアンカーを有している場合、
既に挿入されています。オプションのパラメータ
rootID/prefix は、文字列または整数とすることが
できます。整数の場合、ドキュメントに挿入されたリンクの数を定義
します。デフォルトは 0 であり、リンク先のオブジェクトの名前から
構成されたリンクが得られます。
この動作は、Web アプリケーションには便利です。
あるリンクが、名前 'internet_movie' を有するオブジェクトを指す
場合、HTML リンクは、<A HREF="/internet_movie"> となり、
ドキュメント階層におけるリンク元およびリンク先のオブジェクトの
実際の位置は無視されます。Web サーバーを設定し、URL を
例えば、 '/my_script.php3/internet_movie' に書き変える必要があります。
'my_script.php3' は、$PATH_INFO を評価し、ドキュメントを
取得する必要があります。
全てのリンクは接頭辞 '/my_script.php3/'を有しています。
これが好ましくない場合、使用する接頭辞としてオプションのパラメータ
rootID/prefix を設定することができます。
このパラメータは、文字列である必要があります。
rootID/prefix が整数であり、
0 に等しくない場合、リンクは ID
rootID/prefix を有するオブジェクトで
始まる全ての名前から構成されます。
現在のオブジェクトに関したスラッシュにより分割された
全ての名前から構成されます。
例えば、前記のドキュメント 'internet_movie' が 'a-b-c-internet_movie'
にあり、'-' が Hyperwave サーバの階層レベルの間のセパレータであり、
元のドキュメントが 'a-b-d-source' にある場合、
結果の HTML リンクは次のようになります。
<A HREF="../c/internet_movie">
この動作は、サーバー全体の内容をディスクにダウンロードし
ドキュメント階層をファイルシステムに割り付けたい場合に便利です。
この関数は、純粋なテキストドキュメントについてのみ動作します。 特別なデータ接続をオープンしないため、伝達の間、 制御用の接続はブロックされます。
hw_pipedocument()、 hw_free_document()、 hw_document_bodytag()、 hw_document_size() および hw_output_document() も参照ください。