hw_GetText
(PHP 4)
hw_GetText — テキストドキュメントを取得する
説明
オブジェクト ID objectID を有するドキュメントを
返します。ドキュメントが、挿入可能なアンカーを有している場合、
既に挿入されています。
この関数は、純粋なテキストドキュメントについてのみ動作します。 特別なデータ接続をオープンしないため、伝達の間、 制御用の接続はブロックされます。
パラメータ
-
connection -
接続 ID。
-
objectID -
オブジェクト ID。
-
rootID/prefix -
オプションのパラメータ
rootID/prefixは、文字列または整数とすることが できます。整数の場合、ドキュメントに挿入されたリンクの数を定義 します。デフォルトは 0 であり、リンク先のオブジェクトの名前から 構成されたリンクが得られます。 この動作は、Web アプリケーションには便利です。 あるリンクが、名前 'internet_movie' を有するオブジェクトを指す 場合、HTML リンクは、<A HREF="/internet_movie"> となり、 ドキュメント階層におけるリンク元およびリンク先のオブジェクトの 実際の位置は無視されます。Web サーバーを設定し、URL を 例えば、 '/my_script.php/internet_movie' に書き変える必要があります。 'my_script.php' は、$PATH_INFO を評価し、ドキュメントを 取得する必要があります。 全てのリンクは接頭辞 '/my_script.php/'を有しています。 これが好ましくない場合、使用する接頭辞としてオプションのパラメータrootID/prefixを設定することができます。 このパラメータは、文字列である必要があります。rootID/prefixが整数であり、 0 に等しくない場合、リンクは IDrootID/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 を解放する
- hw_document_bodytag() - hw_document の BODY タグ
- hw_document_size() - hw_document のサイズ
- hw_output_document() - hw_document を出力する