hw_GetText
(PHP 4)
hw_GetText — Recuperar documentos de texto
Descripción
Devuelve el documento con el ID de objeto objectID. Si
el documento tiene anclas que pueden ser insertadas, serán insertadas
ya.
Esta función sólo funciona para documentos de texto puros. No abrirá una conexión de información especial y por lo tanto bloqueará la conexión de control durante la transferencia.
Parámetros
-
connection -
El identificador de conexión.
-
objectID -
El identificador del objeto.
-
rootID/prefix -
El parámetro opcional
rootID/prefixpuede ser una cadena o un valor integer. Si es un integer determina cómo los enlaces son insertados en el documento. Lo predeterminado es 0 y resultará en enlaces que están construidos desde el nombre del objeto de destino del enlace. Esto es útil para aplicaciones web. Si un enlace apunta a un objeto con nombre 'película_internet' el enlace HTML será <A href="/película_internet">. La ubicación real del objeto fuente y el objeto destino en la jerarquía del documento son ignorados. Tendrá que configurar su navegador web para reescribir esta URL a, por ejemplo, '/mi_script.php/película_internet'. 'mi_script.php' tendrá que evaluar $PATH_INFO y recuperar el documento. Todos los enlaces tiene el prefijo '/mi_script.php/'. Si no desea esto puede establecer el parámetro opcionalrootID/prefixa cualquier prefijo que se use en su lugar. En este caso tiene que ser una cadena.Si
rootID/prefixes un valor integer y no igual a 0, el enlace es construido desde todos los nombres que empiezan con el objeto con el idrootID/prefixseparado por una barra relativo al objeto actual.Si, por ejemplo, el documento de arriba, 'película_internet', está ubicado en 'a-b-c-película_internet', siendo '-' el serparador entre niveles de jerarquía en el servidor Hyperwave, y el documento fuente está ubicado en 'a-b-d-fuente', el enlace HTML resultante sería: <A HREF="../c/película_internet">. Esto es útil si quiere descargar el contenido completo del servidor al disco y mapear la jerarquía del documento en el sistema de ficheros.
Valores devueltos
Devuelve el documento de texto.
Ver también
- hw_pipedocument() - Recuperar cualquier documento
- hw_free_document() - Libera un hw_document
- hw_document_bodytag() - Etiqueta BODY de hw_document
- hw_document_size() - Tamaño de hw_document
- hw_output_document() - Imprime un hw_document
