Описание

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">. Это используется, когда нужно загрузить содержимое всего сервера на диск и отобразить иерархию документов в файловую систему.

Эта функция будет работать только для чисто текстовых документов. Она не открывает специальное соединение данных и, следовательно, не блокирует управление соединением в ходе трансфера.

См. также hw_pipedocument(), hw_free_document(), hw_document_bodytag(), hw_document_size() и hw_output_document().

Содержание раздела

---

---