int hw_gettext (int connection, int objectID [, mixed rootID/prefix])
Возвращает возвращает документ с object 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">. Это используется, когда нужно загрузить содержимое всего сервера на диск и отобразить иерархию документов в
файловую систему.
Эта функция будет работать только для чисто текстовых документов. Она не
открывает специальное соединение данных и, следовательно, не блокирует управление соединением в ходе трансфера.
