(PHP 4)
hw_GetText — Recuperar documentos de texto
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.
connectionEl identificador de conexión.
objectIDEl identificador del objeto.
rootID/prefix
El parámetro opcional rootID/prefix puede 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 opcional
rootID/prefix a cualquier prefijo que
se use en su lugar. En este caso tiene que ser una cadena.
Si rootID/prefix es un valor integer y no igual a 0,
el enlace es construido desde todos los nombres que empiezan con el objeto con
el id rootID/prefix separado 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.
Devuelve el documento de texto.